Panoramica dell'SDK Microsoft Agent 365

L'SDK Microsoft Agent 365 collega un agente che già possiedi ed esegui a Microsoft Agent 365. Usalo per accedere a livello di codice a funzionalità come l'identità dell'agente, strumenti Work IQ governati o notifiche.

Dove si colloca l’SDK

Agent 365 riunisce agenti provenienti da fonti diverse in un unico piano di controllo dove le organizzazioni possono scoprirli, governarli e proteggerli su larga scala. Il percorso di integrazione dipende da dove e come costruisci l'agente:

Origine dell'agente Percorso di integrazione
piattaforme e agenti Microsoft, e agenti di terze parti supportati Usa l'integrazione nativa Agent 365 della piattaforma. Questi agenti possono apparire nell'inventario dell'Agente 365 senza aggiungere l'SDK dell'Agente 365.
Agents costruiti con un SDK o framework, come Managed Disks, OpenAI Agents SDK, Microsoft Agent Framework, LangChain, CrewAI o LlamaIndex Aggiungi l'SDK Agent 365 al codice dell'agente per funzionalità integrate per gli sviluppatori come gli strumenti di Work IQ o le notifiche.
Piattaforme di agenti connessi, come Vertex AI o AWS Bedrock Configura la sincronizzazione del registry per ogni piattaforma per importare i propri agenti nell'inventario di Agent 365.

Tutti e tre i percorsi collegano gli agenti all'Agent 365 e alle sue integrazioni con Microsoft Entra, Microsoft Defender, Microsoft Purview e Microsoft Intune. L'integrazione nativa e la sincronizzazione del registro non forniscono necessariamente le stesse capacità a livello di codice dell'SDK Agent 365. Le integrazioni delle piattaforme evolvono, quindi verifica le linee guida attuali prima di modificare un'integrazione. Vedi Scegli l'opzione di integrazione.

Come si integrano le capacità di Agent 365

L'integrazione per sviluppatori di Agent 365 offre quattro funzionalità. L'SDK Agent 365 fornisce identità, strumenti e notifiche. Microsoft OpenTelemetry fornisce osservabilità:

Capacità Description
Identity Utilizza un'identità di agente supportata da Microsoft Entra per un'autenticazione sicura e un accesso controllato a strumenti e dati. Gli agenti che necessitano del proprio account utente e della casella di posta sono disponibili solo per i tenant che partecipano al programma di anteprima Frontier.
Osservabilità Utilizzare la separata distribuzione Microsoft OpenTelemetry per emettere telemetria che produca interazioni auditate e tracciabili, eventi di inferenza e utilizzo degli strumenti.
Utensili Richiama i server Work IQ Model Context Protocol (MCP) governati per raggiungere carichi di lavoro Microsoft 365 come Mail, Calendar, Word, SharePoint e Teams sotto il controllo amministrativo.
Notifiche Ricevi e rispondi ai messaggi da Teams, Outlook, commenti Word e email, come un partecipante umano alle app Microsoft 365. Questa funzionalità richiede l'account utente di un agente ed è disponibile solo per i tenant che partecipano al programma di anteprima Frontier.

Importante

Non usare Agent 365 Observability SDK deprecato per nuove integrazioni di osservabilità. Usa la distribuzione Microsoft OpenTelemetry. Continua a utilizzare i pacchetti SDK Agent 365 per identità, strumenti e notifiche.

Scegli le funzionalità che corrispondono alle esigenze del tuo agente invece di adottare l'intera superficie SDK. Identità, strumenti e notifiche utilizzano un blueprint di identità dell'agente con Entra come base. Le notifiche richiedono anche un account utente agente. Microsoft OpenTelemetry può utilizzare sia il blueprint dell'identità dell'agente sia una registrazione standard dell'app Microsoft Entra.

L’SDK è distribuito in pacchetti specifici per linguaggio per Python, JavaScript e .NET. Installa il pacchetto o i pacchetti per le funzionalità selezionate, poi configura l'identità, i permessi e l'integrazione in runtime corrispondenti. Per i pacchetti disponibili, vedi pacchetti SDK Agent 365. Installa Microsoft OpenTelemetry separatamente per nuove integrazioni di osservabilità.

