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.
Quando gli utenti interagiscono con un agente dichiarativo in Microsoft 365 Copilot Chat, può connettersi ad altri agenti per recuperare informazioni aggiuntive o eseguire azioni. Queste connessioni vengono dichiarate nel manifesto dell'agente elencando gli ID del titolo dell'agente worker_agents nella proprietà. In fase di esecuzione, Copilot Chat funge da broker che media l'interazione: gli utenti vedono lo scambio agent-to-agent, ma non devono selezionare gli agenti connessi.
Nota
Gli agenti connessi dichiarati dal manifesto sono un meccanismo separato dall'API di Copilot Chat, che consente esperienze di conversazione basate su Microsoft 365 Copilot all'interno delle tue applicazioni personalizzate.
Nota
Gli utenti devono acquisire ogni agente connesso prima di poterlo usare. Per ulteriori informazioni, vedere Distribuzione di agenti connessi agli utenti dell'organizzazione.
Quando un utente interagisce con un agente dichiarativo, l'agente può delegare parte dell'attività a un agente connesso. Microsoft 365 Copilot valuta gli agenti connessi dichiarati nel manifesto e ne seleziona uno in base all'attività corrente e al nome, alla descrizione e alle richieste di esempio dell'agente connesso. Copilot invia una richiesta di testo all'agente connesso selezionato, riceve una risposta di testo e incorpora tale risposta nell'interazione continua dell'agente dichiarativo con l'utente.
Quando usare gli agenti connessi
Usare gli agenti connessi per suddividere o combinare gli agenti in più funzioni o team di sviluppo.
Espandersi oltre ciò che un agente può realizzare
I modelli linguistici di grandi dimensioni hanno una finestra di contesto utile e un set di funzionalità limitati. L'affidabilità di un singolo agente LLM inizia a diminuire man mano che vengono recuperati più documenti o vengono abilitati strumenti. Se un agente ha una qualità inferiore dopo aver aggiunto altre conoscenze o funzionalità, suddividere alcune di queste funzionalità in un altro agente e connettersi. L'agente esistente invia solo le informazioni sull'attività di cui ha bisogno per raggiungere la sua parte. L'agente connesso funziona nella propria finestra di contesto, senza altri documenti o funzionalità presenti nella conversazione dell'utente.
Integrazione con agenti sviluppati esternamente
Gli agenti dichiarativi possono semplificare la collaborazione con altri team di sviluppo. Ogni team di sviluppo può concentrarsi sulle capacità e sulla qualità del proprio agente, utilizzando agenti connessi per integrarsi con altri agenti. Come con i microservizi, ogni agente può essere sviluppato senza influire sugli altri agenti. A differenza dei microservizi, gli agenti possono continuare a interagire tra loro anche quando le loro interfacce cambiano.
Condividere le funzionalità degli agenti in più scenari
Un agente potrebbe funzionare bene con un insieme di documenti e azioni, ma potrebbe comunque essere difficile per gli utenti. Si consideri un agente che comprende le tabelle e i dati di un database relazionale di clienti e vendite. Questo agente potrebbe essere utile sia per i supervisori del negozio per gestire l'inventario sia per gli analisti aziendali per riferire ai dirigenti. Se questo agente potesse essere collegato a un agente su misura per i supervisori del negozio con spunti di conversazione e istruzioni, e anche a un agente su misura per i business analyst. Entrambi i tipi di utenti potrebbero ottenere più valore dall'utilizzo di agenti su misura per il loro scenario.
Abilitazione degli agenti connessi
È necessario registrare gli agenti connessi nel registro degli agenti di Microsoft Agent 365. Connettersi ad altri agenti includendo gli ID del titolo degli agenti nel manifesto dell'agente dichiarativo esistente. L'altro agente deve essere un agente dichiarativo o disporre di una scheda agente Agent2Agent registrata.
Prima di tutto, ottieni l'ID del titolo dell'agente per connetterti. L'ID del titolo di un agente è una stringa di una singola lettera, un carattere di sottolineatura e un GUID. Per un agente dichiarativo, trovalo nell'output del comando Provision in Microsoft 365 Agents Toolkit o in modalità sviluppatore. Per la registrazione di un agente di Microsoft 365, è di id proprietà dell'oggetto agentRegistration.
Aggiungere l'ID del titolo alla proprietà worker_agents come .id La worker_agents proprietà è stata aggiunta nello schema dell'agente dichiarativo versione 1.6.
Autenticazione e autorizzazione
La connessione a un agente dichiarativo si basa sull'autenticazione esistente dell'utente in Microsoft 365 Copilot, perché l'agente dichiarativo viene eseguito all'interno di Microsoft 365 Copilot Chat. Per gli agenti esterni registrati in Microsoft Agent 365, la registrazione dell'agente deve dichiarare all'agente esterno la modalità di autenticazione di Microsoft 365 Copilot. Invece di incorporare la configurazione dell'autenticazione direttamente nella registrazione dell'agente, la registrazione fa riferimento a una registrazione di autenticazione esistente tramite l'oggetto authorization nel agentRegistrationfile . Questa separazione consente di gestire la configurazione dell'autenticazione in modo indipendente dalle definizioni degli agenti. Il design rispecchia quello dei manifesti dei plug-in API.
Sintassi
{
"type": "None | OAuthPluginVault",
"referenceId": "{string}"
}
La type proprietà specifica lo schema di autenticazione utilizzato dall'agente esterno.
OAuthPluginVaultutilizza una registrazione SSO di Microsoft Entra. Il referenceId valore generato nel portale per sviluppatori di Microsoft Entra SSO registration ID Teams. Per altre informazioni, vedere Usare il portale per sviluppatori di Teams .
La possibilità per un utente di utilizzare l'agente connesso è determinata separatamente dall'autenticazione. Gli utenti devono avere accesso all'agente connesso, acquisendolo autonomamente o tramite la distribuzione dell'amministratore. Gli amministratori devono installare gli agenti esterni registrati in Microsoft Agent 365 per l'utente.
Procedure consigliate
Gli agenti dichiarativi scelgono gli agenti a cui connettersi in base ai prompt dell'agente nameconnesso , description, ed esempi. Per un agente dichiarativo, le richieste di esempio sono il text campo del conversation_starters manifesto. Per un agentRegistration, è la examples proprietà dell'oggetto AgentSkill nella scheda agente. La descrizione dell'agente dovrebbe descrivere sia agli esseri umani che agli agenti ciò che l'agente può fare. Ad esempio, considera questa descrizione per un agente che lavora con dati strutturati sulle vendite di videogiochi.
A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.
Le richieste di esempio devono informare sia gli utenti che gli agenti sui tipi di richieste che l'agente può gestire. Poiché gli utenti potrebbero usare termini diversi per lo stesso concetto, valuta la possibilità di variare la formulazione degli spunti di conversazione. Ad esempio, quando si lavora con casi legali, i buoni spunti di conversazione potrebbero anche usare i termini "materia", "caso", "cliente" e "problema". Solo il text campo di un oggetto di avvio della conversazione viene usato dagli agenti connessi.
Limitazioni
L'agente attivo invia solo SMS a un agente connesso. Gli agenti dichiarativi restituiscono testo o schede adattive. Gli agenti con schede agente Agent2Agent restituiscono testo, file binari di immagini Base64 e file binari Base64.
Mentre all'utente viene richiesto di confermare le chiamate del plug-in API dell'agente connesso, tutte le schede adattive vengono inviate all'agente attivo. L'utente non visualizza la scheda adattiva o non è in grado di usare una finestra di dialogo. Tuttavia, l'agente attivo elabora il contenuto dei dati della scheda adattiva.