Panoramica dell'SDK Microsoft Agent 365

L'SDK di Microsoft Agent 365 collega un agente già posseduto e lo fa girare a Microsoft Agent 365. Usalo quando il tuo agente ha bisogno di accesso a livello di codice alle funzionalità di Agent 365 come identità dell'agente, osservabilità, strumenti Work IQ governati o notifiche.

Dove si inserisce l'SDK

Il modello di integrazione mostra il confine tra integrazioni integrate, sincronizzazione del registro e scenari Agent 365 SDK integrati dagli sviluppatori.

Diagramma del modello di integrazione dell'Agent 365 che mostra dove si inserisce l'SDK dell'Agent 365.

Gli agenti su piattaforme con integrazione integrata con Agent 365, e gli agenti importati tramite la sincronizzazione del registro, possono già apparire nell'inventario di Agent 365. Aggiungi l'SDK quando l'agente ha bisogno di funzionalità che il percorso della piattaforma non offre e che devi configurare in codice, come l'osservabilità o gli strumenti Work IQ. Le integrazioni delle piattaforme si evolvono, quindi conferma le linee guida attuali prima di decidere che l'SDK è necessario. Vedi Scegli l'opzione di integrazione.

Cosa aggiunge l'SDK

L'SDK offre quattro capacità:

Capability Descrizione
Identità 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 gli inquilini che partecipano al programma di anteprima Frontier.
Osservabilità Emette telemetria tramite OpenTelemetry, producendo interazioni auditate e tracciabili, eventi di inferenza e utilizzo degli strumenti.
Utensili Invoke governava i server Work IQ Model Context Protocol (MCP) 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 gli inquilini che partecipano al programma di anteprima Frontier.

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 come fondazione Entra. Le notifiche richiedono anche un account utente agente, mentre l'osservabilità 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.

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 costruisce agenti.
Estende un agente già esistente per aggiungere identità, osservabilità, strumenti e notifiche.		 Un quadro per costruire agenti conversazionali.
Gestisce la consegna dei messaggi su canali come Teams e Microsoft 365 Copilot, e gestisce lo stato della conversazione.

Questi due SDK lavorano insieme, quindi puoi costruire un agente con il Managed Disks e poi usare l'SDK Agent 365 per dargli identità, osservabilità, strumenti e notifiche.

Cosa sia e cosa non sia

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

Livello Descrizione
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 OpenAI Agents, l'SDK Claude Agent o codice personalizzato. L'SDK non costruisce agenti, non pianifica o orchestra passaggi, né esegue strumenti.
Host Ovunque l'agente funzioni oggi, come Azure, AWS, Google Cloud o on-premises. L'SDK non ospita né distribuisce il tuo agente.

L'SDK Microsoft Agent 365 gira insieme a questi livelli. Non costruisce, ospita, non schiera, 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 Descrizione
1. Registrazione Crea il blueprint dell'identità dell'agente e l'identità dell'agente in Microsoft Entra.
2. Estendere Aggiungi le funzionalità di cui il tuo agente ha bisogno, come l'osservabilità, gli strumenti Work IQ o le notifiche.
3. Validazione Esegui l'agente come prima e conferma la sua identità, telemetria, accesso agli strumenti e gestione dei messaggi.
4. Operare Usa i controlli dell'Agente 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 competenze 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 del tuo agente in un commento su Word:

  1. Le notifiche inviano la menzione 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 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.

I pacchetti SDK Agent 365 per Python si trovano sull'Indice dei Pacchetti Python (PYPI).

Package Descrizione
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 Componenti di telemetria, traccia e monitoraggio per gli agenti IA 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.
microsoft-agents-a365-observability-extensions-agent-framework Estensioni dell'osservabilità per Microsoft Agent Framework. Fornisce l'integrazione della traccia OpenTelemetry specificamente per le applicazioni basate su Agent Framework.
microsoft-agents-a365-observability-extensions-openai Estensioni di osservabilità per l'SDK OpenAI Agents. 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.
microsoft-agents-a365-observability-extensions-langchain Estensioni 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.
microsoft-agents-a365-observability-extensions-semantic-kernel Estensioni di osservabilità per Kernel semantico framework. 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.
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

  • Last updated on