Aggiungere strumenti all'agente di intelligenza artificiale di Azure

  • 5 minuti

In Microsoft Agent Framework gli strumenti consentono all'agente di intelligenza artificiale di usare le API e i servizi esistenti per eseguire attività che non è stato possibile eseguire autonomamente. Gli strumenti funzionano tramite chiamate di funzione, consentendo all'intelligenza artificiale di richiedere e usare automaticamente funzioni specifiche. Il framework instrada la richiesta alla funzione appropriata nella codebase e restituisce i risultati al modello LLM (Large Language Model) in modo che possa generare una risposta finale.

Per abilitare la chiamata automatica delle funzioni, gli strumenti devono fornire dettagli che descrivono come funzionano. L'input, l'output e lo scopo della funzione devono essere descritti in modo che l'intelligenza artificiale possa comprendere, in caso contrario, l'intelligenza artificiale non può chiamare correttamente la funzione.

Come usare gli strumenti con Microsoft Foundry Agent

Microsoft Agent Framework supporta sia strumenti per funzioni personalizzate che strumenti predefiniti pronti all'uso.

Strumenti predefiniti

Gli agenti di Microsoft Foundry sono dotati di diversi strumenti predefiniti che è possibile usare immediatamente:

  • Interprete del codice : esegue codice Python per calcoli, analisi dei dati e altro ancora
  • Ricerca di file : esegue ricerche e analizza i documenti
  • Ricerca Web : recupera informazioni da Internet

Questi strumenti sono automaticamente disponibili e non richiedono alcuna configurazione aggiuntiva.

Strumenti per le funzioni personalizzate

Quando si creano strumenti personalizzati per Microsoft Foundry Agent, è necessario comprendere diversi concetti chiave:

  1. Definizione di funzione e annotazioni

    Creare lo strumento definendo una normale funzione Python con annotazioni di tipo appropriate. Usare Annotated e Field da Pydantic per fornire descrizioni dettagliate che consentono all'intelligenza artificiale di comprendere lo scopo della funzione e come usare i relativi parametri. Più descrittive sono le annotazioni, meglio l'intelligenza artificiale può comprendere quando e come chiamare la funzione.

  2. Aggiunta di strumenti all'agente

    Passare le funzioni personalizzate a ChatAgent durante la creazione usando il tools parametro . È possibile aggiungere una singola funzione o un elenco di più funzioni. Il framework registra automaticamente queste funzionalità e le rende disponibili all'intelligenza artificiale per chiamare.

  3. Chiamata dello strumento tramite conversazione

    Dopo aver registrato gli strumenti con l'agente, non è necessario richiamarli manualmente. In alternativa, porre domande all'agente o assegnarle attività che richiederebbero naturalmente la funzionalità dello strumento. L'intelligenza artificiale determina automaticamente quando chiamare gli strumenti in base al contesto della conversazione e alle descrizioni degli strumenti forniti.

  4. Più strumenti e orchestrazione

    È possibile aggiungere più strumenti a un singolo agente e l'intelligenza artificiale sceglie automaticamente quale strumento usare in base alla richiesta dell'utente. Il framework gestisce l'orchestrazione, chiamando le funzioni appropriate e combinando i risultati per fornire una risposta completa.

Procedure consigliate per lo sviluppo di strumenti

  • Descrizioni chiare: scrivere descrizioni chiare e dettagliate per le funzioni e i parametri per facilitare la comprensione dello scopo dell'intelligenza artificiale
  • Annotazioni di tipo: usare suggerimenti di tipo Python appropriati per specificare i tipi di input e output previsti
  • Gestione degli errori: implementare la gestione degli errori appropriata nelle funzioni dello strumento per gestire correttamente gli input imprevisti
  • Restituire dati significativi: assicurarsi che le funzioni restituiscono dati che l'intelligenza artificiale possa usare in modo efficace nelle risposte
  • Mantenere incentrate le funzioni: progettare ogni strumento per gestire un'attività specifica anziché tentare di eseguire troppe operazioni in una sola funzione

Seguendo questi concetti, è possibile estendere Microsoft Foundry Agent con strumenti predefiniti e personalizzati, consentendo di interagire con le API ed eseguire attività avanzate. Questo approccio rende l'intelligenza artificiale più potente e in grado di gestire in modo efficiente le applicazioni reali.