Confronta Microsoft Agent 365 SDK e Managed Disks

Microsoft Agent 365 SDK e Managed Disks sono prodotti diversi.

Microsoft Agent 365 SDK (Questo SDK) Managed Disks
Non crea gli agenti.
Estende un agente già esistente per aggiungere identità, strumenti e notifiche. Usa Microsoft OpenTelemetry per aggiungere osservabilità.		 Un quadro per costruire agenti conversazionali.
Gestisce la consegna dei messaggi su canali come Teams e Microsoft Copilot, e gestisce lo stato della conversazione.

Questi SDK lavorano insieme. Puoi creare un agente con Managed Disks, usare Agent 365 SDK per identità, strumenti e notifiche e usare Microsoft OpenTelemetry per il monitoraggio e l'osservabilità.

Cosa sia e cosa non sia

Continui a possedere i tre strati che fanno funzionare l'agente:

Livello Description
Modello Il modello linguistico o motore di ragionamento che il tuo agente chiama. L'SDK non chiama né seleziona i modelli.
Framework o runtime LangChain, Microsoft Agent Framework, Kernel semantico, l’SDK di OpenAI Agents, l’SDK di Claude Agent o codice personalizzato. L'SDK non crea agenti, non pianifica né orchestra passaggi, né invoca strumenti.
Host Ovunque l'agente funzioni oggi, come Azure, AWS, Google Cloud o on-premises. L’SDK non ospita né distribuisce il deployment del tuo agente.

L'SDK di Microsoft Agent 365 gira insieme a questi livelli. Non costruisce, ospita, non distribuisce, non orchestra o non esegue l'agente.

Note

L'SDK Microsoft Agent 365 registra i server MCP governati così il tuo agente può raggiungere i carichi di lavoro di Microsoft 365, ma il runtime esegue comunque le chiamate dello strumento.

Il flusso di onboarding

L'integrazione segue quattro fasi:

Stage Description
1. Registrati Crea il blueprint dell'identità dell'agente e l'identità dell'agente in Microsoft Entra.
2. Estendi Aggiungi le capacità di cui il tuo agente ha bisogno. Usa l'SDK Agent 365 per i tool o le notifiche di Work IQ, e usa Microsoft OpenTelemetry per l'osservabilità.
3. Convalida Esegui l'agente come prima e conferma la sua identità, telemetria, accesso agli strumenti e gestione dei messaggi.
4. Aziona Usa i controlli di Agent 365 per governare e verificare l'agente connesso.

Puoi completare questi passaggi manualmente o utilizzare Agent 365 Skills da un assistente di programmazione supportato. Le skill guidano la configurazione, apportano le modifiche necessarie e convalidano il risultato.

Come scorre una richiesta

Una singola interazione può utilizzare tutte e quattro le capacità. Quando qualcuno @mentions menziona il tuo agente in un commento su Word:

  1. Le notifiche inviano la @mention al tuo agente.
  2. Identità e autenticazione determinano se l'agente agisce come se stesso, per conto di un utente connesso o tramite un account utente agente. La modalità selezionata, i permessi, il consenso e l'oggetto del token definiscono quali dati e azioni sono disponibili.
  3. Gli strumenti danno all'agente accesso controllato ai dati Microsoft 365 di cui ha bisogno.
  4. L'osservabilità registra l'invocazione, le chiamate agli strumenti e l'inferenza del modello.

Il tuo agente risponde poi nel thread dei commenti.

Pacchetti dell'SDK Agent 365

Trova i pacchetti SDK Agent 365 nei gestori di pacchetti per i linguaggi supportati.

Importante

I pacchetti di osservabilità nelle tabelle seguenti sono obsoleti. Non utilizzarli per nuove integrazioni. Usa il Microsoft OpenTelemetry Distro o consulta la documentazione obsoleta di Agent 365 Observability SDK prima di migrare un'integrazione esistente.

Puoi trovare i pacchetti SDK Agent 365 per Python sull'Indice dei Pacchetti Python (PYPI).

