Connettere un agente a Foundry IQ

Completato

Tip

Per altri dettagli, vedi la scheda Testo e immagini .

Dopo aver creato una knowledge base, un agente o un'applicazione può usarla per recuperare le informazioni pertinenti. Le knowledge base di IQ foundry possono essere usate dal servizio Foundry Agent, da Microsoft Agent Framework o da applicazioni personalizzate che chiamano le API della Knowledge Base Azure AI Search.

Schermata di un agente nel playground mentre utilizza Foundry IQ.

Connettere un agente a una Knowledge Base

Le basi di conoscenza di Foundry IQ mettono a disposizione uno strumento MCP (Model Context Protocol) per l'integrazione degli agenti. MCP offre un modo standard per un agente di chiamare la Knowledge Base. Un flusso di lavoro tipico di Foundry è:

  1. In un progetto Foundry, creare o connettersi a un servizio Azure AI Search che supporta il recupero agentico.
  2. Creare una knowledge base e aggiungere le origini delle informazioni appropriate.
  3. Creare o selezionare un agente con un modello distribuito.
  4. Aggiungere la connessione della Knowledge Base all'agente come strumento MCP.
  5. Definire istruzioni che indicano all'agente quando e come usare la Knowledge Base.
  6. Prova i quesiti e controlla le risposte, le citazioni e l’attività degli strumenti nell’area di prova.

La connessione al progetto deve usare un'identità appropriata e avere solo le autorizzazioni necessarie per recuperare il contenuto.

Scrivere istruzioni per risposte fondate

La connessione di una knowledge base non garantisce che un agente lo usi in modo coerente. Le istruzioni dell'agente devono indicare il comportamento previsto. Per esempio:

Usare la Knowledge Base per rispondere alle domande relative ai criteri di spesa. Basare le affermazioni effettive sul contenuto recuperato e citare le fonti di supporto. Se la Knowledge Base non contiene informazioni sufficienti, si supponga di non sapere invece di indovinare.

Le istruzioni valide definiscono:

  • Quando recuperare: identificare le domande o i domini che richiedono la Knowledge Base.
  • Come usare le prove: richiedi risposte per rimanere aggiornato nel contenuto recuperato.
  • Procedura: richiedere riferimenti all'origine che gli utenti possono esaminare.
  • Cosa fare quando mancano le prove: indicare all'agente di riconoscere l'incertezza o fare riferimento all'utente a una persona o a un processo appropriato.

Testare e migliorare l'esperienza

Testare l'agente potenziato dalla conoscenza con domande realistiche prima di usarlo in produzione. Includere:

  • Domande semplici con un'unica fonte chiara.
  • Domande che richiedono informazioni da più origini.
  • Domande ambigue che devono attivare chiarimenti.
  • Domande per le quali la Knowledge Base non ha risposte.
  • Domande degli utenti con autorizzazioni di origine diverse.
  • Contenuto contenente testo che tenta di modificare le istruzioni dell'agente.

Valutare il recupero e la risposta finale separatamente. Controllare prima di tutto se Foundry IQ ha restituito prove pertinenti, correnti e autorizzate. Controlla quindi se la risposta dell'agente sia fondata, pertinente, completa e correttamente citata. Il monitoraggio di questi comportamenti nel tempo consente di rivelare lacune del contenuto, recupero debole, problemi di autorizzazione e istruzioni che richiedono perfezionamento.