Introduzione allo sviluppo di Agent 365

Agent 365 funziona con una gamma di implementazioni dell'agente. Un agente può aiutare gli utenti su richiesta, eseguire in modo autonomo in background o operare con la propria identità utente in Microsoft 365. Comprendere quale modello descrive meglio l'agente è importante perché determina il modello di identità dell'agente, l'accesso che ha alle risorse di Microsoft 365 e quali passaggi del ciclo di vita si applicano.

Tipi di agenti

Prima di iniziare, chiediti: che tipo di agente sto costruendo?

Esistono due tipi di agenti a seconda del tipo di accesso di cui dispongono:

Tipo di agente Sintesi
Agenti Lavorare per conto di un utente con accesso delegato o operare come applicazione con autorizzazioni con ambito. Registrati come applicazioni Microsoft Entra o modelli di identità agente.
Compagno di squadra di intelligenza artificiale Usare la propria identità utente in Microsoft 365, tra cui cassetta postale, stato in Teams e voce nell'elenco contatti. Questo tipo di agente è disponibile solo per i tenant che partecipano al Frontier preview program.

Agenti

Un agente funziona per conto di un utente. Risponde alle richieste, esegue attività in background, si connette alle API, elabora i dati e determina le azioni.

Gli agenti possono avere qualsiasi forma. Alcuni sono conversazionali: un utente chiede qualcosa e l'agente risponde. Alcuni vengono eseguiti tranquillamente in background, attivati da una pianificazione, da un evento o da un messaggio in arrivo, senza che nessuno sia attivamente coinvolto. Alcuni fanno entrambi.

Scenari di esempio:

  • Un utente chiede a un agente di riepilogare i messaggi di posta elettronica non letti e di elaborare le risposte. L'agente esegue il lavoro, accedendo solo alle risorse a cui l'utente può accedere e restituisce il risultato.
  • Un agente del servizio clienti consente a un tecnico di supporto di eseguire query sulle knowledge base interne e comporre risposte durante una sessione di supporto live.
  • Un agente di monitoraggio della conformità viene eseguito ogni notte, analizza i siti di SharePoint ai quali all'agente viene concesso l'accesso per identificare le violazioni delle policy e presenta report di audit, senza la supervisione di nessuno.
  • Un agente di elaborazione degli ordini preleva nuovi ordini di vendita da una coda, aggiorna un CRM e invia messaggi di posta elettronica di conferma- tutto senza che nessuno lo inizi.

Fondamento dell'identità:

Tradizionalmente, si registrano gli agenti come applicazioni di Microsoft Entra. Questo approccio continua a funzionare. In futuro, è anche possibile creare agenti su un Microsoft Entra Agent ID tramite un modello di identità agent identity blueprint - una definizione approvata dall’IT e applicata dalla governance delle capacità di un agente, degli strumenti consentiti e dei vincoli di conformità. La costruzione su un progetto predefinito è il percorso consigliato per i nuovi agenti. Sblocca l'accesso allo strumento Work IQ regolamentato, a Microsoft Purview per la protezione dei dati, al monitoraggio delle minacce di Microsoft Defender e alla governance di Entra ID, rendendo l'agente un'identità aziendale completamente regolamentata dal primo giorno.

Compagno di squadra di intelligenza artificiale

Important

Per ottenere l'accesso anticipato a questo tipo di agente, è necessario far parte del programma di anteprima Di frontiera. Frontier consente di connettersi direttamente alle ultime innovazioni di intelligenza artificiale di Microsoft. Le anteprime Frontier sono soggette ai termini di anteprima esistenti dei tuoi accordi con il cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità potrebbero cambiare nel tempo.

Un collega di intelligenza artificiale opera in Microsoft 365 usando la propria identità agente. È possibile effettuarne il provisioning con funzionalità quali l'invio e la ricezione di messaggi di posta elettronica tramite la propria cassetta postale, la partecipazione alle conversazioni di Teams 1:1 e di gruppo e la visualizzazione nei metadati della directory e dell'organizzazione con una relazione di gestione assegnata. Gli utenti possono interagire con esso tramite punti di ingresso Microsoft 365 familiari, ad esempio @mentions, posta elettronica, inviti al calendario e chat di Teams.

Creare questi agenti da un progetto agente, che è la definizione approvata dall'IT e applicata alla governance delle funzionalità dell'agente, degli strumenti consentiti e dei vincoli di conformità. Ogni istanza dell'agente eredita il modello di identità, le autorizzazioni e i criteri dal progetto di identità dell'agente padre.