Package Description
microsoft-agents-a365-notifications Estensioni di notifica e messaggistica per le applicazioni dell'agente IA. Fornisce utilità per la gestione delle notifiche degli agenti, degli eventi del ciclo di vita e del routing tra canali e sottocanali diversi nelle applicazioni Microsoft 365.
microsoft-agents-a365-observability-core Deprecato: componenti legacy di telemetria, tracciamento e monitoraggio per agenti AI basati su OpenTelemetry. Fornisce intervalli strutturati per l'invocazione degli agenti, l'esecuzione degli strumenti e l'inferenza LLM con propagazione del contesto ed esportatori pluggabili. Usa invece la distribuzione Microsoft OpenTelemetry.
microsoft-agents-a365-observability-extensions-agent-framework Deprecato: Estensioni legacy di osservabilità per Microsoft Agent Framework. Fornisce l'integrazione della traccia OpenTelemetry specificamente per le applicazioni basate su Agent Framework. Usa invece la distribuzione Microsoft OpenTelemetry.
microsoft-agents-a365-observability-extensions-openai Deprecato: Estensioni legacy di osservabilità per OpenAI Agents SDK. Fornisce l'integrazione della traccia OpenTelemetry per le applicazioni basate su agenti OpenAI con strumentazione automatica per i flussi di lavoro degli agenti e le chiamate agli strumenti. Usa invece la distribuzione Microsoft OpenTelemetry.
microsoft-agents-a365-observability-extensions-langchain Deprecato: Estensioni legacy di osservabilità per il framework LangChain. Fornisce l'integrazione della traccia OpenTelemetry per le applicazioni di intelligenza artificiale basate su LangChain con strumentazione automatica per catene, agenti e strumenti. Usa invece la distribuzione Microsoft OpenTelemetry.
microsoft-agents-a365-observability-extensions-semantic-kernel Deprecato: Estensioni legacy di osservabilità per il framework Kernel semantico. Fornisce integrazione di tracciamento OpenTelemetry per applicazioni basate su Kernel semantico, con strumentazione automatizzata per le funzioni del kernel, i plug-in e i pianificatori. Usa invece la distribuzione Microsoft OpenTelemetry.
microsoft-agents-a365-runtime Utilità di runtime di base e gestione dell'ambiente per le applicazioni con agente IA. Fornisce funzionalità essenziali per l'individuazione delle API di Power Platform, la configurazione dell’ambiente e la risoluzione degli ambiti di autenticazione.
microsoft-agents-a365-tooling Funzionalità di base degli strumenti per la gestione del server degli strumenti MCP (Model Context Protocol) nelle applicazioni create con l'SDK Microsoft Agent 365. Fornisce le basi per l'individuazione, la registrazione e la gestione dei server di strumenti in diversi framework di intelligenza artificiale.
microsoft-agents-a365-tooling-extensions-agentframework Strumenti e servizi specifici di Agent Framework per lo sviluppo dell'agente IA. Fornisce il servizio di registrazione dello strumento MCP (Model Context Protocol) per l'aggiunta dinamica di server MCP agli agenti di Agent Framework.
microsoft-agents-a365-tooling-extensions-openai Strumenti e servizi specifici dell'SDK OpenAI Agents per lo sviluppo dell'agente IA. Fornisce il servizio di registrazione dello strumento MCP (Model Context Protocol) per l'aggiunta dinamica di server MCP agli agenti basati sull'SDK OpenAI Agents.
microsoft-agents-a365-tooling-extensions-semantickernel Kernel semantico strumenti e servizi specifici per lo sviluppo di agenti di intelligenza artificiale. Fornisce il servizio di registrazione dello strumento MCP (Model Context Protocol) per l'aggiunta dinamica di server MCP agli agenti basati su Kernel semantico.
microsoft-agents-a365-tooling-extensions-azureaifoundry Azure AI Foundry strumenti e servizi specifici per lo sviluppo di agenti di intelligenza artificiale. Fornisce il servizio di registrazione dello strumento MCP (Model Context Protocol) per l'aggiunta dinamica di server MCP agli agenti Azure AI Foundry.

Contenuti correlati

  • Ultimo aggiornamento: