Aggiungi uno strumento a un agente (GitHub Copilot)

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.

Prerequisites

• Un agente creato con l'imbracatura GitHub Copilot. Vedere Creare un agente.

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.

   Annotazioni

   Se la tua organizzazione ha bloccato uno strumento a causa delle politiche sui dati, non puoi selezionarlo. Scopri di più in Strumenti bloccati dalle politiche della tua organizzazione.

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

Strumenti bloccati dalle politiche della tua organizzazione

La tua organizzazione può utilizzare le politiche di governance per limitare quali strumenti e connettori sono disponibili in Copilot Studio.

Quando una policy dati blocca uno strumento, lo strumento appare disabilitato nel pannello Aggiungi uno strumento e non puoi selezionarlo. Passa il puntatore sull'icona accanto allo strumento disattivato per vedere perché lo strumento non è disponibile.

Il messaggio identifica la restrizione politica che impedisce l'utilizzo dello strumento. Se hai bisogno di accesso a uno strumento bloccato, contatta il tuo amministratore.

Per altre informazioni, vedere Configurare i criteri dati per gli agenti.

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.

File creati dal tuo agente

Alcuni strumenti producono file come output - ad esempio, un report generato, un foglio di calcolo o un'immagine. Questi file sono limitati a 10 MB ciascuno, e i file che superano il limite non vengono mostrati all'utente. Scopri di più in i file creati dall'agente (anteprima GitHub Copilot).

Consigli per descrizioni efficaci degli strumenti

Informazioni correlate

• Panoramica degli strumenti per gli agenti
• Strumenti disponibili per agenti (GitHub Copilot)
• Gestisci ed elimina strumenti in un agente (GitHub Copilot)
• File creati dall'agente (anteprima GitHub Copilot)
• Aggiungi uno strumento a un agente (Conversazione con il cliente)
• Informazioni sugli agenti alimentati da GitHub Copilot