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.
[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]
Usa gli agenti connessi per permettere al tuo agente principale di delegare una richiesta a un agente indipendente ospitato in Microsoft Foundry. A differenza di un sotto-agente, un agente connesso mantiene la propria configurazione e la gestione del ciclo di vita, separata dal tuo agente principale.
Tip
Gli agenti connessi non possono fare riferimento a strumenti, argomenti di conversazione, eventi, sotto-agenti o variabili dell'orchestrazione dell'agente principale. Consulta le migliori pratiche per lavorare con i sotto-agenti per un confronto completo di ciò a cui agenti primari, sotto-agenti e agenti connessi possono ciascuno fare riferimento.
Prerequisiti
- Un agente principale creato con il harness Customer Conversation. Vedi Crea un nuovo agente (Conversazione con il cliente).
- Un agente Microsoft Foundry a cui connettersi. L'agente Foundry deve avere abilitato l'endpoint del protocollo Activity . Un agente Foundry appena creato espone di default solo gli endpoint del protocollo Responses e A2A; se l'endpoint Activity non è abilitato, la connessione fallisce in runtime con un errore 400. Puoi abilitare l'endpoint Attività:
- Pubblicando l'agente Foundry su Microsoft 365 e Teams. Scopri di più in Pubblica agenti su Microsoft Copilot e Microsoft Teams.
- Programmaticamente, usando l'API REST o l'SDK Python. Scopri di più in Configura e condividi il tuo agente Microsoft Foundry.
- Accedi all'URL dell'endpoint del progetto Foundry per l'agente a cui vuoi connetterti.
Prepara il tuo agente Foundry
Prima di poter aggiungere un agente connesso, localizza e pubblica l'agente nel portale Microsoft Foundry, poi copia i valori necessari per creare la connessione:
- Nel portale Microsoft Foundry, localizza l'agente a cui vuoi connetterti.
- Pubblicazione dell'agente.
- Copia l'Endpoint progetto Azure AI per il progetto dell'agente.
- Copia l'ID dell'agente (il nome dell'agente).
Aggiungere un agente connesso
Accedere a Copilot Studio.
Apri l'agente principale a cui vuoi aggiungere un agente collegato.
Nella scheda Build, seleziona la scheda dell'agente principale per aprire il suo pannello di configurazione.
Nel pannello dei componenti, seleziona Agenti connessi per aprire la finestra di dialogo Aggiungi un agente connesso.
Seleziona la connessione da usare per Microsoft Foundry, oppure crea una nuova connessione fornendo l'URL dell'endpoint del progetto Foundry nel formato
https://{account-name}.services.ai.azure.com/api/projects/{project-name}, poi seleziona Avanti.Inserisci un nome e una descrizione per l'agente collegato. La descrizione dovrebbe spiegare lo scopo dell'agente Foundry affinché l'orchestratore sappia quando instradare le richieste verso di esso.
Immetti l'ID agente per l'agente Microsoft Foundry a cui vuoi connetterti.
Seleziona Aggiungi agente.
Verifica che l'agente connesso appaia nel pannello dei componenti.
Pubblica il tuo agente principale. La pubblicazione è necessaria per poter comunicare con Azure; non è necessario distribuirla su un canale specifico ancora. Vedi Deploy an agent (Customer Conversation).
Caution
Il modello che scegli per l'agente in Microsoft Foundry influisce su quanto tempo ci vuole per rispondere alla domanda di un cliente. Scegli un modello con una latenza di risposta adeguata al tuo scenario, specialmente se l'agente sarà pubblicato su un canale vocale.