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.
Note
Questo articolo descrive le caratteristiche utilizzate negli agenti o nei flussi di agenti alimentati dall'imbracatura standard.
[Questo articolo è una documentazione preliminare ed è soggetto a modifiche.]
È possibile connettere un agente Microsoft Foundry all'agente personalizzato, consentendogli di chiamare l'agente per rispondere a un utente o a un trigger.
Importante
Questo articolo contiene la documentazione sull'anteprima di Microsoft Copilot Studio ed è pertanto soggetto a modifiche.
Le funzionalità di anteprima non sono destinate all'uso in produzione e potrebbero avere funzionalità limitate. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che sia possibile ottenere l'accesso iniziale e inviare commenti.
Se stai creando un agente destinato alla produzione, vedi Panoramica di Microsoft Copilot Studio.
Prerequisiti
Prima di collegare un agente Microsoft Foundry a Copilot Studio, l'agente Foundry deve avere abilitato l'endpoint del protocollo Activity. Un agente Foundry appena creato espone di default solo gli endpoint dei protocolli Responses e A2A . Se l'endpoint Activity non è abilitato, la connessione a Copilot Studio ha esito negativo in fase di esecuzione, restituendo un errore 400. Altre informazioni in Abilitare l'A2A in ingresso in un agente Foundry.
Attualmente puoi abilitare l'endpoint Activity solo in modo programmativo, usando l'API REST o l'SDK Python. Non c'è l'opzione per abilitarlo dal portale Microsoft Foundry. Scopri di più sulla procedura di abilitazione in Configura e condividi il tuo agente.
Dopo aver abilitato l'endpoint di attività, la sezione Endpoint nel portale Foundry per l'agente continua a visualizzare soltanto Risposte e A2A. Questa omissione dell'interfaccia è prevista e non significa che la modifica sia fallita. La connessione a Copilot Studio funziona dopo l'applicazione dell'aggiornamento.
Connettersi a un agente Microsoft Foundry
Passa alla pagina Agenti per l'agente principale e seleziona Aggiungi un agente.
In Connetti a un agente esterno, seleziona Microsoft Foundry dai tipi di agente disponibili.
Selezionare la connessione desiderata dall'elenco delle connessioni disponibili o creare una nuova connessione tra Microsoft Foundry e l'agente di Copilot Studio. Per creare una nuova connessione, è necessario specificare l'URL dell'endpoint del progetto Foundry.
Note
Quando ci si connette agli agenti Microsoft Foundry da Copilot Studio, è possibile connettersi solo agli agenti creati nel nuovo portale di Microsoft Foundry. Collegarsi a un agente creato nel portale precedente si traduce in un errore che indica
404 - Version not found.Dopo aver creato la connessione, seleziona Avanti.
Immetti un nome e una descrizione appropriati per l'agente SDK. La descrizione deve descrivere lo scopo dell'agente Microsoft Foundry, consentendo all'agente principale di comprendere quando deve essere usato. Per altre informazioni, vedi scrittura di metadati efficaci.
Immetti l'ID agente per l'agente Microsoft Foundry a cui vuoi connetterti.
Modifica la descrizione (se necessario) per renderla più contestuale per l'agente principale. Ad esempio, rendi la descrizione più specifica se disponi di altri strumenti o agenti in cui le descrizioni potrebbero sovrapporsi. Aggiorna la descrizione per assicurarti che Copilot Studio possa capire quando invocare questo agente.
Seleziona Aggiungi agente.
Dopo aver creato l'agente, è possibile testare immediatamente l'agente. Se è necessario modificare l'ID agente in un secondo momento, è possibile farlo dalla pagina dei dettagli selezionando l'agente dall'elenco Agenti.
Note
Se la tua prima chiamata di test all'agente Foundry connesso fallisce con un errore simile a "Il connettore 'Visione personalizzata di Azure AI ' ha restituito un errore HTTP con codice 400. Errore interno: L'endpoint dell'agente
<name>non supporta attività. Per favore aggiorna l'endpoint dell'agente per supportare questo protocollo.", l'agente Foundry non ha abilitato l'endpoint del protocollo Activity . Consulta i Prerequisiti in questo articolo, poi abilita l'endpoint Attività seguendo Configura e condividi il tuo agente nella documentazione di Microsoft Foundry.Sei responsabile di rivedere e testare attentamente gli agenti connessi nel contesto dei tuoi casi d'uso specifici, e di prendere tutte le decisioni e personalizzazioni appropriate. Quando ti connetti ad agenti esterni a Copilot Studio, sei responsabile dell'utilizzo di tali agenti. Le considerazioni includono garantire:
- I flussi di dati, la gestione dei dati e la condivisione dei dati tra agenti sono appropriati per il tuo caso d'uso e rispettano i requisiti e le leggi pertinenti.
- Gli agenti soddisfano adeguati standard di qualità, affidabilità, sicurezza e fidatezza.
- Sono previsti permessi, limiti e approvazioni appropriati, se opportuno per il tuo caso d'uso.
- Sono presenti adeguate funzionalità di osservabilità, identità e tracciabilità, nonché funzioni di supervisione umana.