Configurazione guidata dall'IA per Agent 365

Il ciclo di vita dell'agente 365 development prevede più passaggi: installazione dell'interfaccia della riga di comando, configurazione dei prerequisiti, creazione di un progetto agente, distribuzione del codice e pubblicazione nell'interfaccia di amministrazione di Microsoft 365. Ogni fase ha i propri prerequisiti, controlli di validazione e punti decisionali.

La configurazione guidata AI automatizza l'intero flusso di lavoro usando un agente di codifica di intelligenza artificiale (ad esempio GitHub Copilot in VS Code) per eseguire i passaggi del ciclo di vita per conto dell'utente. 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.
• Convalida dei prerequisiti automatica : l'agente di intelligenza artificiale verifica che l'Azure CLI sia installato e autenticato, che la registrazione dell'app client personalizzata abbia le autorizzazioni corrette con il consenso dell'amministratore e che gli strumenti di compilazione specifici del linguaggio siano disponibili, tutti prima di eseguire qualsiasi comando dell'interfaccia della riga di comando di a365.
• Valori predefiniti intelligenti e rilevamento automatico: l'agente di intelligenza artificiale esegue una query sull'abbonamento Azure per i gruppi di risorse esistenti, i piani di servizio delle app e le informazioni utente, quindi utilizza tali valori come suggerimenti durante la raccolta degli input di configurazione.
• Convenzioni di denominazione derivate : si specifica un singolo nome di base per l'agente e l'agente di intelligenza artificiale deriva tutti i nomi di risorse correlati (identità, progetto, nome dell'entità utente, app Web) usando modelli 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

• Visual Studio Code con estensioni GitHub Copilot e GitHub Copilot Chat installate. La configurazione guidata dall'IA richiede un agente di codifica AI con accesso al terminale.
• .NET 8.0 o versione successiva - Obbligatorio per l'interfaccia della riga di comando di Agent 365. Installare .NET.
• Azure CLI - Obbligatorio per l'autenticazione e la gestione delle risorse. Installare Azure CLI.

Account e autorizzazioni obbligatori

• Sottoscrizione Azure con accesso come collaboratore
• Microsoft Entra tenant con uno dei ruoli seguenti:
  • Amministratore globale
  • Amministratore ID Agente
  • Sviluppatore ID Agente
• Registrazione personalizzata dell'app client - La configurazione guidata dall'IA valida questa registrazione dell'app, ma l'app deve già esistere nel tuo tenant con i permessi necessari e il consenso dell'amministratore. Per crearne uno, vedere Registrazione dell'app client personalizzata.

Codice agente richiesto

• Progetto agente di lavoro (Python, Node.jso .NET) da distribuire. Se non hai già uno disponibile, inizia con uno degli esempi rapidi per iniziare.

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 il repository non è stato clonato, scaricare 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 di progetto dell'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).

Passaggio 2: Aprire GitHub Copilot Chat in modalità agente

Aprire il pannello GitHub Copilot Chat e passare alla modalità Agent. La modalità agente offre GitHub Copilot la possibilità di eseguire comandi terminal, leggere i file e interagire con il progetto: tutte le funzionalità richieste dalla configurazione guidata dall'intelligenza artificiale.

Passo 3: Allega il file di istruzioni e inizia

Nell'input Copilot Chat allegare il file a365-setup-instructions.md e inviarlo con una breve richiesta. Per esempio:

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

L'agente di intelligenza artificiale legge il file di istruzioni e avvia la configurazione guidata. Crea un elenco di attività con cinque passaggi e li esegue uno alla sola:

1. Verifica e installa la CLI dell'Agent 365 - Controlla la CLI, la installa o aggiorna e verifica che funzioni.
2. Validate prerequisiti : conferma l'autenticazione Azure CLI, convalida la registrazione e le autorizzazioni dell'app client personalizzata e verifica che gli strumenti di compilazione siano installati per il tipo di progetto.
3. Configurare l'interfaccia della riga di comando di Agent 365: chiede se si vuole eseguire la distribuzione ospitata Azure o self-hosted, raccoglie i valori di configurazione, deriva i nomi delle risorse e crea il file a365.config.json.
4. Provisioning delle risorse: esegue a365 setup all per creare l'infrastruttura Azure e il blueprint dell'agente.
5. Publish e deploy : esamina il manifesto, pubblica l'agente nell'interfaccia di amministrazione Microsoft 365, distribuisce il codice in Azure e fornisce istruzioni post-distribuzione.

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 - Indica se creare un'app Web Azure (ospitata Azure) o usare un endpoint esistente (self-hosted).
• Valori di configurazione - Gruppo di risorse, posizione, nome agente, posta elettronica del manager e piano di servizio app (per Azure-hosted) o nome dell'agente e posta elettronica del manager (per self-hosted).
• Conferma del valore derivato : esaminare i nomi generati automaticamente per l'identità dell'agente, il blueprint e il principale utente.
• Revisione del manifesto — Conferma che il manifest.json sia aggiornato con il nome dell'agente, la descrizione e le informazioni sullo sviluppatore.

Passo 5: Completare le attività post-implementazione

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 processo di sviluppo:

Risoluzione dei problemi

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 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 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 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