Condividi tramite

Configurazione guidata dall'IA per Agent 365

Importante

Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.

Il ciclo di sviluppo di Agent 365 prevede più fasi: installare la CLI, configurare i prerequisiti, creare un progetto di agente, distribuire codice e pubblicare nel centro amministrativo Microsoft 365. Ogni fase ha i propri prerequisiti, controlli di validazione e punti decisionali.

La configurazione guidata dall'IA automatizza l'intero flusso di lavoro utilizzando un agente di codifica AI (come GitHub Copilot in VS Code) per eseguire i passaggi del ciclo di vita al tuo posto. Invece di navigare tra più pagine di documentazione ed eseguire comandi manualmente, fornisci all'agente AI un unico file di istruzioni che ti guida nel processo in modo interattivo.

Vantaggi

La configurazione guidata dall'IA offre diversi vantaggi rispetto al flusso di lavoro manuale:

  • Punto di ingresso singolo — Un file di istruzioni sostituisce la necessità di navigare tra più pagine di documentazione. L'agente AI segue i passaggi in ordine e gestisce automaticamente le transizioni.
  • Validazione automatica dei prerequisiti — L'agente AI verifica che la CLI Azure sia installata e autenticata, che la registrazione della tua app client personalizzata abbia i permessi corretti con il consenso dell'amministratore, e che siano disponibili strumenti di build specifici per linguaggio - tutto questo prima di eseguire qualsiasi a365 comando CLI.
  • Valori predefiniti intelligenti e auto-rilevamento — L'agente AI interroga il tuo abbonamento Azure per gruppi di risorse esistenti, piani App Service e informazioni utente, poi usa questi valori come suggerimenti quando raccoglie input di configurazione.
  • Convenzioni di denominazione derivate — Fornisci un unico nome base per il tuo agente, e l'agente AI deriva tutti i nomi delle risorse correlate (identità, blueprint, nome principale utente, web app) utilizzando schemi coerenti.
  • Gestione degli errori in linea — Quando un comando fallisce, l'agente IA analizza l'errore, suggerisce una correzione e riprova - invece di richiederti di cercare nella documentazione di risoluzione dei problemi.
  • Configurazione non interattiva — L'agente AI crea il a365.config.json file direttamente e lo importa, evitando problemi con i wizard CLI interattivi in ambienti automatizzati.

Prerequisiti

Prima di iniziare, assicurarsi di avere i prerequisiti seguenti:

Strumenti necessari

Account e autorizzazioni obbligatori

Codice agente richiesto

  • Un progetto di agente funzionante (Python, Node.jso .NET) che vuoi distribuire. Se non ne hai uno, inizia con uno dei campioni di avvio rapido.

Scarica il file delle istruzioni di installazione

La configurazione guidata dall'IA utilizza un file di istruzioni chiamato a365-setup-instructions.md. Il repository Agent365-devTools include questo file.

Se hai clonato il repository, il file si trova a:

Agent365-devTools/docs/agent365-guided-setup/a365-setup-instructions.md

Se non hai clonato il repository, scarica il file direttamente da GitHub.

Esegui la configurazione guidata dall'IA

Segui questi passaggi per iniziare la configurazione guidata dall'IA nel tuo progetto agente.

Passo 1: Apri il tuo progetto agente in VS Code

Apri la directory del progetto agente in Visual Studio Code. Questa directory contiene il codice del tuo agente (ad esempio, la directory con il tuo package.json, *.csproj, o pyproject.toml file).

Passo 2: Apri GitHub Copilot Chat in modalità agente

Apri il pannello Chat di GitHub Copilot e passa in modalità Agente . La modalità Agente offre a GitHub Copilot la possibilità di eseguire comandi terminali, leggere file e interagire con il tuo progetto - tutte funzionalità richieste dalla configurazione guidata dall'IA.

Importante

Devi usare la modalità Agente (non la modalità Ask o Edit). La configurazione guidata dall'IA richiede la capacità di eseguire comandi terminali e interagire con l'ambiente.

Passo 3: Allega il file di istruzioni e inizia

Nell'input della chat del Copilot, allega il a365-setup-instructions.md file e invialo con un breve prompt. Per esempio:

Follow the steps in #file:a365-setup-instructions.md