Ciò che fa l'agente, indipendentemente dal fatto che si tratti di conversazioni, background o entrambi, dipende dalla modalità di progettazione. Alcuni agenti sono altamente interattivi, rispondono ai messaggi e supportano il lavoro in tempo reale. Altre elaborano le attività in background, che agiscono su messaggi di posta elettronica o eventi senza coinvolgimento diretto degli utenti. L'agente opera con la propria identità utente e le relative azioni sono regolate e controllabili tramite tale identità.

Se hai già un agente, non devi ricominciare. Gli agenti esistenti possono essere estesi per operare con la propria identità aggiungendo la configurazione dell'identità e del progetto descritta più avanti in questa guida.

Scenari di esempio:

  • Aggiungere un assistente AI per l'onboarding HR nel canale Teams per l'onboarding di un nuovo dipendente. Invia messaggi di posta elettronica di benvenuto dalla propria cassetta postale, pianifica riunioni di orientamento nel proprio calendario e risponde alle domande usando le funzionalità configurate per l'istanza dell'agente.
  • Assegnare una relazione manageriale nei metadati della directory a un collega AI nell'approvvigionamento. I dipendenti inviano richieste di acquisto alla cassetta postale. L'agente elabora la richiesta, esegue query sui sistemi ERP e finanziari utilizzando l'accesso regolamentato al proprio strumento Work IQ e risponde con l'approvazione o l'escalation con la propria identità.
  • Aggiungere un compagno di squadra IA per la ricerca al sito di SharePoint di un team di progetto e al canale Teams. Può visualizzare documenti pertinenti durante le riunioni, rispondere nei thread di conversazione e creare report sullo stato settimanale usando le autorizzazioni e gli strumenti configurati per tale agente.

Fondamento dell'identità:

Basato su un progetto di identità agente, che crea un Microsoft Entra Agent ID e un account utente associato: sempre obbligatorio.

Aggiunta incrementale delle funzionalità di Agent 365

L'agente 365 non è tutto o niente. Non è necessario creare un compagno di squadra di intelligenza artificiale dal primo giorno, o del tutto, se lo scenario non lo richiede. Adottare le funzionalità in modo incrementale, a partire da ciò che l'agente necessita ora ed espandersi man mano che i requisiti si evolvono.

Perché creare un progetto di identità dell'agente?

Quando si crea un progetto di identità agente, l'interfaccia della riga di comando di Agent 365 effettua il provisioning di un Microsoft Entra Agent ID per l'agente, ovvero un'identità di prima classe nel tenant, soggetta agli stessi criteri di governance aziendale degli utenti umani. Questa singola identità è la base per i vantaggi di sicurezza che vengono trasmessi automaticamente a ogni agente basato su progetto:

Benefit Cosa implica per il tuo agente
Governance di Microsoft Entra ID Il ciclo di vita dell'identità e dell'accesso dell'agente viene gestito tramite lo stesso Accesso Condizionale, la protezione dell'identità e le revisioni di accesso che si applicano agli utenti umani.
Microsoft Purview Ogni interazione dei dati eseguita dall'agente è soggetta alle etichette di riservatezza del tenant, ai criteri di prevenzione della perdita dei dati e ai criteri di conservazione, senza codice aggiuntivo.
Microsoft Defender Il comportamento dell'agente viene monitorato continuamente per rilevare anomalie e minacce. L'attività sospetta attiva gli stessi avvisi e flussi di lavoro di risposta di qualsiasi utente nel tenant.

Questi vantaggi si applicano a tutti gli agenti basati su progetto, inclusi entrambi gli agenti con accesso delegato dall'utente e gli agenti che operano con la propria identità, non appena viene creato il progetto. Non è necessario configurarli separatamente.

I quattro livelli di disponibilità seguenti rappresentano i livelli che è possibile adottare in modo incrementale. La tabella seguente illustra gli elementi disponibili per Agent 365 in base al punto di partenza:

Capability Agente personalizzato del motore di Microsoft 365 Tutti gli altri agenti 1
Registra 2
Osservabilità
Intelligenza Lavorativa
Compagno di squadra di intelligenza artificiale 3 3

1 Gli agenti attualmente registrati come applicazioni Microsoft Entra devono prima creare un 'agent identity blueprint' per iniziare a utilizzare qualunque funzionalità in quest'ambito.

