Condividi tramite

Aggiungere strumenti agli agenti personalizzati

Gli strumenti sono i blocchi predefiniti che consentono all'agente di interagire con i sistemi esterni. Gli strumenti espandono la funzionalità dell'agente, consentendogli di eseguire varie azioni in risposta alle richieste degli utenti o ai trigger autonomi. Ogni strumento rappresenta una funzionalità specifica che l'agente può eseguire. Ad esempio, è possibile equipaggiare l'agente con strumenti che eseguono operazioni come:

  • Inviare messaggi di posta elettronica con il connettore di Office 365 Outlook
  • Controllare le condizioni meteorologiche e le previsioni correnti
  • Leggere e scrivere dati da Dataverse
  • Leggere e pubblicare messaggi in Teams

Meccanismi per l'aggiunta di strumenti

È possibile estendere le funzionalità dell'agente personalizzato aggiungendo uno o più strumenti. L'agente può usare gli strumenti per rispondere automaticamente agli utenti, usando l'orchestrazione generativa. È anche possibile chiamare gli strumenti in modo esplicito dall'interno di un argomento.

Con l'orchestrazione generativa (attiva per impostazione predefinita), l'agente può selezionare automaticamente lo strumento o l'argomento più appropriato o cercare informazioni per rispondere a un utente. Questa modalità di orchestrazione crea un'esperienza di conversazione più dinamica e intelligente.

In modalità classica (orchestrazione generativa disattivata), un agente può usare solo gli argomenti per rispondere all'utente. Tuttavia, è comunque possibile progettare l'agente per chiamare gli strumenti in modo esplicito dall'interno degli argomenti.

Sono disponibili diversi meccanismi per aggiungere strumenti all'agente:

  • Connettore predefinito: scegliere tra una selezione di connessioni preimpostate a migliaia di API popolari sia da Microsoft che da servizi non Microsoft.
  • Connettore personalizzato: definire una connessione a un servizio personalizzato o a un sistema per abilitare le opzioni personalizzate degli strumenti tramite i connettori power platform.
  • Flusso dell'agente: definire un flusso dell'agente, incluse una o più azioni da eseguire.
  • Richiesta: richiesta basata su modello a turno singolo che può fare riferimento alle informazioni fornite.
  • Connessione API REST: definire una connessione a un'API REST e selezionare uno o più endpoint API e metodi da aggiungere come strumenti.
  • Strumento MCP (Model Context Protocol): connettersi a un server MCP per accedere agli strumenti.
  • Agente per l'uso del computer (anteprima): consente all'agente di interagire con qualsiasi sistema con interfaccia utente grafica, per siti Web e app desktop, selezionando pulsanti, scegliendo menu e immettendo testo nei campi sullo schermo.

Quando si parla di strumenti in questo articolo e in questa sezione della documentazione, si intende uno dei meccanismi di questo gruppo. Questi tipi di strumento possono essere aggiunti all'agente e configurati in modi simili.

Esistono altri due meccanismi che è possibile usare per aggiungere un comportamento come uno strumento all'agente.

  • Competenze: contenitore per un set di strumenti correlati.
  • Strumento client: inviare un evento di attività al client in modo che il client esegua un'azione e restituisca una risposta.

Per altre informazioni sulle competenze e sugli strumenti client, vedere i collegamenti nella sezione Contenuto correlato .

Creare e aggiungere un nuovo strumento a livello di agente

La creazione di nuovi strumenti direttamente all'interno di Copilot Studio semplifica il processo di sviluppo e garantisce una corretta integrazione con l'agente. Gli strumenti aggiunti a un agente sono disponibili per l'orchestrazione automatica durante le conversazioni dell'agente.

  1. Apri il tuo agente scegliendo Agenti nel riquadro di navigazione a sinistra e selezionando il tuo agente dall'elenco.

  2. Passare alla pagina Strumenti per l'agente.

  3. Selezionare Aggiungi uno strumento.

  4. Nel riquadro Aggiungi strumento selezionare Nuovo strumento.

  5. Selezionare il tipo di strumento da aggiungere dall'elenco visualizzato:

    • Prompt: Creare strumenti di generazione e analisi di testo basati su intelligenza artificiale
    • Flusso dell'agente: creare processi in più passaggi con la logica condizionale
    • Utilizzo del computer: Abilita l'automazione GUI per i sistemi legacy
    • Connettore personalizzato: connettersi a API e servizi proprietari
    • API REST: integrazione diretta con i servizi Web

  6. Eseguire i passaggi di configurazione specifici per il tipo di strumento selezionato. Ad esempio, se si seleziona Prompt, è necessario seguire questa procedura:

    • Definire il modello di prompt e le istruzioni
    • Specificare i parametri di input
    • Configurare le fonti di conoscenza
    • Impostare il formato di risposta e i vincoli

  7. Testare la configurazione dello strumento usando il pannello di anteprima per assicurarsi che funzioni come previsto.

  8. Selezionare Salva per creare il nuovo strumento.

  9. Selezionare Aggiungi all'agente per aggiungere lo strumento all'agente. È possibile visualizzare il nuovo strumento nella pagina Strumenti per l'agente.

