Competenze di Agent 365 per la configurazione guidata dell'agente

Le Skills di Agent 365 offrono un percorso di configurazione guidata per connettere un agente esistente ad Agent 365 da un assistente di programmazione supportato. Dichiari il risultato che desideri, ad esempio aggiungere osservabilità a questo agente, e la competenza identifica il progetto, raccoglie i valori richiesti, apporta le modifiche di integrazione e verifica il risultato.

Le skill funzionano in tutti gli agenti di coding, inclusi Claude Code, GitHub Copilot CLI e la modalità agente di VS Code.

Per installare le competenze e seguire il percorso di onboarding per il tuo agente, consulta Quickstart: Collega un agente esistente all'Agente 365.

Note

Le competenze sostituiscono il precedente flusso di lavoro di configurazione che utilizzava un instructions.md file.

Quando usare le Abilità

Collegare un agente esistente all'identità aziendale, all'osservabilità, agli strumenti governati e alle notifiche richiede diversi passaggi ordinati di configurazione. Questi passaggi includono l'installazione della CLI di Agent 365, la validazione dei prerequisiti di Azure, la registrazione di un blueprint, la configurazione delle risorse Entra, il cablaggio degli esportatori OpenTelemetry, la connessione dei server Model Context Protocol (MCP) e i test locali.

Le competenze eseguono quei passaggi nell'ordine richiesto per il percorso selezionato e convalidano il progetto risultante.

Come funziona un'abilità

Ogni abilità segue lo stesso flusso di lavoro:

  1. Dichiara il risultato che desideri.
  2. Lascia che la competenza identifichi lo stack di progetto e la configurazione esistente.
  3. Fornisci i valori richiesti, come la modalità di autenticazione.
  4. Rivedi il codice, i manifesti e le modifiche alla configurazione che effettua.
  5. Conferma che il progetto sia ancora in fase di sviluppo e che l'integrazione funzioni.

Competenze Agent 365 disponibili

a365-setup è il punto d'ingresso. Dopo aver validato i prerequisiti, ti indirizza su uno di due percorsi, e segui solo quel percorso:

  • Agente standard. a365-setup delega a make-a365-agent. Usa questo percorso quando l'agente non ha bisogno di un proprio account utente. Un agente standard si autentica con OBO o S2S, così può agire per un utente autenticato o funzionare senza un utente autenticato.
  • Compagno di team IA. a365-setup delega a make-ai-teammate, per un agente che ha bisogno del proprio account utente. Un compagno di squadra IA si autentica come quell'account utente (Agentic-User). Questo percorso richiede il programma di anteprima Frontier.

Per scegliere un percorso e una modalità di autenticazione, vedi Tipi di Agente e modalità di autenticazione.

Competenza Purpose
a365-setup Installa la CLI dell'Agent 365, valida i prerequisiti di Azure e rileva lo stack degli agenti. Per un agente standard, chiede se l'agente si autentica con OBO o S2S. Poi delega a make-a365-agent o make-ai-teammate.
make-a365-agent Fornisce un agente standard che non ha bisogno di un proprio account utente. Registra il blueprint dell'identità dell'agente in Microsoft Entra, crea un'identità di agente da esso e configura i permessi Entra ID di cui l'agente ha bisogno: permessi delegati per OBO o permessi applicativi per S2S. Poi offre osservabilità e strumenti come componenti aggiuntivi.
make-ai-teammate Trasforma un agente in un compagno IA con un proprio account utente. Registra il blueprint dell'identità dell'agente e crea un'identità dell'agente da esso, poi aggiunge il livello di hosting, l'instradamento dei messaggi e le notifiche. Richiede che a365-setup sia stato eseguito prima.
instrument-observability Integra OpenTelemetry e l'esportatore di tracce di Agent 365 in modo che gli span dell'agente raggiungano Microsoft Defender, Microsoft Purview e il interfaccia di amministrazione di Microsoft 365. Supporta OBO, S2S e Agentic-User. Chiede il tipo agente e la modalità di autenticazione se a365-setup non li ha già registrati.
a365-code-validator Valida e diagnostica un'integrazione Agent 365 esistente, inclusi strumentazione, artefatti Microsoft Entra, messaggistica, accesso agli strumenti e configurazione correlata. Sola lettura per impostazione predefinita. Usa instrument-observability per aggiungere osservabilità da zero.
add-workiq-tools Collega i server MCP di Work IQ, inclusi Mail, Calendar e Word, così l'agente può leggere e agire sui dati Microsoft 365. Richiede un modello di permessi delegati ed è saltato automaticamente quando la modalità di autenticazione è S2S.
purview-dlp-integration Aggiunge controlli di prevenzione della perdita di dati Microsoft Purview (DLP) prima delle chiamate LLM dell'agente utilizzando Microsoft GraphprocessContent, con audit di risposta opzionale. Guida la configurazione delle autorizzazioni di Microsoft Graph e dei criteri DLP.
test-local Esegue localmente un agente compagno IA e apre Agents Playground per eseguire test interattivi, senza richiedere una distribuzione nel cloud. Si applica al percorso dei compagni di squadra IA.

Importante

make-ai-teammate dà al tuo agente un account utente proprio, inclusa una casella postale e presenza su Teams. Questa funzionalità è disponibile solo per gli inquilini che partecipano al programma di anteprima Frontier.

