Checklist per la validazione dell'SDK dell'Agente 365

Usa questa checklist per la validazione dell'Agent 365 SDK dopo aver integrato un agente e prima di implementarlo. È l'ultimo passo nel percorso di onboarding: Agent 365 Skills o configurazione manuale applica l'integrazione. Questi controlli ti aiutano a confermare che ogni capacità funziona, così puoi schierarti con sicurezza.

Se il tuo assistente di codifica espone la capacità interna di Validation & Diagnose dell'Agent 365, nota anche come a365-code-validator, puoi chiedergli di validare questa integrazione con Agent 365 per un preflight a livello di codice. Verifica il progetto per eventuali lacune nella strumentazione, negli artefatti Microsoft Entra, nella messaggistica, nell'accesso agli strumenti e nelle relative configurazioni. Disponibilità e invocazione dipendono dall'assistente e dal pacchetto Skills. Usa la checklist per confermare i risultati nel tuo ambiente target. Il validatore non sostituisce i test end-to-end o la revisione della piattaforma.

Le sezioni delle capacità sono indipendenti, quindi evita qualsiasi funzionalità non adottata. Le sezioni comportamento, configurazione e distribuzione si applicano a ogni integrazione.

Segui questa checklist se:

  • Ho integrato un agente e voglio confermare l'integrazione prima del dispiegamento.
  • Aggiungeva una capacità a un agente che avevi già integrato.
  • Ho ereditato un agente da un altro team e devo stabilire cosa è configurato.

Verifica il comportamento esistente

L'SDK estende il tuo agente, quindi l'integrazione non dovrebbe cambiare il funzionamento già dell'agente.

  • L'agente inizia senza nuovi errori.
  • L'agente risponde a una richiesta normale come faceva prima dell'integrazione.
  • Le chiamate dei modelli, l'orchestrazione e l'esecuzione degli strumenti si comportano come prima.

Note

Se il comportamento del core è cambiato, indagare prima di distribuire. Codice generato, conflitti di dipendenze, configurazione e compatibilità con gli SDK sono tutte cause possibili. Vedere Risoluzione dei problemi.

Verificare l'identità

  • Il blueprint dell'identità dell'agente è registrato su Microsoft Entra.
  • Esiste un'identità di agente, creata da quel progetto. L'abilità make-a365-agent lo crea sul percorso standard dell'agente e make-ai-teammate sul percorso dei compagni di squadra IA; vedi Avvio Rapido: Collega un agente esistente all'Agente 365.
  • Almeno uno sponsor viene assegnato.
  • Se l'agente richiede un account utente, quell'account esiste ed è collegato all'identità dell'agente.
  • Se l'agente ha un account utente, vengono assegnate le licenze richieste e vengono fornite risorse dipendenti come una casella di posta.
  • I permessi API e gli scope Microsoft Graph sono concessi e definiti correttamente.
  • L'agente autentica e agisce sotto l'identità prevista.

Importante

Gli agenti con un proprio account utente sono disponibili solo per gli inquilini che partecipano al programma di anteprima Frontier. Salta i controlli dell'account utente se il tuo tenant non è iscritto.

Note

Dopo aver assegnato le licenze, la provisioning delle risorse per un account utente di solito si completa entro 10-15 minuti, ma può richiedere fino a 24 ore.

Verifica l'osservabilità

  • Almeno un utente nel tenant ha assegnata una licenza Microsoft 365 E7 o Microsoft Agent 365. Senza questa licenza, la telemetria viene eliminata anche se l'ingestione restituisce HTTP 200.
  • I pacchetti di osservabilità sono installati e configurati.
  • Una richiesta di test produce intervalli per l'invocazione dell'agente, l'esecuzione degli strumenti e l'inferenza.
  • La pista ha una campata valida invoke_agent alla radice. Senza uno, le campate restano interrogabili nella caccia avanzata di Defender ma non raggiungono le tre superfici.
  • La telemetria appare in Microsoft Defender, Microsoft Purview e nel interfaccia di amministrazione di Microsoft 365.
  • Gli attributi Span corrispondono alle operazioni che ti aspetti.

Verifica degli strumenti

Completa questa sezione se l'agente invoca server Model Context Protocol (MCP).

  • Una licenza Microsoft 365 Copilot è disponibile nel tenant. Work IQ MCP è in anteprima e ne richiede uno.
  • L'agente scopre i server MCP a cui dovrebbe avere accesso.
  • Un'invocazione di uno strumento di test ha successo da un capo all'altro.
  • L'esecuzione dell'agente rileva un guasto dello strumento, restituisce un errore controllato e rimane disponibile.

Verifica le notifiche

Completa questa sezione se l'agente riceve notifiche.

  • L'agente riceve notifiche dalle fonti configurate, come Teams, Outlook, commenti Word o email.
  • L'agente risponde a una notifica di test come previsto.

Importante

Le notifiche richiedono l'account utente di un agente, disponibile solo per gli inquilini che partecipano al programma di anteprima Frontier. Salta questa sezione se il tuo inquilino non è iscritto.

Verificare la configurazione

  • Conserva credenziali e segreti in modo sicuro e non comprometterli sotto il controllo del fonte.
  • Separati le impostazioni di sviluppo, test e produzione.
  • Assicurati che l'integrazione funzioni anche nel tuo host di destinazione.

Confermare la prontezza al dispiegamento

  • Tutti i controlli pertinenti superano.
  • Esegui almeno un test end-to-end in un ambiente non produttivo.
  • Controlla la telemetria dopo il dispiegamento per confermare la salute dell'agente.

Risoluzione dei controlli falliti

Esegui di nuovo il passaggio di configurazione pertinente, oppure chiedi al tuo assistente di programmazione di completare la capacità specifica.

Per i sintomi comuni e le loro risoluzioni, vedi Risoluzione dei problemi. Per sintomi specifici della configurazione basata sulle competenze, consulta la tabella di risoluzione dei problemi in Quickstart: Collega un agente esistente all'Agente 365.

Per risposte a domande correlate, consulta le domande frequenti dell'Agent 365 SDK.

Contenuti correlati

  • Last updated on