Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Se lo strumento di cui hai bisogno non è disponibile come predefinito, connettore o workflow, puoi aggiungere uno strumento personalizzato importando un'API REST da una specifica OpenAPI.
Aggiungere un'API REST come strumento a un agente alimentato dal Customer Conversation harness è simile ad aggiungerne una a un agente alimentato dallo standard harness. Per saperne di più, vedi Estendi il tuo agente con strumenti da un'API REST (anteprima).
Prerequisiti
- Una copia della specifica OpenAPI per l'API REST a cui vuoi connetterti.
- Conoscenza del tipo di autenticazione necessaria per connettersi all'API e dei dettagli dell'autenticazione.
Aggiungi uno strumento API REST
Nella scheda Build, seleziona la scheda dell'agente principale per aprire il suo pannello di configurazione. Se hai aggiunto qualche sotto-agente, seleziona invece la scheda di un sotto-agente per configurare quel sotto-agente.
Nella sezione Strumenti selezionare Aggiungi strumento.
Nella finestra di dialogo Aggiungi uno strumento , seleziona la scheda API REST (oppure seleziona Aggiungi>API REST).
Nella finestra di dialogo Nuova API REST, completare i seguenti passaggi dell'assistente:
Carica specifica: Importa la tua specifica OpenAPI (Swagger 2.0) o OpenAPI 3.0. Trascina e rilascia un file JSON o YAML (fino a 5 MB), oppure seleziona sfoglia per sceglierne uno.
Dettagli del plugin API: Assegna al tuo strumento un nome e una descrizione che l'agente può usare per decidere quando chiamarlo. Rivedi e, se necessario, modifica i seguenti campi prima di continuare:
- Nome dello strumento: Originariamente popolato dal titolo nella specifica API che hai caricato.
- Descrizione: Inizialmente compilata dalla descrizione contenuta nella specifica API che hai caricato. Fornisci una descrizione dettagliata, perché l'orchestrazione del tuo agente la utilizza per determinare quando utilizzare questo strumento.
- Soluzione: seleziona la soluzione Power Platform in cui memorizzare questo strumento, oppure lasciala vuota per permettere al sistema di crearne automaticamente uno per te.
Autenticazione: Scegli come l'agente si autentica con questa API:
- Nessuno: Non è richiesta autenticazione per accedere all'API.
-
Chiave API: Il tuo agente chiede all'utente di fornire una chiave API in fase di esecuzione, quindi si collega all'API usando quella chiave. Fornisci un'Etichetta (il nome mostrato durante la connessione), un nome di Parametro (ad esempio,
X-API-Key), e una Posizione (Header o Query). - OAuth 2.0: Gli utenti si autenticano all'API tramite un provider di identità senza condividere le proprie credenziali con l'agente. Fornisci valori come ID client, segreto client, URL di autorizzazione, URL del token e URL di aggiornamento del token.
Seleziona strumenti: sotto Strumenti disponibili, seleziona l'icona più accanto a ciascun strumento supportato da API (endpoint e combinazione di metodo HTTP, come get, put, post o delete) che desideri mostrare al tuo agente. Usa la casella di ricerca per trovare un'operazione specifica.
Configura strumento: Per ogni strumento selezionato, configura un nome e una descrizione dello strumento. Le descrizioni vengono inizialmente compilate dalla specifica dell'API. Fornisci una descrizione dettagliata, perché l'orchestrazione dell'agente la utilizza per determinare quando utilizzare questo strumento specifico.
Seleziona i parametri dello strumento: Rivedi i valori di input e output e aggiorna le descrizioni secondo necessità. Puoi aggiornare le descrizioni dei parametri, ma non i valori dei parametri stessi. Se qualche descrizione è vuota, completala prima di continuare. Ripeti i passaggi da Seleziona strumenti a Seleziona i parametri dello strumento per ogni strumento che vuoi aggiungere dall'API.
Revisione: Esamina il nome dello strumento, la descrizione, il tipo di autenticazione e il numero di strumenti selezionati prima della pubblicazione.
Pubblica: Seleziona Pubblica per creare lo strumento e renderlo disponibile al tuo agente.
Collega lo strumento dopo aver pubblicato
Prima che il tuo agente possa utilizzare lo strumento pubblicato, devi creare o selezionare una connessione per esso, indipendentemente dal tipo di autenticazione scelto, inclusa nessuna.
- Seleziona lo strumento pubblicato per aggiungerlo al tuo agente.
- Nella finestra di dialogo Connetti atool name, seleziona Seleziona una connessione, quindi scegli una connessione esistente o creane una nuova:
- Selezionare + Nuova connessione.
- Nella finestra di dialogo Collega alnome dello strumento , inserisci opzionalmente un nome visualizzato per la connessione. Questo nome appare nella lista delle connessioni.
- Seleziona Crea.
- Seleziona Aggiungi e configura per completare l'aggiunta dello strumento al tuo agente.