L'agente IA legge il file di istruzioni e inizia la configurazione guidata. Crea una lista delle attività con cinque passaggi e li affronta in sequenza:

  1. Verifica e installa la CLI dell'Agent 365 - Controlla la CLI, la installa o aggiorna e verifica che funzioni.
  2. Valida i prerequisiti - Conferma l'autenticazione Azure CLI, valida la registrazione e i permessi della tua app client personalizzata e verifica che siano installati strumenti di build per il tipo di progetto.
  3. Configura la CLI dell'Agent 365 - Chiede se vuoi un deployment ospitato su Azure o self-host, raccoglie valori di configurazione, deriva i nomi delle risorse e crea il a365.config.json file.
  4. Fornire risorse - Viene eseguito a365 setup all per creare l'infrastruttura Azure e il progetto dell'agente.
  5. Pubblica e distribuisci - Revisiona il manifest, pubblica l'agente al centro amministrativo Microsoft 365, distribuisce il codice su Azure e fornisce le istruzioni post-deployment.

Passo 4: Rispondi ai prompt

L'agente IA si ferma in punti specifici per raccogliere input da te:

  • ID app client personalizzato — Il tuo ID Application (client) per la registrazione personalizzata dell'app client.
  • Tipo di distribuzione — Sia creare un'app Web Azure (ospitata su Azure) sia utilizzare un endpoint esistente (auto-ospitato).
  • Valori di configurazione — Gruppo risorse, posizione, nome agente, email manager e piano App Service (per Azure-hosted) oppure nome agente e email manager (per self-hosted).
  • Conferma di valore derivato — Rivedere i nomi generati automaticamente per l'identità dell'agente, il blueprint e il main utente.
  • Revisione del manifesto — Conferma che il manifest.json tuo nome sia aggiornato con il nome del tuo agente, la descrizione e le informazioni dello sviluppatore.

Suggerimento

L'agente AI mostra valori reali dal tuo abbonamento Azure come esempio quando chiede input di configurazione. Puoi accettare i suggerimenti o proporre i tuoi valori.

Passo 5: Completare i compiti post-deployment

Dopo la conclusione dei comandi CLI, l'agente AI fornisce istruzioni per i passaggi manuali che richiedono l'interazione con il browser:

  1. Configura l'agente nel Portale Sviluppatori di Teams — Imposta il tipo di agente e l'ID del bot.
  2. Crea un'istanza di agente — Richiedi un'istanza da Teams e fatti approvare da un amministratore.
  3. Testa l'agente — Invia messaggi al tuo agente su Teams per verificare che funzioni.

Per istruzioni dettagliate su questi passaggi post-deployment, vedi Create agent instances.

Cosa copre la configurazione guidata dall'IA

La configurazione guidata dall'IA automatizza le seguenti fasi del ciclo di sviluppo dello sviluppo:

Fase del ciclo di vita Cosa fa l'agente AI Equivalente manuale
Installazione CLI Installa o aggiorna la CLI Agent 365 Agente 365 CLI
Prerequisiti Valida Azure CLI, app client personalizzata, permessi e strumenti di build Registrazione personalizzata dell'app client
Impostazione Crea a365.config.json con valori validati Configurazione Setup Agent 365
Configurazione dei progetti Esiste a365 setup all per creare infrastrutture e progetti Blueprint dell'agente di configurazione
Distribuzione Esecuzioni a365 deploy per costruire e distribuire codice Deploy agent to Azure
Pubblicazione Corre a365 publish verso l'agente di registrazione nel centro amministrativo Pubblica l'agente nel centro amministrativo Microsoft

Annotazioni

La configurazione guidata dall'IA non sostituisce la necessità di costruire prima il codice dell'agente . Dovresti avere un progetto di agente funzionante prima di iniziare la configurazione guidata. Per i nuovi progetti, inizia con un avvio rapido.

Risoluzione dei problemi

L'agente IA non esegue i comandi del terminale

Se l'agente IA descrive i comandi ma non li esegue, assicurati di usare la modalità Agente in GitHub Copilot Chat. Le modalità Ask e Edit non hanno accesso al terminale.

L'agente IA salta i passaggi di validazione

Il file di istruzioni impone un ordine rigoroso dei passaggi. Se l'agente IA sembra saltare un passaggio, ricordagli di seguire le istruzioni dall'inizio. Per esempio:

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

I comandi CLI falliscono con errori di permesso

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 AI valida questa registrazione nel Step 2, ma se hai saltato quella validazione, torna indietro e eseguila. Per la guida completa alla configurazione, vedi Registrazione personalizzata dell'app client.

I valori di configurazione sono sbagliati

Se devi cambiare i valori di configurazione dopo aver creato il a365.config.json file, puoi poi:

  • Modifica direttamente il a365.config.json file e riavvia a365 config init -c ./a365.config.json
  • Chiedi all'agente IA di aggiornare valori specifici

Passaggi successivi

Scopri il ciclo di sviluppo di Agent 365

Crea istanze di agente

  • Last updated on