Visualizzare e apportare modifiche alla configurazione dello strumento

È possibile visualizzare e modificare la configurazione dello strumento in qualsiasi momento: passare alla pagina Strumenti per l'agente e selezionare lo strumento dall'elenco degli strumenti.

Viene visualizzata la pagina Dei dettagli dello strumento , che mostra la configurazione dello strumento. I dettagli vengono visualizzati in tre sezioni:

  • Dettagli
  • Input
  • Completamento (strumenti per i connettori MCP)

Dettagli

La sezione Dettagli consente di configurare i dettagli di base sullo strumento.

Qui è possibile visualizzare e aggiornare:

  • Nome: nome dello strumento. Questo nome viene visualizzato nell'elenco degli strumenti per l'agente. Scegliere un nome che indichi chiaramente la funzione dello strumento.

  • Descrizione: descrizione dello strumento. L'orchestrazione generativa si basa su questa descrizione per determinare quando l'agente deve usare lo strumento. Scrivere descrizioni chiare e specifiche, incluse le operazioni che lo strumento esegue e quando deve essere usato.

  • Dettagli aggiuntivi:

    • Consenti all'agente di decidere in modo dinamico quando usare lo strumento: quando questa opzione è selezionata, l'agente può usare l'orchestrazione generativa per determinare quando usare lo strumento. Se questa opzione non è selezionata, l'agente usa solo lo strumento quando viene chiamato in modo esplicito da un argomento. Per impostazione predefinita, questa opzione viene selezionata quando è abilitata l'orchestrazione generativa.
    • Chiedere all'utente finale prima di eseguire: nell'esperienza di chat dell'utente finale chiedere conferma all'agente prima di eseguire lo strumento. Questa opzione è impostata su No per impostazione predefinita.
    • Autenticazione: selezionare se usare le credenziali dell'utente o del creatore per lo strumento. Per impostazione predefinita, viene applicata l'autenticazione utente.
    • Descrizione: facoltativamente, è possibile aggiungere una descrizione dello strumento visualizzato all'utente quando viene eseguito lo strumento. Questa descrizione consente all'utente di sapere cosa viene richiesto di autenticare.

Input

Qui è possibile visualizzare e configurare gli input per lo strumento. Gli input vengono usati per raccogliere informazioni dall'utente per compilare gli input necessari per lo strumento. Le informazioni vengono visualizzate come tabella, una riga per ogni input.

Per impostazione predefinita, il valore fill using column per ogni input è impostato su Riempimento dinamico con intelligenza artificiale. L'agente tenta di estrarre il valore dal contesto disponibile, ad esempio dal messaggio dell'utente. Se non viene trovato alcun valore appropriato, genera una domanda per chiedere un valore all'utente. Selezionare Personalizza per accedere ad altre personalizzazioni con granularità fine per la raccolta di input e la compilazione:

  • Nome visualizzato e Descrizione: Come appare l'input all'utente.
  • Identificare come: come viene interpretata la risposta dell'utente, ad esempio come stringa di testo o mappata a un'entità predefinita.
  • Logica di ripetizione dei tentativi: se l'agente non identifica un'entità nell'istruzione dell'utente, può porre nuovamente la domanda.
  • Convalida dell'input: configurare un comportamento di convalida aggiuntivo per l'input dell'utente oltre l'impostazione predefinita per il tipo di entità.

È anche possibile scegliere di eseguire l'override di un input con un valore esplicito anziché consentire all'agente di estrarlo. Per impostare un'override, imposta Compila usando su Valore personalizzato e immetti un valore, seleziona una variabile o usa una formula Power Fx. Se viene eseguito l'override di un input, l'agente non chiede all'utente un valore.

Completamento

In questo caso, è possibile selezionare cosa deve accadere quando lo strumento ha terminato l'esecuzione.

È possibile che l'agente generi automaticamente una risposta contestuale per un utente, in base alla query e al risultato dello strumento.

In alternativa, è possibile scegliere di creare una risposta formattata specifica che lo strumento restituirà. È possibile inserire riferimenti alle variabili di output dallo strumento usando la selezione variabile. È anche possibile usare le formule di Power Fx per formattare la risposta.