2 Gli agenti personalizzati di Microsoft 365 sono già registrati utilizzando la registrazione esistente dell'applicazione Microsoft Entra, senza necessità di ulteriore configurazione.

3 compagno AI per agenti del motore personalizzato di Microsoft 365 richiede un progetto di identità dell'agente agent. Disponibile solo per i partecipanti al programma Frontier .

Registro

La registrazione dell'agente lo rende visibile e gestibile nel interfaccia di amministrazione di Microsoft 365. Gli amministratori possono individuarlo e vederlo nell'inventario dell'agente dell'organizzazione.

Cosa si ottiene:

  • L'agente appare nel centro di amministrazione di Microsoft 365; gli amministratori possono trovarlo e vederlo nell'inventario degli agenti dell'organizzazione.
  • Gli agenti basati su blueprint ricevono anche i vantaggi completi di governance Entra ID, Purview e Defender descritti in Perché costruire su un blueprint di identità dell'agente?

Cosa costruisci:

Registrare l'agente utilizzando la registrazione esistente dell'applicazione Microsoft Entra o un modello.

Note

Se gli agenti sono basati su Google Vertex AI o Amazon Bedrock, la registrazione non richiede alcun lavoro di sviluppo, gli agenti vengono estratti automaticamente tramite le API Google e Amazon. Nessuna integrazione dell'SDK, nessun progetto e non sono necessarie modifiche al codice. Dopo la registrazione, è possibile usare Agent 365 SDK per aggiungere l'osservabilità, l'accesso allo strumento IQ di lavoro e altre funzionalità in modo incrementale. Per iniziare, vedi Registrazione degli agenti Google Vertex AI e Amazon Bedrock .

Come compilarlo:

Usare la configurazione guidata dall'intelligenza artificiale e rispondere di conseguenza alle domande sul tipo di agente. La configurazione guidata dall'intelligenza artificiale esegue i passaggi necessari per questo livello. Gli agenti del motore personalizzati di Microsoft 365 sono già individuabili usando la registrazione dell'applicazione esistente di Microsoft Entra.

Observability

Una volta registrato l'agente, l'investimento successivo è l'osservabilità, offrendo ai team IT, ai team di sicurezza e ai propri team di ingegneria visibilità su cosa fa effettivamente il tuo agente. Ogni chiamata di inferenza, chiamata allo strumento e interazione viene acquisita, tracciata e resa controllabile.

L'osservabilità è la base per la fiducia. Senza di esso, gli amministratori non hanno modo di verificare il comportamento, controllare la conformità o diagnosticare i problemi su larga scala. Con esso, l'agente diventa un asset aziendale anziché una scatola nera.

