Avvio rapido: collega un agente esistente all'Agente 365

In questo quickstart, colleghi un agente esistente all'Agent 365 utilizzando le Competenze dell'Agente 365 nel tuo assistente di programmazione. Il percorso inizia registrando l'agente, poi aggiunge le capacità che scegli e termina con la validazione. Se costruisci un compagno di squadra IA, che richiede il programma di anteprima Frontier, puoi anche testarlo localmente.

Ogni passaggio nomina l'abilità che lo gestisce e mostra una richiesta di esempio. Invochi un'abilità dichiarando il risultato, non digitando il nome dell'abilità.

Prerequisiti

  • Un agente esistente in esecuzione su uno stack supportato: Python, Node.js o .NET.
  • Un tenant Microsoft con Agent 365 abilitato. Accedi come Amministratore Globale, o come Sviluppatore ID Agente, con un Amministratore Globale disponibile per completare le concessioni dei permessi OAuth.
  • Un abbonamento Azure con permesso per creare risorse.
  • Un assistente di codifica supportato: Claude Code, GitHub Copilot CLI o modalità agente VS Code.
  • La CLI di GitHub (gh), usata per installare le competenze.

Note

La configurazione dell'Agent 365 utilizza l'applicazione enterprise Agent 365 CLI gestita da Microsoft quando è disponibile nel tuo tenant. Non è necessario creare un'app client personalizzata per questo percorso. Se l'applicazione enterprise non è disponibile, la configurazione torna a un'app di proprietà del tenant chiamata Agent 365 CLI. Un'app client personalizzata esplicitamente configurata rimane supportata. Per maggiori informazioni, consulta Registrazione personalizzata dell'app client per Agent 365 CLI.

La licenza dipende dalle capacità che adotti:

  • Identità. Nessuna licenza aggiuntiva. Il tenant deve avere abilitato l'Agent 365.
  • Osservabilità. Almeno un utente nel tenant con una licenza Microsoft 365 E7 o Microsoft Agent 365 assegnata. Senza di essa, la telemetria viene eliminata silenziosamente.
  • Utensili (QI di lavoro). Una licenza Microsoft 365 Copilot. Work IQ MCP è in anteprima.
  • Notifiche. Un account utente di un agente, disponibile solo per gli inquilini nel programma di anteprima Frontier.

Tip

Prima verifica che l'SDK sia il meccanismo di integrazione giusto per il tuo agente. Vedi Scegli l'opzione di integrazione. Per il modello di identità alla base della registrazione, inclusi progetti, permessi e consenso, vedi i concetti chiave di identità dell'agente e Microsoft Entra Agent ID.

Installa le competenze

Installa le competenze nel tuo assistente di programmazione:

gh skill add microsoft/agent365-skills

Lo stesso comando funziona per Claude Code, GitHub Copilot CLI e modalità agente VS Code. Riavvia il tuo assistente dopo così che acquisisca le nuove competenze.

Configurare e rilevare il progetto

Apri il tuo progetto agente nel tuo assistente di programmazione, poi esegui:

Abilità: a365-setup

impostare questo progetto per l'Agente 365

Rispondi alle domande sul tuo agente. Quando la skill termina, convalida i tuoi prerequisiti e rileva il tuo stack.

Setup salva gli ID generati e gli endpoint su a365.generated.config.json. La configurazione standard degli agenti non richiede un file di configurazione scritto a mano; la configurazione del teammate AI richiede un a365.config.json creato manualmente.

a365-setup Poi ti indirizza su uno di due percorsi di provisioning. Completa quella selezionata, poi continua con i passaggi condivisi che seguono:

Entrambi i percorsi convergono quindi in Strumento di osservabilità.

Registrare l'agente

Completa questo passaggio se a365-setup ti ha indirizzato al percorso standard dell'agente.

Abilità: make-a365-agent

registra questo agente con l'Agente 365

Quando la competenza termina, il tuo agente ha un blueprint registrato in Microsoft Entra, un'identità di agente creata da essa e i permessi necessari. La registrazione fornisce visibilità al catalogo; il passaggio di osservabilità aggiunge telemetria.

Aggiungi messaggi e notifiche

Completa questo passaggio se a365-setup ti indirizza verso il percorso dei compagni IA.

Abilità: make-ai-teammate

Aggiungi messaggi e notifiche a questo agente

La skill aggiunge il livello di hosting e il routing dei messaggi, e registra l'agente. Le persone possono poi raggiungerlo tramite Teams, Outlook, commenti Word e email.

Importante

Questo passaggio dà al tuo agente un account utente proprio, inclusa una casella di posta e presenza su Teams. Questa funzionalità è disponibile solo per gli inquilini che partecipano al programma di anteprima Frontier. Salta questo passaggio se il tuo inquilino non è iscritto.

Strumento per l'osservabilità

Completa questo passaggio su entrambi i percorsi. La competenza chiede che tipo di agente hai.

Abilità: instrument-observability

Aggiungere osservabilità a questo agente

Quando richiesto, scegli la modalità di autenticazione utilizzata dal tuo agente: OBO (per conto di un utente loginato), Agentic-User (l'account utente dell'agente, che richiede il programma di anteprima Frontier) o S2S (service-to-service, per operazioni in background). L'esportatore usa la stessa modalità con cui il tuo agente si autentica, quindi scegli quella che corrisponde al tuo modello di autorizzazione. Vedi Identità dell'agente.

Dopo un’esecuzione di test, gli span del tuo agente vengono visualizzati in Microsoft Defender, Microsoft Purview e in interfaccia di amministrazione di Microsoft 365.

Importante

