Microsoft Agent 365 SDK e CLI

Sei nuovo di Agent 365?

Se si è appena iniziato, scegliere il percorso più adatto:

Vorrei...	Inizia qui
Mettersi in funzione rapidamente con l'assistenza dell'intelligenza artificiale	AI-guided setup — Un agente di codifica di intelligenza artificiale (GitHub Copilot, Claude Code o OpenAI Codex) illustra l'installazione, la configurazione, la distribuzione e la pubblicazione da un singolo file di istruzioni.
Seguire un esempio pratico passo dopo passo	Quickstarts : selezionare un esempio nel linguaggio (Node.js, Python o .NET) e creare un agente di lavoro.
Comprendere il flusso di lavoro completo prima di immergersi	Introduzione allo sviluppo di Agent 365 : tipi di agenti, fasi, installazione e pubblicazione in una sola guida.
Comprendere quale tipo di agente costruire	Tipi di agenti : illustra i tipi di agente e i relativi modelli di identità.
Abilitare gli agenti Google Vertex AI o Amazon Bedrock	La registrazione per questi agenti non richiede alcun lavoro di sviluppo: gli agenti vengono estratti automaticamente tramite le API Google e Amazon. Nessuna integrazione dell'SDK, nessun progetto e non sono necessarie modifiche al codice. Dopo la registrazione, è possibile usare Agent 365 SDK per aggiungere l'osservabilità, l'accesso allo strumento IQ di lavoro e altre funzionalità in modo incrementale. Per iniziare, vedi Registrazione degli agenti Google Vertex AI e Amazon Bedrock .

SDK Agent 365

Usare Agent 365 SDK per estendere gli agenti creati con qualsiasi SDK agente o piattaforma, con identità di livello aziendale, osservabilità, notifiche, sicurezza e accesso regolamentato ai dati di Microsoft 365.

Suggerimento

Cerchi agenti predefiniti? Vedere gli 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.

Scopri di più sull'SDK Agent 365.

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.
• Gestire gli strumenti di Work IQ predefiniti e 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.

Important

Per apprezzare appieno il funzionamento dell'SDK e dell'interfaccia della riga di comando di Agent 365, vedere il flusso di lavoro descritto in Introduzione allo sviluppo di Agent 365

Progetto dell'agente Agent 365

Prima di lavorare con istanze di agenti Agent 365, è utile capire cosa intendiamo per il 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?

Agent 365 SDK differisce dai framework agente, ad esempio Microsoft Agent Framework o Microsoft Copilot Studio, perché non crea o non esegue agenti host. Migliora invece gli agenti già costruiti, indipendentemente dallo stack sottostante, aggiungendo funzionalità aziendali quali l'identità dell'agente basata su Entra, l'accesso governato agli strumenti Work IQ, l'osservabilità basata su OpenTelemetry (OTel), le notifiche tramite il protocollo Activity e la governance basata su ID agente.

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, osservabilità, strumenti	SDK Agent 365
Logica dell'agente	Prompt, flussi di lavoro, ragionamenti	La tua implementazione in codice
Runtime dell'Orchestratore LLM	Chiamata del modello e orchestrazione degli strumenti	SDK/Framework Agent a tua scelta

Passaggi successivi

Introduzione allo sviluppo di Agent 365