Cosa si ottiene:

  • Tracciamento completo basato su [OpenTelemetry (OTel)](https://opentelemetry.io/docs/specs/otel/protocol/) di ogni interazione dell'agente: input, output, chiamate agli strumenti e ai modelli.
  • Attività visibile nelle interfaccia di amministrazione di Microsoft 365 e nelle superfici di monitoraggio connesse.
  • Audit trail che vengono inseriti in Microsoft Entra, Microsoft Purview e Microsoft Defender, supportando i requisiti di conformità, protezione dei dati e risposta alle minacce.

Cosa costruisci:

Strumentazione con le API di osservabilità di Agent 365 SDK: strumentazione automatica (se si usa OpenAI, LangChain o Agent Framework) o strumentazione manuale per qualsiasi altro stack.

Come compilarlo:

Usare la configurazione guidata dall'intelligenza artificiale e rispondere alle domande di osservabilità di conseguenza. La configurazione guidata dall'intelligenza artificiale esegue i passaggi necessari per questa disponibilità.

IQ lavoro

Dopo aver registrato e reso osservabile l'agente, concedere l'accesso ai dati e alle azioni Microsoft 365 tramite IQ di lavoro. Work IQ è un set regolamentato di strumenti che consente all'agente di lavorare con Posta, Calendario, OneDrive, SharePoint, Teams e altro ancora.

Gli strumenti di Work IQ richiedono il consenso dell'amministratore, vengono controllati e possono essere revocati. L'agente li chiama usando le autorizzazioni definite nel progetto: non sono necessari flussi OAuth aggiuntivi o connettori personalizzati.

Cosa si ottiene:

  • Accesso al catalogo completo degli strumenti di IQ di lavoro- Posta, Calendario, OneDrive, SharePoint, Teams e altro ancora.
  • Autorizzazioni che gli amministratori controllano e adattano esattamente a ciò di cui l'agente ha bisogno.
  • Ogni chiamata di strumento tracciata e auditabile tramite la pipeline di osservabilità.

Cosa costruisci:

Codice agente che chiama gli strumenti Work IQ utilizzando le API degli strumenti di Agent 365 SDK.

Come compilarlo:

Usare le API degli strumenti di Agent 365 SDK per aggiungere manualmente le chiamate dello strumento Work IQ al codice dell'agente. La configurazione guidata dall'intelligenza artificiale attualmente non supporta questa funzionalità.

Compagno di squadra di intelligenza artificiale

I colleghi del team di intelligenza artificiale sono disponibili per i partecipanti al programma Frontier .

La fase finale consente all'agente di operare in Microsoft 365 con la propria identità. A seconda della configurazione, può avere una cassetta postale, una presenza in Teams, una voce nella directory e una relazione con il manager. Le persone possono interagire con esso attraverso esperienze di Microsoft 365 familiari, ad esempio posta elettronica, chat, riunioni e superfici dell'app.

Note

Spostamento del modello di identità e autorizzazioni

Il passaggio a un team di intelligenza artificiale rappresenta un cambiamento fondamentale nel modo in cui l'agente accede alle risorse. L'agente esistente potrebbe usare l'accesso utente delegato, in cui l'agente agisce per un utente connesso e può accedere solo alle risorse a cui l'utente può accedere o le autorizzazioni dell'applicazione con ambito a un'entità servizio. Un agente con un'identità utente non eredita l'accesso di un utente chiamante in fase di esecuzione. Opera invece con la propria identità utente, con le proprie concessioni di accesso, criteri di governance e audit trail.

Ciò significa:

  • Nell'accesso utente delegato, l'agente agisce per conto dell'utente connesso ed è limitato all'accesso dell'utente. Con l'identità propria di un agente, si concede l'accesso alle risorse di Microsoft 365, come la cassetta postale, il calendario, Teams e SharePoint, in modo diretto all'identità dell'agente.
  • Si regolano e controllano le autorizzazioni concesse all'identità dell'agente come accesso personale di tale agente. Non sono le stesse delle autorizzazioni delegate dall'utente trasmesse dal chiamante.
  • Se l'implementazione corrente si basa sull'accesso utente delegato o sulle autorizzazioni dell'applicazione, esaminare e ri-definire l'ambito di tali autorizzazioni per l'identità dell'agente prima di abilitare questa funzionalità.

Cosa si ottiene:

  • Tutto, dall'individuabilità, dall'osservabilità e dall'IQ di lavoro.
  • Un'identità utente agente con la propria cassetta postale: gli utenti possono inviarli direttamente tramite posta elettronica e inviare messaggi di posta elettronica dal proprio indirizzo.
  • Una presenza tra app Microsoft 365: gli utenti possono chattare con esso, @mention, aggiungerlo ai canali e invitarlo alle riunioni in Teams e interagire direttamente in Word, Excel, PowerPoint e altre superfici M365.
  • Voce dell'organigramma sotto un manager designato: l'agente compare nella directory dell'organizzazione.
  • Ciclo di vita controllato dall'amministratore: l'agente viene creato, gestito e ritirato tramite il interfaccia di amministrazione di Microsoft 365, con governance completa su ogni istanza.

Cosa costruisci:

Tutte le funzionalità, oltre alla creazione di istanze e (facoltativamente) alla pubblicazione nel Marketplace.

Come compilarlo:

Usare la configurazione guidata dall'intelligenza artificiale e rispondere di conseguenza alle domande dei colleghi di intelligenza artificiale. La configurazione guidata dall'intelligenza artificiale esegue i passaggi necessari per questo livello.

Configurazione guidata dall'IA

Usare un agente di codifica per intelligenza artificiale per automatizzare la configurazione e la configurazione dell'agente per Agent 365. La configurazione guidata dall'intelligenza artificiale illustra i controlli dei prerequisiti, i passaggi di configurazione e l'integrazione del codice necessari per abilitare funzionalità come la registrazione, l'osservabilità, l'accesso allo strumento IQ di lavoro e la funzionalità del compagno di intelligenza artificiale.

Prerequisiti per la configurazione guidata dall'intelligenza artificiale

Prima di iniziare, assicurarsi di avere gli elementi seguenti:

Requisito Dettagli
Agente di codifica per intelligenza artificiale Visual Studio Code con estensioni GitHub Copilot e GitHub Copilot Chat o un altro agente di codifica di intelligenza artificiale con accesso al terminale
Codice dell'agente Progetto agente funzionante in Python, Node.jso .NET. Se non è disponibile, iniziare con un esempio di avvio rapido.
Entra Ruolo Amministratore globale : completa tutti i passaggi, incluse le concessioni di autorizzazione OAuth2. Agent ID Developer : completa tutti i passaggi tranne le concessioni di autorizzazione OAuth2; l'installazione genera un handoff per un amministratore globale.

Procedura di configurazione guidata dall'intelligenza artificiale

Questi passaggi si applicano se si abilita un singolo agente o una fabbrica di agenti. L'agente di intelligenza artificiale controlla gli strumenti necessari e gestisce automaticamente l'installazione, l'autenticazione e la convalida.

Aprire il progetto dell'agente e copiare questo prompt nell'agente di intelligenza artificiale preferito. Se si utilizza GitHub Copilot, passare prima alla modalità Agent - Le modalità Chiedi e Modifica non hanno accesso al terminale.

Follow the steps at aka.ms/agent365enable to enable my agent for Agent 365.

L'agente di intelligenza artificiale inizia ponendo tre domande per determinare quali funzionalità si applicano all'agente:

Question 1: l'agente è già disponibile in Teams o Copilot?

  • Yes
  • No

Domanda 2: Come verrà eseguita l'autenticazione dell'agente quando si chiamano le API downstream?

  • On-behalf-of (OBO): l'agente agisce come utente autenticato (autorizzazioni delegate)
  • Da servizio a servizio (S2S): l'agente agisce come un'entità propria (autorizzazioni applicative)
  • Entrambi (OBO e S2S)

Domanda 3: Quali funzionalità di Agent 365 si vuole abilitare?

L'installazione include automaticamente tutte le funzionalità dei prerequisiti per la selezione.

L'agente di intelligenza artificiale funziona quindi automaticamente tramite i livelli applicabili, sospendo solo per richiedere l'input:

Capability Che cosa fa l'agente di intelligenza artificiale 1
Registra Verifica la presenza di .NET e dell'interfaccia della riga di comando di Agent 365 (installa o aggiorna se mancante), installa interfaccia della riga di comando di Azure se mancante, esegue az login se non è autenticata, convalida la registrazione dell'app client personalizzata, raccoglie il nome dell'agente e la posta elettronica del manager, configura l'agente in Teams Developer Portal e registra il progetto agente
Osservabilità Aggiunge la strumentazione di osservabilità dell'SDK Agent 365 nel codice dell'agente
Compagno di squadra di intelligenza artificiale Esegue a365 publish e illustra i passaggi successivi alla distribuzione, inclusa la creazione dell'istanza dell'agente

1 I passaggi eseguiti dipendono dal tipo di agente e dalle fasi selezionate all'inizio dell'installazione.

Important

Per Observability, l'agente di intelligenza artificiale scrive il codice direttamente nel progetto. Gli agenti di codifica di intelligenza artificiale possono commettere errori. Esaminare sempre le modifiche prima della distribuzione nell'ambiente di produzione.

Informazioni necessarie per completare

L'agente di intelligenza artificiale si interrompe per raccogliere la configurazione durante la configurazione:

Richiesta Cosa fornire
Nome agente, posta elettronica del manager Metadati dell'agente di base
Conferma del valore derivato Esaminare i nomi generati automaticamente per l'identità dell'agente, il progetto e l'entità utente
Revisione del manifesto Verifica che il tuo manifest.json sia aggiornato con il nome, la descrizione e le informazioni sullo sviluppatore del tuo agente

Passaggi post-distribuzione

Al termine dei livelli automatizzati, l'agente di intelligenza artificiale si sospende per due passaggi che richiedono l'interazione del browser:

  1. Crea un'istanza di agente

    (solo teammate di intelligenza artificiale) - In Microsoft Teams passare a App, cercare l'agente e selezionare Aggiungi. Se è necessaria l'approvazione dell'amministratore, l'amministratore Microsoft 365 riceve la richiesta. Dopo l'approvazione, l'agente viene visualizzato nell'organigramma. Per altre istanze, vedere Creare istanze dell'agente. La visualizzazione di un nuovo agente pubblicato nella ricerca di Teams può richiedere alcuni minuti.

  2. Testare l'agente

    Inviare un messaggio all'agente in Teams per verificare che funzioni.

Operazione completata — l'agente è distribuito, pubblicato e attivo. Vedere Creare istanze dell'agente se sono necessarie istanze aggiuntive.

Se qualcosa non funziona, l'agente di intelligenza artificiale fornisce la risoluzione dei problemi mirata. È anche possibile fare riferimento alla Guida alla risoluzione dei problemi di Agent 365.

Riferimento al percorso manuale

Utilizzare questo riferimento solo se si sta risolvendo un problema in un passaggio, creando automazione CI/CD, e senza utilizzare un agente di codifica basato su AI.

Passaggio Funzione Guida
Configurazione del programma di installazione Crea a365.config.json con i dettagli del tenant, della sottoscrizione e del progetto. Se si dispone di una distribuzione esistente, impostare l'endpoint di messaggistica qui. Configurazione Setup Agent 365
Configurare il progetto Registra l'identità dell'agente in Entra ed effettua il provisioning delle risorse Azure (gruppo di risorse, piano di servizio App, app Web) Blueprint dell'agente di configurazione
Distribuisci Distribuisce il codice dell'agente in Servizio app di Azure. Facoltativo se già ospitato altrove. Azure · AWS · GCP
Publish Crea manifest.zip e carica nel centro di amministrazione di Microsoft 365 Pubblica agente

Per l'installazione dell'interfaccia della riga di comando, i comandi e la risoluzione dei problemi, vedere l'interfaccia della riga di comando di Agent 365.

Pubblica l'agente su Microsoft Marketplace

Dopo aver sviluppato e testato completamente l'agente all'interno del proprio tenant o dei propri tenant, rendilo disponibile in Microsoft Marketplace.

Per fare ciò, è necessario un account del programma Microsoft AI Cloud Partner in Partner Center. Se non ne hai uno, crea un account per ottenere il tuo PartnerID. Successivamente, iscriviti al programma Microsoft 365 e Copilot, che offre accesso alle risorse e al supporto necessari per pubblicare le offerte dell'agente. Dopo la registrazione, esaminare la checklist per l'invio e le linee guida per la convalida e quindi inviare l'agente tramite la guida dettagliata all'invio nel Partner Center.

Informazioni su come inviare l'agente a Microsoft Marketplace usando il Centro per i partner.

Al termine, l'agente viene pubblicato in Microsoft Marketplace e disponibile per consentire ai clienti di individuare e distribuire.

Risoluzione dei problemi relativi alla configurazione guidata dall'intelligenza artificiale

Se si verificano problemi durante la configurazione guidata dall'intelligenza artificiale, vedere i problemi comuni seguenti e le relative soluzioni.

Problema Description
L'agente di intelligenza artificiale non esegue i comandi del terminale L'agente di intelligenza artificiale descrive i comandi, ma non li esegue
L'agente di intelligenza artificiale ignora i passaggi Il programma di installazione sembra ignorare i passaggi necessari
I comandi CLI falliscono con errori di autorizzazione Errori di autorizzazione durante l'esecuzione di comandi dell'interfaccia della riga di comando di a365
I valori di configurazione non sono corretti È necessario modificare la configurazione dopo la creazione di a365.config.json

L'agente IA non esegue i comandi del terminale

Se l'agente di intelligenza artificiale descrive i comandi ma non li esegue, assicurarsi di usare Agent modalità in GitHub Copilot Chat. Le modalità Ask e Edit non hanno accesso al terminale.

L'agente di intelligenza artificiale ignora i passaggi

Il file di istruzioni impone un ordine rigoroso dei passaggi. Se l'agente di intelligenza artificiale sembra ignorare un passaggio, chiedere di ricominciare:

Please start from Step 1 in the setup instructions and work through each step in order.

I comandi CLI falliscono con errori di autorizzazione

Se a365 i comandi CLI falliscono con errori di autorizzazione, la causa più comune è una registrazione mancente o incompleta dell'app client personalizzata. L'agente di intelligenza artificiale lo convalida durante l'installazione, ma se la convalida è stata ignorata, vedere Registrazione dell'app client personalizzata.

Per informazioni generali sulla risoluzione dei problemi, vedere la Guida alla risoluzione dei problemi di Agent 365.

I valori di configurazione sono sbagliati

Se è necessario modificare i valori di configurazione dopo la creazione di a365.config.json, procedere in uno dei seguenti modi:

  • Modificare direttamente il file ed eseguire di nuovo a365 config init -c ./a365.config.json
  • Chiedi all'agente IA di aggiornare valori specifici