Microsoft Agent 365 SDK e CLI

Sei nuovo di Agent 365?

Per prima cosa, scegli l'opzione di integrazione. Se l'integrazione integrata o la sincronizzazione del registro offre le funzionalità di cui hai bisogno, non è necessario aggiungere l'SDK solo per registrare il tuo agente. Per gli agenti Google Vertex AI e Amazon Bedrock, vedi Registra gli agenti Google Vertex AI e Amazon Bedrock.

Se il tuo agente ha bisogno di integrazione a livello di codice, scegli un percorso basato sul punto di partenza e sul risultato che desideri:

Punto di partenza	Iniziare da qui	Primo risultato	Prima di iniziare
Hai un agente e vuoi l'onboarding assistito dall'IA.	Avvio rapido: collega un agente esistente ad Agent 365, utilizzando Agent 365 Skills.	Registra l'agente, aggiungi le funzionalità che scegli e convalida l'integrazione.	Rivedi gli stack supportati, gli assistenti di programmazione, l'accesso ai tenant, i ruoli e i requisiti di licenza.
Hai un agente e vuoi eseguire tu stesso i comandi CLI.	Configura un progetto dell'agente.	Crea il modello che definisce l'identità e i permessi del tuo agente.	Rivedi la CLI, il ruolo del tenant e i requisiti di abbonamento ad Azure, poi usa l'identità dell'Agente per scegliere il modello di identità.
Apprendi con un progetto di esempio piuttosto che cambiare l'agente.	Scegli un campione in Python, Node.jso .NET.	Configura un esempio e ottieni una prima risposta in Agents Playground.	Rivedi i prerequisiti del quickstart o del README di esempio selezionato, inclusi runtime, accesso al modello e configurazione dell'autenticazione.

Per il percorso di esempio, il catalogo rimanda all'avvio rapido di Python + Microsoft Agent Framework, Node.js + LangChain e Node.js + Claude Agent SDK, più un esempio .NET. Scegli la tua lingua nel catalogo per vedere i framework disponibili.

Note

Una risposta locale non è la prova che gli strumenti, le notifiche o la telemetria Microsoft 365 in tempo reale funzionino. Per le funzionalità supportate dal tenant, rivedere i requisiti di tenant, consenso e licenza e la configurazione dell'autenticazione per il test.

SDK Agent 365

Usa l'Agent 365 SDK per estendere gli agenti costruiti utilizzando qualsiasi agente SDK o piattaforma con identità, notifiche, sicurezza e accesso governato ai dati di Microsoft 365. Usa Microsoft OpenTelemetry per l'osservabilità.

Tip

Cerchi agenti predefiniti? Vedi Agenti partner dell'ecosistema disponibili in Agent 365 per gli agenti preintegrati all'avvio.

Gli agenti hanno identità uniche. Gli utenti li richiamano usando gesti comuni, ad esempio @mentions) nelle app in cui gli utenti aziendali operano in genere (ad esempio Teams, Word, Outlook e altro ancora). Dimostrano comportamenti osservabili che costruiscono fiducia, intraprendono azioni verificabili e lo fanno tramite accesso sicuro a strumenti e dati.

Con l'Agent 365 SDK, gli agenti possono:

• Usa Agent Identity supportata da Entra con le proprie risorse utente come la casella postale per un'autenticazione sicura e un accesso controllato a strumenti e dati.
• Ricevere e rispondere alle notifiche da Teams, Outlook, Word commenti e messaggi di posta elettronica, proprio come un partecipante umano nelle app Microsoft 365.
• Ottieni completa osservabilità tramite Open Telemetry, permettendo interazioni con agenti controllate e tracciabili, eventi di inferenza e utilizzo degli strumenti.
• Richiamare server MCP (Model Context Protocol) regolamentati per accedere ai carichi di lavoro Microsoft 365 (ad esempio, Posta, Calendario, SharePoint, Teams) sotto il controllo dell'amministratore.
• Opera all'interno di un sistema modello approvato dall'IT, assicurando che ciascuna istanza di agente erediti le politiche di conformità, governance e sicurezza.

Consulta la panoramica di Agent 365 SDK.

Agente 365 CLI

Agent 365 CLI è il backbone della riga di comando per Agent 365 nell'intero ciclo di vita dello sviluppo dell'agente: automazione della configurazione, identità, configurazione, integrazione MCP, pubblicazione e distribuzione Azure per gli agenti pronti per le aziende.

Con la CLI di Agent 365, gli sviluppatori possono:

• Crea progetti per gli agenti e tutte le risorse di supporto necessarie.
• Gestisci gli strumenti di Work IQ predefiniti personalizzati, i permessi e il supporto per gli agenti.
• Distribuire il codice dell'agente in Azure.
• Pubblica i pacchetti applicativi degli agenti nel centro amministrativo Microsoft.
• Pulire i modelli di agente, le identità degli agenti e altre risorse Azure create dal CLI.

Scopri di più sulla CLI Agent 365

Ciclo di vita dello sviluppo dell'agente Agent 365

L'Agent 365 funziona con agenti costruiti su qualsiasi SDK o piattaforma di agente. Sono incluse piattaforme a basso codice come Copilot Studio e Azure AI Foundry. Supporta inoltre opzioni pro-code come Microsoft Agent Framework, Microsoft Agents SDK, OpenAI Agents SDK, Claude Code SDK e LangChain SDK. Agent 365 funziona anche con il codice agente ospitato in qualsiasi endpoint, ad esempio Azure, Amazon Web Services (AWS), Google Cloud Platform (GCP) o qualsiasi altro provider di servizi cloud.

Il quickstart per agenti esistenti copre la registrazione, le capacità selezionate e la validazione. Distribuzione, pubblicazione e pulizia dispongono di guide separate. Continua con le fasi che si applicano al tuo scenario:

Phase	Guide
Valida l'integrazione prima del deployment.	Checklist per la validazione dell'Agent 365 SDK e testa il tuo agente.
Distribuisci il codice del tuo agente.	Azure, AWS o Google Cloud Platform.
Crea il pacchetto e pubblica l'agente.	Pubblica l'agente nel centro amministrativo Microsoft.
Crea e verifica un'istanza di agente distribuita.	Crea istanze di agente e testa il tuo agente distribuito.
Rimuovi le risorse di cui non hai più bisogno.	Riferimento per la pulizia della CLI, inclusi opzioni di pulizia granulare e di esecuzione di prova.

Progetto dell'agente Agent 365

Prima di lavorare con le istanze degli agenti Agent 365, è utile comprendere cosa intendiamo per blueprint di un agente Agent 365. Questo deriva dallo schema dell'agente Microsoft Entra ed è una definizione approvata dall'IT e preconfigurata di un tipo di agente, essenzialmente il "modello" aziendale da cui possono essere creati agenti conformi. Definisce le funzionalità dell'agente, l'accesso richiesto allo strumento IQ aziendale, i vincoli di sicurezza e conformità, i requisiti di controllo, i metadati del ciclo di vita e i modelli di criteri di governance collegati, ad esempio DLP, restrizioni di accesso esterno o regole di registrazione. Quando un progetto viene attivato per l'uso in un tenant, gli utenti possono richiedere agli amministratori nuove istanze dell'agente create dal progetto agente nell'interfaccia di amministrazione di Microsoft 365. Ogni istanza agente eredita le regole del modello, garantendo una governance coerente per la posta elettronica, il calendario, Teams, l'accesso a SharePoint e qualsiasi altro carico di lavoro Microsoft 365 a cui l'agente accede. Questo previene agenti ombra/senza autorizzazione, impone il monitoraggio e garantisce che ogni agente sia ancorato in un modello sicuro di identità e permessi supportato da Entra.

In cosa è diverso l'SDK dell'Agente 365?

L'Agent 365 SDK si differenzia dai framework di agenti come Microsoft Agent Framework o Microsoft Copilot Studio perché non crea né ospita agent. Invece, migliora gli agenti che hai già costruito, indipendentemente dallo stack sottostante, aggiungendo funzionalità aziendali come l'identità dell'Agente basata su Entra, l'accesso governato agli strumenti Work IQ, le notifiche tramite il protocollo Activity e una governance guidata dall'ID dell'agente. Usa Microsoft OpenTelemetry per l'osservabilità.

Anche se molto simile nel nome, non sostituisce il Managed Disks e la funzionalità fornita per l'hosting, il protocollo di attività e l'identità. Al contrario, l'SDK dell'Agente 365 lo integra stratificando controlli di governance, conformità e ciclo di vita sopra agenti costruiti con esso o con altre piattaforme.

SDK dell'Agente 365 e l'ecosistema dell'agente

Questa tabella riassume l'architettura degli agenti stratificati, mostrando come l'Agent 365 SDK aggiunga capacità enterprise sopra la logica dell'agente e il runtime dell'orchestratore LLM fornito dal framework scelto.

Livello	Ruolo	Fornito da
Funzionalità aziendali	Identità, notifiche e strumenti dall'SDK Agent 365; osservabilità da Microsoft OpenTelemetry	SDK Agent 365 e Microsoft OpenTelemetry
Logica dell'agente	Prompt, flussi di lavoro, ragionamento	La tua implementazione in codice
Runtime dell'Orchestratore LLM	Chiamata del modello e orchestrazione degli strumenti	SDK/Framework Agent a tua scelta

Passaggi successivi

Collega un agente esistente all'Agente 365