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.
Confronta le tre opzioni di integrazione con Agent 365 e scegli il meccanismo giusto in base alle funzionalità offerte dalla tua piattaforma e a ciò che devi configurare in codice.
Confronta i meccanismi di integrazione dell'Agent 365
Usa la tabella seguente per confrontare dove si applica ogni meccanismo di integrazione, come lo implementi e se richiede l'Agent 365 SDK.
| Meccanismo | Si applica a | Come viene applicato | SDK richiesto |
|---|---|---|---|
| Integrazione integrata | Piattaforme e agenti Microsoft, come Agent Builder, Copilot Studio, Azure AI Foundry, Copilot Cowork e Researcher. Anche agenti di terze parti sono già integrati con l'Agente 365. | Nessuna integrazione SDK o codice personalizzato. Potrebbe comunque essere necessario un abilitamento amministrativo. | No |
| Sincronizzazione del registro (anteprima) | Piattaforme di agente connessi, come Google Vertex AI e Amazon Bedrock. | Configurato per piattaforma. Importa agenti per visibilità e governance. | No |
| SDK Agent 365 | Gli agenti li costruisci con un SDK o framework agente, come il Managed Disks, Microsoft Agent Framework, OpenAI Agents SDK, LangChain, CrewAI o LlamaIndex. | Sviluppatore integrato, nel codice del tuo agente. | Sì |
Tip
Controlla prima l'integrazione integrata e la sincronizzazione del registro. Se uno di questi percorsi fornisce già le funzionalità Agent 365 di cui hai bisogno, non serve l'SDK solo per registrare l'agente. Aggiungi l'SDK quando il tuo scenario ha bisogno di funzionalità a livello di codice che il percorso della piattaforma non fornisce.
Note
Alcune piattaforme supportano più di un meccanismo. Copilot Studio e Azure AI Foundry possono fornire integrazione integrata con Agent 365 per alcuni scenari, mentre gli agenti basati su codice costruiti con componenti Foundry supportati possono utilizzare l'SDK quando necessitano di funzionalità non fornite da quel percorso di piattaforma. Possedere o distribuire codice da solo non determina la scelta; Confronta le capacità e il modello di autenticazione per lo scenario specifico. Per gli agenti ospitati da Foundry, consulta la documentazione di Visione personalizzata di Azure AI e le linee guida per configurare la raccolta dati di Agent 365 e concedere permessi di osservabilità per Agent 365.
Il percorso di integrazione disponibile per Azure AI Foundry può dipendere da come l'agente viene costruito, ospitato e registrato. Conferma le attuali linee guida di integrazione e osservabilità di Foundry per il tuo scenario prima di scegliere un approccio. Per gli agenti basati su codice, inizia con il quickstart dell'SDK di Microsoft Foundry e confrontalo con la guida per agenti ospiti.
Quando utilizzare l'SDK dell'Agente 365
Usa l'SDK Agent 365 quando:
- Costruisci e distribuisci il tuo agente da solo, invece di ospitarlo su una piattaforma Microsoft integrata.
- Il tuo agente ha bisogno di una o più funzionalità di Agent 365: identità, osservabilità, strumenti o notifiche. Per cosa fornisce ciascuna capacità, vedi panoramica dell'SDK dell'Agente 365.
- Il tuo agente ha bisogno di un controllo a livello di codice su quando e come queste funzionalità vengono eseguite.
L'identità è spesso il fattore decisivo sul percorso SDK. La capacità di identità supporta tre modalità di esecuzione: service-to-service (S2S), on-behalf-of-of-in-of a loged-in user (OBO), e Agentic-User, in cui l'agente utilizza il proprio account utente Entra. Scegli la modalità che corrisponde al lavoro svolto dall'agente e al percorso della piattaforma disponibile per il tuo scenario. Per il modello identità e le sue decisioni di configurazione, vedi Identità dell'agente.
La sincronizzazione del registro e l'integrazione integrata possono cambiare man mano che il supporto della piattaforma evolve. Controlla le attuali linee guida di integrazione della piattaforma prima di aggiungere funzionalità a livello di codice.
Note
L'SDK non è un'alternativa al tuo framework agente, quindi "costruire un agente" non è uno di questi meccanismi. Costruisci prima l'agente con il tuo framework, poi usa uno dei meccanismi precedenti per portarlo nell'Agente 365.