Questo articolo risponde alle domande più comuni sull'SDK Agent 365: cosa fa e cosa non fa, quando ne hai bisogno, quali funzionalità sono disponibili, come funziona l'identità e come validare un'integrazione.
Ambito e posizionamento
Posso costruire un agente con l'SDK dell'Agent 365?
No. L'SDK non è un framework di costruzione di agenti. Costruisci il tuo agente con il framework scelto, poi usa l'SDK di Agent 365 per portarlo in Agent 365. Vedi Quando usare l'SDK Agent 365.
L'SDK effettua chiamate al modello linguistico o orchestra i passaggi?
No. Il tuo agente continua a fare le proprie chiamate di modello, e l'orchestrazione rimane nel tuo framework o runtime. Vedi Agent 365 SDK e l'ecosistema degli agenti.
L'SDK ospita o distribuisce il mio agente?
No. Il tuo agente lavora ovunque funzioni oggi. Vedi In cosa è diverso l'SDK dell'Agente 365?
L'SDK esegue le chiamate agli strumenti del mio agente?
No. I registri SDK governavano i server Model Context Protocol (MCP); L'esecuzione rimane nel tuo runtime. Vedi Agent 365 SDK e l'ecosistema degli agenti.
L'SDK sostituisce il mio framework agente?
No. Mantieni il tuo modello, framework o runtime, e host. L'SDK si avvicina a esse e aggiunge identità, osservabilità, strumenti e notifiche. Per il confine layer per layer, vedi panoramica dell'SDK Agent 365.
In cosa si differenzia l'Agent 365 SDK da quello di Managed Disks?
L'Managed Disks crea agenti conversazionali, gestendo la connettività del canale e lo stato della conversazione. L'SDK dell'Agente 365 estende un agente che hai già creato. I due lavorano insieme. Vedi panoramica dell'SDK dell'Agente 365.
Quali linguaggi supporta l'SDK?
Python, JavaScript e .NET. Vedi i pacchetti SDK dell'Agente 365.
Scelta di un meccanismo di integrazione
Ho bisogno dell'SDK?
Non sempre. Se l'integrazione integrata o la sincronizzazione del registro già offrono le funzionalità di cui il tuo agente ha bisogno, potresti non aver bisogno dell'SDK. Vedi Scegli l'opzione di integrazione.
Quando è sufficiente un'integrazione integrata?
Quando il percorso della piattaforma fornisce già le capacità Agent 365 richieste dal tuo scenario. Copilot Studio e Azure AI Foundry possono rientrare in questa categoria, ma il supporto dipende da come l'agente viene costruito, autenticato e ospitato. Possedere o distribuire codice di per sé non richiede l'SDK. Vedi Confronta i meccanismi di integrazione dell'Agent 365.
Qual è la differenza tra sincronizzazione del registro e integrazione SDK?
La sincronizzazione del registro porta gli agenti provenienti da piattaforme di agenti connessi, come Google Vertex AI e Amazon Bedrock, in Agent 365 tramite la configurazione a livello di piattaforma. L'integrazione SDK è per agenti che costruisci con un SDK o framework di agenti, e ti dà controllo a livello di codice. Vedi Confronta i meccanismi di integrazione dell'Agent 365.
Il mio agente gestisce fuori Azure. Posso ancora usare l'SDK?
Yes. L'SDK non cambia dove esegue il tuo agente. Funziona con agenti ospitati su Azure, AWS, Google Cloud o on-premises. Vedi ciclo di vita dello sviluppo dell'agente 365.
Capacità
Devo adottare tutte e quattro le capacità?
No, ma hanno dei prerequisiti. Un blueprint dell'identità dell'agente sostiene le capacità di identità, strumenti e notifiche, e le notifiche richiedono inoltre l'account utente dell'agente, disponibile solo per i tenant che partecipano al programma di anteprima Frontier. L'osservabilità funziona anche con una registrazione standard dell'app Microsoft Entra. Oltre a questo, aggiungi capacità in qualsiasi ordine. Vedi Verifica notifiche.
Con quale capacità dovrei iniziare?
Identità. La registrazione è ciò che rende visibile l'agente nell'Agente 365, quindi inizia da lì. Aggiungi l'osservabilità dopo, quando hai bisogno di visibilità operativa. Vedi Registra l'agente e lo strumento per l'osservabilità.
Dove va la mia telemetria?
Gli Agent span compaiono in Microsoft Defender, Microsoft Purview e nel interfaccia di amministrazione di Microsoft 365.
Due cose possono far sembrare la telemetria scomparsa, anche se l'ingestione restituisce HTTP 200.
Se nessun utente nel tenant ha assegnata una licenza Microsoft 365 E7 o Microsoft Agent 365, l'intera richiesta viene ritirata.
Se la run non ha una campata valida invoke_agent alla radice, le campate sono comunque interrogabili nella caccia avanzata di Defender ma non appaiono in nessuna delle tre superfici.
Vedi dove compaiono i tuoi dati e i limiti e le condizioni di caduta.
Che cos'è L'IQ aziendale?
Work IQ è l'insieme di server MCP governati che espongono carichi di lavoro Microsoft 365, come Mail, Calendar, Word, SharePoint e Teams, al tuo agente sotto controllo amministrativo. Work IQ MCP è in anteprima e richiede una licenza Microsoft 365 Copilot. Vedi Verifica degli strumenti.
Quali sorgenti di notifica sono supportate?
Teams, Outlook, commenti Word e email. Le notifiche richiedono l'account utente di un agente, disponibile solo per gli inquilini che partecipano al programma di anteprima Frontier. Vedi Tipi di notifiche e Verifica notifiche.
Identità
Il mio agente ha bisogno di una propria identità?
Ogni integrazione con Agent 365 ha bisogno di un modello di identità, ma questo non significa sempre dare all'agente un proprio account utente. L'agente può usare S2S come identità di agente, OBO per agire per conto di un utente connesso, o Agentic-User agire tramite il proprio account utente Microsoft Entra. Scegli la modalità che corrisponde al lavoro dell'agente, ai permessi e alle risorse Microsoft 365 richieste. Vedi Identità dell'agente.
Qual è la differenza tra un blueprint di identità di agente e un'identità di agente?
Il blueprint è il template riutilizzabile che contiene le credenziali e i permessi dichiarati per un tipo di agente. L'identità di un agente è l'account con cui un singolo agente si autentica. Un solo progetto può creare molte identità di agenti. Vedi oggetti identità e S2S, identità dell'agente derivato dal Blueprint.
Dove sono conservate le credenziali del mio agente?
Sul progetto, non sull'identità dell'agente. Poiché un blueprint compromesso influisce su ogni agente creato da esso, considera il numero di blueprint come una decisione di confine di sicurezza. Vedi Identità dell'agente.
Quanti progetti dovrei creare?
Quanti ne hai bisogno per mantenere separati i confini tra credenziali e permessi. Identità solo di agente di gruppo che possono condividere in sicurezza le credenziali del blueprint e i permessi ereditati. Vedi La fondazione dell'identità e S2S, identità dell'agente derivata dal Blueprint.
Quale modello di autorizzazione è necessario usare?
Permessi applicativi per il lavoro service-to-service, dove l'agente agisce con i propri permessi. Permessi delegati per il lavoro a nome del lavoro, dove l'agente agisce con i permessi e il contesto di un utente connesso. Vedi Identità dell'agente.
Il mio agente ha bisogno di una licenza Microsoft 365?
Solo se ha l'account utente di un agente e ha bisogno di servizi come Teams, Exchange o SharePoint. Gli agenti con un proprio account utente sono disponibili solo per gli inquilini nel programma di anteprima Frontier. La licenza a livello di tenant si applica ancora ad altre funzionalità: la telemetria viene eliminata a meno che almeno un utente nel tenant non abbia assegnata una licenza Microsoft 365 E7 o Microsoft Agent 365, e Work IQ MCP richiede una licenza Microsoft 365 Copilot. Vedi account utente dell'agente, Verifica identità, Verifica l'osservabilità e Verifica gli strumenti.
Perché la cassetta della posta del mio agente non è ancora disponibile?
La provisioning delle risorse può rallentare l'assegnazione delle licenze. Consulta la checklist di validazione SDK dell'Agent 365 per i tempi previsti.
Cos'è uno sponsor?
Il rappresentante aziendale responsabile dello scopo e del ciclo di vita dell'agente. Per ogni identità agente e progetto di identità agente è necessario almeno uno sponsor. Le squadre di sicurezza utilizzano lo sponsor per raggiungere una persona responsabile durante un incidente. Vedi Sponsor e Verifica l'identità.
Configurazione e abilità
Cosa sono le Abilità Agent 365?
Un modo per far eseguire i passaggi di integrazione per te da un assistente di programmazione, come GitHub Copilot CLI. Vedi Competenze dell'Agente 365.
Cosa ha sostituito il flusso di lavoro di configurazione instructions.md?
Agent 365 Skills ha sostituito quel flusso di lavoro. Usa invece le Abilità.
Se il tuo assistente di codifica espone la capacità interna di Validate & Diagnose, puoi chiedergli di validare l'integrazione con Agent 365; È anche chiamato a365-code-validatorinternamente .
La disponibilità dipende dall'assistente e dal pacchetto Skills installato. Vedi Competenze dell'Agente 365.
Devo usare le Abilità?
No. Puoi eseguire ogni passaggio manualmente. Le competenze si adattano a configurazioni standard e onboarding ripetibile; La configurazione manuale è adatta a ambienti non standard e alla risoluzione dei problemi. Vedi quando usare le abilità.
È sicuro eseguire un'abilità più di una volta?
Yes. Le abilità sono additive e idempotenti, quindi i passaggi completati vengono saltati invece che duplicati. Vedi Sicurezza e ripetibilità.
Un'abilità sembrava saltare un passo. È un problema?
Di solito no. Le competenze saltano lavori già configurati. Riprova a eseguire l'abilità specifica e dichiara esplicitamente l'esito se vuoi confermare. Vedi Sicurezza e ripetibilità.
Posso testare prima di distribuire sul cloud?
Sul percorso del compagno IA, sì.
La test-local competenza gestisce il tuo agente insieme a Agents Playground, un'imbracatura locale di prova, per i test del fumo.
Agents Playground si collega tramite l'endpoint di messaggistica agente, quindi non si applica agli agenti standard.
Vedi Le sette abilità e l'agente di prova in Agents Playground.
Validation
Come posso confermare che l'integrazione abbia funzionato?
Il mio agente si comporta diversamente dopo l'integrazione. Cosa è andato storto?
L'SDK estende il tuo agente invece di sostituirne una parte. Indagare su eventuali cambiamenti di comportamento prima di distribuire: codice generato, conflitti di dipendenze, configurazione e compatibilità con gli SDK sono tutte cause possibili. Inizia con Verifica il comportamento esistente.