In Dopo l'esecuzione selezionare una delle diverse opzioni per il modo in cui lo strumento deve rispondere all'utente dopo l'esecuzione dello strumento:

  • Non rispondere (impostazione predefinita): l'agente incorpora l'output dello strumento nella risposta
  • Scrivere la risposta con intelligenza artificiale generativa: consentire all'intelligenza artificiale di creare una risposta contestuale usando gli output dello strumento
  • Inviare una risposta specifica: creare una risposta basato su modelli con inserimento di variabili
  • Inviare una scheda adattiva: creare risposte avanzate e interattive con pulsanti e azioni

È anche possibile configurare le variabili di output da rendere disponibili per l'agente e altri strumenti.

Selezione degli strumenti e raccolta di input

Quando si definisce uno strumento in Copilot Studio, si forniscono anche informazioni che ne descrivono lo scopo. Queste informazioni consentono all'agente di identificare quando usare lo strumento e usare anche l'intelligenza artificiale generativa per generare domande. Queste domande vengono usate per raccogliere informazioni per riempire gli input necessari per eseguire lo strumento. Di conseguenza, non è necessario creare manualmente i nodi domanda per raccogliere tutti gli input necessari, ad esempio gli input in un flusso. La raccolta dell'input viene gestita automaticamente in fase di esecuzione.

L'agente usa diversi fattori per determinare la selezione degli strumenti:

  • Nome e descrizione dello strumento
  • Contesto della conversazione corrente
  • Finalità utente derivata dal messaggio
  • Input e output disponibili
  • Utilizzo precedente dello strumento nella conversazione

Per impostazione predefinita, quando si usa la modalità generativa, gli strumenti restituiscono le informazioni all'agente, in modo che l'agente possa generare una risposta contestuale alla query dell'utente. In alternativa, è possibile indicare allo strumento di rispondere sempre immediatamente, generando un messaggio o creando un messaggio esplicito.

Suggerimento

Quando si usano domande generate da uno strumento, informare gli utenti che alcune delle conversazioni vengono generate dall'intelligenza artificiale.

Ad esempio, aggiungere un messaggio aggiuntivo nell'argomento sistema Avvio conversazione . Questo argomento determina il messaggio mostrato ai tuoi utenti quando inizia una nuova conversazione.

Chiamare uno strumento esistente dall'interno di un argomento

È possibile chiamare uno strumento in modo esplicito dall'interno di un argomento. A seconda del caso d'uso, è possibile usare lo strumento come parte di un argomento più ampio, che usa più nodi. In alternativa, come nell'esempio meteo, l'aggiunta di un nodo a un argomento potrebbe essere sufficiente.

Per chiamare uno strumento dall'interno di un argomento:

  1. In Copilot Studio, vai alla pagina Argomenti per l'agente che desideri modificare.

  2. Crea un nuovo argomento e chiamalo Visualizza meteo.

  3. Aggiungi le seguenti frasi trigger:

    • pioverà
    • previsioni odierne
    • ottieni previsioni
    • com'è il tempo

  4. Selezionare Aggiungi nodo (+) e quindi aggiungi uno strumento. Selezionare lo strumento dagli strumenti disponibili. Sono disponibili tre schede che mostrano diversi tipi di strumenti:

    • Strumenti di base
    • Connettore
    • Strumento

    Il nodo Azione viene ora aggiunto all'argomento.

  5. Seleziona Salva.

Strumenti (solo connettori MCP)

In Strumenti è possibile visualizzare i nomi e le descrizioni degli strumenti disponibili per il connettore MCP. Gli strumenti vengono visualizzati in una tabella, una riga per ogni strumento. Per ogni strumento, è possibile visualizzare:

  • Nome e versione dello strumento
  • Parametri di input e output
  • Tempo di esecuzione stimato
  • Statistiche di utilizzo

Considerazioni sull'autenticazione per gli strumenti

Alcuni strumenti richiedono il corretto funzionamento dell'autenticazione, ad esempio Prompt dinamico o altri che chiamano un'API Dataverse. La configurazione di autenticazione corretta garantisce la sicurezza mantenendo un'esperienza utente senza problemi.

Gli strumenti vengono sempre eseguiti nel runtime dell'agente nel contesto utente e non possono essere eseguiti a meno che l'autenticazione non sia abilitata. Sono supportati due tipi di metodi di autenticazione:

  • Autenticazione utente: l'agente usa le credenziali dell'utente per l'autenticazione con il servizio. Questo metodo garantisce agli utenti di accedere solo ai dati che sono autorizzati a visualizzare.
  • Autenticazione dell'autore di Copilot: l'agente usa le credenziali dell'autore per l'autenticazione con il servizio. Usare questa modalità di autenticazione per le risorse condivise o quando gli utenti non devono avere accesso individuale.

Testare lo strumento

Con l'orchestrazione generativa, l'agente di orchestrazione seleziona il tuo strumento quando lo ritiene pertinente per una query dell'utente.

In alternativa, è possibile chiamare uno strumento esistente dall'interno di un argomento.

Contenuto correlato