Di solito invochi un'abilità dichiarando il risultato invece di dare un nome. Ad esempio, aggiungi l'osservabilità a questo agente esegue instrument-observability. Se il tuo assistente di codifica espone la capacità interna a365-code-validator , chiedigli di validare questa integrazione con Agent 365; la capacità è anche descritta internamente come Validate & Diagnose. Disponibilità e invocazione dipendono dall'assistente e dal pacchetto Skills installato. Per la formulazione della richiesta utilizzata in ogni fase, vedi Quickstart: Collega un agente esistente all'Agente 365.

Tipi di agente e modalità di autenticazione

Le Skill configurano sia agenti standard che collaboratori IA. Il percorso determina quali modalità di autenticazione sono disponibili per l'agente. La modalità di autenticazione, chiamata modalità di esecuzione in Identità agente, determina con quale identità opera l'agente quando chiama servizi a valle come Microsoft Graph e server MCP.

Modalità di autenticazione Path L'agente funge da Usarlo quando
OBO (a nome di) Agente standard L'utente loggato, con permessi delegati L'agente lavora nel contesto dell'utente, ad esempio leggendo il calendario di quell'utente o inviando email per lui.
S2S (da servizio a servizio) Agente standard Una propria identità di agente, con autorizzazioni dell'applicazione L'agente viene eseguito senza un utente connesso, ad esempio per compiti programmati, monitoraggio o elaborazione in background.
Agentic-User Compagno di squadra di intelligenza artificiale Il proprio account utente L'operatore ha bisogno di una propria casella di posta, presenza Teams o altre esperienze Microsoft 365 basate sull'utente. Richiede il programma di anteprima Frontier.

Per un agente standard, a365-setup chiede se l'agente usa OBO o S2S, e le abilità successive riutilizzano la tua risposta. Un compagno IA usa sempre Agentic-User, quindi a365-setup non chiede. In Skills viene configurata una modalità per ogni agente. Se l'agente ha bisogno sia di permessi delegati che di autorizzazioni applicative, esegui a365 setup all --authmode both con Agent 365 CLI. Per i ruoli richiesti da ciascuna modalità, vedi Autorizzazioni dell’identità dell’agente.

La modalità di autenticazione determina come vengono configurate le competenze:

  • make-a365-agent viene eseguito con --authmode obo o --authmode s2s. OBO concede i permessi delegati all'identità dell'agente e S2S assegna i permessi di applicazione a essa.
  • instrument-observability esporta la telemetria sulla rotta S2S con un token solo app in ogni modalità, così un'istanza di agente registrato non ha bisogno di un permesso di osservabilità o del consenso dell'amministratore. Per OBO e Agentic-User, la skill configura l'agente per ottenere quel token riutilizzando le credenziali blueprint dalla connessione di hosting. Per S2S, viene aggiunto un servizio token che acquisisce e aggiorna il token per gli agenti .NET, Node.js e Python. Vedi Agent 365-abilitato usando S2S.
  • add-workiq-tools richiede un token utente delegato, quindi funziona con OBO e Agentic-User ma non con S2S. Se scegli S2S, a365-setup rimuove il Work IQ dalle capacità selezionate.
  • purview-dlp-integration supporta l'autenticazione delegata agentica. Per S2S, supporta solo agenti Node.js che utilizzano l'autenticazione Federated Managed Identity (FMI) con client secret.
  • test-local vale solo per i compagni di squadra controllati dall'IA.

Stack supportati

Le competenze rilevano automaticamente lo stack di progetti, quindi non devi mappare manualmente il progetto. Questi sono gli stack che le Abilità rilevano. L'SDK funziona anche con altri framework.

Language Frameworks
.NET Microsoft Agent Framework, Kernel semantico, Azure AI Foundry
Node.js LangChain, OpenAI Agents SDK, Claude Agent SDK, Kernel semantico, Google ADK
Python Microsoft Agent Framework, LangChain, OpenAI Agents SDK, Claude Agent SDK, Kernel semantico, Google ADK

Sicurezza e ripetibilità

Le competenze sono progettate per applicare modifiche alla configurazione senza alterare il comportamento esistente del tuo progetto. Conferma questo comportamento con la checklist di validazione SDK dell'Agent 365.

  • Additivo e idempotente. Le competenze non cancellano né ristrutturano il codice esistente, e rieseguire una competenza non duplica il lavoro completato.
  • Consapevole dello stato. Le abilità rilevano ciò che è già configurato, quindi saltano i passaggi già completati invece di ripeterli.
  • Protetto da barriere. Le skill non modificano file esterni al tuo progetto e verificano che la build continui ad andare a buon fine prima di terminare.

Usa le abilità quando:

  • Hai già un agente e vuoi integrarlo senza scrivere l'integrazione a mano.
  • Il tuo flusso di lavoro di sviluppo include già un assistente di programmazione.
  • Vuoi un onboarding coerente e ripetibile tra i progetti.

Usa la configurazione manuale quando:

  • Il tuo ambiente è non standard e ogni passaggio richiede un controllo individuale.
  • La tua organizzazione limita i flussi di lavoro degli assistenti di programmazione.
  • Stai risolvendo un problema e vuoi eseguire personalmente ogni passaggio.

Per il percorso manuale, usa i passaggi di configurazione in Quickstart: collega un agente esistente all'Agent 365 ed esegui i comandi equivalenti della CLI dell'Agent 365 per il tuo ambiente.

Contenuti correlati

  • Ultimo aggiornamento: