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 su uno stack supportato: Python, Node.jso .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.

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.

Impostare 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 dei compagni di squadra AI richiede un file di .a365.config.json

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 proseguono poi allo strumento per l'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 test, gli span del tuo agente appaiono in Microsoft Defender, Microsoft Purview e nel 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 la run non ha una campata valida invoke_agent alla radice, le campate restano interrogabili nella caccia avanzata di Defender ma non compaiono in nessuna delle tre superfici. La rete di apertura è la campatura di livello superiore che l'SDK emette per l'invocazione di un agente; ogni chiamata di strumento e evento di inferenza si annida al suo interno.

Collega i dati 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.

Testare localmente

Completa questo passaggio se sei sulla strada del compagno di squadra IA, che richiede il programma di anteprima Frontier. Agents Playground si collega tramite l'endpoint di messaggistica agente, quindi 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.
Setup report mancanti di prerequisiti Azure Completa i prerequisiti elencati a365-setup , poi riprova l'abilità.
La registrazione del blueprint fallisce, oppure i comandi CLI restituiscono errori di autorizzazione Conferma di essere connesso con un account che ha il permesso di registrare i blueprint di identità dell'agente nel tenant.
Non appare alcuna telemetria Conferma che almeno un utente nel tenant abbia assegnato una licenza Microsoft 365 E7 o Microsoft Agent 365, poi conferma che l'esecuzione emette uno span valido invoke_agent alla radice, quindi conferma che la modalità di autenticazione selezionata corrisponde al tuo ambiente. 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 competenze sono consapevoli dello stato e saltano lavori già programmati, quindi probabilmente il passaggio è 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