Due cose possono far sembrare la telemetria scomparsa, anche se la richiesta restituisce HTTP 200. Se nessun utente nel tenant ha assegnata una licenza Microsoft 365 E7 o Microsoft Agent 365, l'intera richiesta viene ritirata; la presenza dello SKU non è sufficiente. Se l'esecuzione non ha uno span invoke_agent valido a livello radice, gli span restano interrogabili in Ricerca avanzata di Defender ma non compaiono in nessuna delle tre interfacce. Lo span radice è lo span di livello superiore che l'SDK emette per una singola invocazione di agente; ogni chiamata a uno strumento e ogni evento di inferenza è annidato al suo interno.

Connetti i dati di Microsoft 365

Completa questo passaggio su uno dei due percorsi se il tuo agente legge o agisce sui dati di Microsoft 365. Gli strumenti di Work IQ richiedono un modello di permessi delegati, quindi questo passaggio viene saltato automaticamente se scegli S2S nel passaggio di osservabilità.

Abilità: add-workiq-tools

collega Work IQ Mail and Calendar

Nomina i carichi di lavoro di cui hai bisogno, come Mail, Calendar o Word. La competenza collega i server MCP corrispondenti di Work IQ, e il tuo agente può quindi accedere a quei dati sotto il controllo amministrativo.

Importante

Work IQ MCP è in anteprima e richiede una licenza Microsoft 365 Copilot. Un Amministratore Globale deve concedere all'OAuth i permessi per i server Work IQ prima che il tuo agente possa chiamarli. Vedi Aggiungi e gestisci strumenti.

Aggiungi la prevenzione della perdita di dati

Completa questo passaggio opzionale se il tuo agente ha bisogno di Microsoft Purview data loss prevention (DLP). La competenza supporta l'autenticazione delegata agentica e Node.js S2S con autenticazione FMI segreta dal cliente.

Abilità: purview-dlp-integration

aggiungi Purview DLP a questo agente

La funzionalità aggiunge controlli Microsoft Graph processContent per bloccare i prompt prima che raggiungano l'LLM quando corrisponde un criterio di blocco dell'input, e guida nella configurazione delle autorizzazioni e dei criteri DLP. La risposta opzionale controlla le risposte ma non filtra l'output sensibile. Per impostazione predefinita, errori e timeout interrompono il turno, compreso il mancato invio di una risposta se il relativo audit non viene superato.

Importante

Questo passaggio richiede che Purview DLP per l'IA sia abilitato nel tuo tenant, incluse le licenze, la fatturazione con pagamento in base al consumo e l'onboarding di DSPM per l'IA. Per .NET, verifica il meccanismo di protezione di tipo best-effort rispetto alla versione dell'SDK in uso.

Testare localmente

Completa questo passaggio se sei nel percorso AI teammate, che richiede il programma di anteprima Frontier. Agents Playground si collega tramite l'endpoint di messaggistica dell'agente, pertanto non si applica agli agenti standard.

Abilità: test-local

Testa questo agente localmente

Il tuo agente compete con Agents Playground, un'imbracatura locale di test, così puoi testarlo prima di essere schierato.

Convalida il risultato

Il tuo agente dovrebbe iniziare e rispondere come ha fatto prima dell'onboarding, e apparire nell'Agente 365 con la sua identità registrata.

Se il tuo assistente di codifica espone la capacità interna di Validation & Diagnose dell'Agent 365, chiedigli di validare questa integrazione con Agent 365 per eseguire il preflight a livello di codice sul progetto. Controlla eventuali lacune nella strumentazione, negli artefatti Microsoft Entra, nella messaggistica, nell'accesso agli strumenti e nelle configurazioni correlate. La funzionalità è anche indicata internamente come a365-code-validator; la disponibilità e l'instradamento esatto dipendono dall'assistente di codifica e dal pacchetto Skills installato.

Prima di distribuire, segui la checklist di validazione dell'SDK dell'Agent 365.

Troubleshoot

Usa la tabella seguente per identificare e risolvere i problemi comuni quando metti in contatto il tuo agente con Agent 365.

Sintomo Resolution
L'assistente di programmazione descrive i comandi ma non li esegue Usa una modalità che abbia accesso al terminale. In VS Code, usa la modalità agente. Le modalità Ask e Edit non possono eseguire comandi terminali.
Il programma di installazione segnala prerequisiti di Azure mancanti Completa i prerequisiti elencati a365-setup , poi riprova l'abilità.
La registrazione del blueprint fallisce, oppure i comandi CLI restituiscono errori di autorizzazione Assicurati di aver effettuato l'accesso con un account che disponga delle autorizzazioni per registrare i modelli di identità dell'agente nel tenant.
Non appare alcuna telemetria Conferma che almeno un utente nel tenant abbia una licenza Microsoft 365 E7 o Microsoft Agent 365 assegnata, quindi conferma che l'esecuzione generi uno span invoke_agent valido alla radice, quindi conferma che la modalità di autenticazione selezionata corrisponda all'ambiente in uso. Chiedi al tuo assistente di codifica di validare l'integrazione con Agent 365; L'abilità di validatore installata può diagnosticare la strumentazione.
Un passaggio sembra essere stato saltato Le abilità tengono conto dello stato e saltano le operazioni già configurate, quindi questo passaggio è probabilmente già completato. Esegui di nuovo l'abilità specifica e dichiara esplicitamente il risultato.
I valori di configurazione devono cambiare dopo la configurazione Se la tua configurazione usa a365.config.json, modifica e riavvia a365 config init -c ./a365.config.json, poi esegue di nuovo l'abilità corrispondente.

Contenuti correlati

  • Last updated on