Aggiungere uno strumento a un agente

Puoi aggiungere strumenti al tuo agente dalla scheda Build . Gli strumenti permettono al tuo agente di eseguire azioni, connettersi a servizi esterni e recuperare dati in tempo reale durante le conversazioni.

Note

Le funzionalità di questo articolo sono alimentate dal harness GitHub Copilot, che utilizza Copilot Credits per la fatturazione basata sull'uso. Scopri di più sui Crediti Copilot in Panoramica della fatturazione per agenti alimentati dal GitHub Copilot harness.

La fatturazione basata sull'uso si applica all'utilizzo, alla costruzione, al test e alla valutazione degli agenti. Queste azioni potrebbero consumare crediti Copilot.

Prerequisiti

Aggiungi uno strumento esistente dalla scheda Build

  1. Accedi a Copilot Studio e apri il tuo agente.

  2. Nella barra di navigazione agente, seleziona la scheda Build .

  3. Nel pannello componenti, seleziona il pulsante Tools .

  4. Nella finestra di dialogo Aggiungi uno strumento , sfoglia o cerca lo strumento che vuoi aggiungere. Usa le schede Featured, Model Context Protocol (MCP),Connectors o Workflows per filtrare per tipo di strumento.

  5. Seleziona lo strumento per visualizzarne i dettagli, inclusa una descrizione e le azioni fornite.

  6. Seleziona Aggiungi per aggiungere lo strumento al tuo agente.

Configura uno strumento dopo averlo aggiunto

Dopo aver aggiunto uno strumento, potresti dover davvero:

  • Autentica: Alcuni strumenti richiedono di accedere o fornire le credenziali prima di poter essere utilizzate. Segui i prompt di autenticazione quando appaiono.
  • Seleziona azioni: Per i connettori che offrono più azioni, puoi selezionare quali azioni specifiche rendere disponibili al tuo agente.
  • Rivedi la descrizione: assicurati che la descrizione dello strumento rifletta accuratamente ciò che fa. Il runtime di orchestrazione dell'agente utilizza la descrizione per determinare quando richiamare lo strumento.

Aggiungi un nuovo strumento personalizzato

Se lo strumento di cui hai bisogno non è disponibile nel browser, puoi aggiungere uno strumento personalizzato. Attualmente, gli agenti alimentati dal GitHub Copilot harness supportano l'aggiunta dei seguenti strumenti personalizzati:

  • Strumenti MCP da un server Model Context Protocol (MCP) esistente. Questo ti permette di connetterti a servizi personalizzati, database o API che espongono capacità come strumenti tramite lo standard MCP.
  • Flussi di lavoro che crei nel flow designer di Copilot Studio. Questo ti permette di definire processi a più passaggi che il tuo agente può eseguire su richiesta.

Consigli per descrizioni efficaci degli strumenti

Tip

Il nome e la descrizione dello strumento sono fondamentali per un'invocazione accurata dello strumento. L'esecuzione di orchestrazione avanzata utilizza questi elementi per decidere quando invocare uno strumento, quindi:

  • Usa nomi chiari e specifici che descrivano lo strumento (ad esempio, "Crea un ticket di supporto" invece di "strumento per i ticket")
  • Scrivi descrizioni che spieghino quando lo strumento dovrebbe essere usato e cosa restituisce
  • Evita descrizioni vaghe o sovrapposte tra gli strumenti
  • Last updated on