Testa l'agente localmente in Microsoft 365 Agents Playground

I dettagli relativi al test locale del tuo agente dipendono dal metodo di creazione.

Puoi creare un agente usando l'SDK per agenti Microsoft 365 in tre modi:

• Inizia con Microsoft 365 Agents Toolkit in C#, JavaScript o Python usando Visual Studio o Visual Studio Code
• Clona da un campione e apri nel tuo IDE
• Usare l'interfaccia della riga di comando

Avvia il tuo progetto con il toolkit

Se inizi con Agents Toolkit, hai tutto già configurato per testare subito usando Playground per agenti. Puoi eseguire test in Playground per agenti sia in locale, sia in Microsoft 365 Copilot o Microsoft Teams. Questo scenario è trattato in:

• Procedura dettagliata di Visual Studio Code
• Procedura dettagliata di Visual Studio

Inizia il tuo progetto clonando o usando la CLI

Se avvii il progetto tramite CLI o cloni un esempio e lo apri nel tuo IDE, puoi utilizzare l'Playground per agenti locale per testare. Il Playground degli agenti si connette al codice locale.

Puoi installare Playground per agenti tramite uno dei metodi seguenti:

Opzione 1: installare il codice binario autonomo

winget install agentsplayground

curl -s https://raw.githubusercontent.com/OfficeDev/microsoft-365-agents-toolkit/dev/.github/scripts/install-agentsplayground-linux.sh | bash

Opzione 2: installare tramite npm

• Installa Node.js (se non è già installato): scarica e installa l'ultima versione di Node.js da nodejs.org.

• Installa il pacchetto Playground per agenti:

  Per l'installazione globale (consigliato):

  npm install -g @microsoft/m365agentsplayground
  

  Per l'installazione specifica del progetto:

  npm install -D @microsoft/m365agentsplayground
  

Test dell'agente

1. Una volta creato il tuo agente quickstart o clonato un esempio dal repo, puoi usarlo con il Playground per agenti.

2. Playground per agenti supporta sia la modalità anonima che quella autenticata. Per i test anonimi, non è richiesta alcuna altra configurazione. Se desideri testare con autenticazione, devi configurare le registrazioni app Microsoft Entra ID sia per Playground per agenti (le opzioni sono fornite di seguito) sia per la tua applicazione. Per informazioni, vedere Provisioning di un'istanza di Azure Bot da usare con Agents SDK.

3. Configura correttamente le porte nella tua applicazione. Seleziona una porta libera per il tuo agente (il valore predefinito è 3.978, ma puoi usare qualsiasi porta libera).

4. Esegui il codice.

5. Apri Playground per agenti e inizia con l'endpoint del tuo agente:

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator"
   

   Configura l'autenticazione se necessaria per il tuo agente:

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator" --client-id "your-client-id" --client-secret "your-client-secret" --tenant-id "your-tenant-id"
   

   Opzione principali:

   • -e, --app-endpoint: URL dell'endpoint del tuo agente (ad esempio, http://localhost:3978/api/messages)
   • -c, --channel-id: tipo di canale (ad esempio, emulator, webchat, msteams). Ogni canale fornisce un'esperienza utente e proprietà delle attività diverse.
   • --client-id: ID client per l'autenticazione
   • --client-secret: segreto client per l'autenticazione
   • --tenant-id: ID tenant per l'autenticazione

   Usa agentsplayground --help per vedere l'elenco completo delle opzioni disponibili.

   In alternativa, puoi usare variabili di ambiente invece delle opzioni CLI. Se entrambi sono specificati, l'opzione CLI ha la priorità.

   export BOT_ENDPOINT="http://localhost:<your-agent-port>/api/messages"
   export DEFAULT_CHANNEL_ID="emulator"
   export AUTH_CLIENT_ID="your-client-id"
   export AUTH_CLIENT_SECRET="your-client-secret"
   export AUTH_TENANT_ID="your-tenant-id"
   

   Dopo l'avvio dell'agente, dovrebbe essere aperto come illustrato nell'immagine seguente. Puoi fare domande e testare il tuo agente nell'interfaccia del playground.

   

Dove possibile, consigliamo di iniziare con il Toolkit per gli agenti di Microsoft 365. Il toolkit rende iniziare, testare localmente e distribuire più facile e veloce. Astrae gran parte della configurazione manuale del servizio Azure Bot e di Registrazioni App di Azure, quindi non devi farlo tu. Iniziando manualmente, dovrai eseguire personalmente questi passaggi manuali.

Riepilogo

Hai testato localmente l'SDK per agenti Microsoft 365 utilizzando il Playground per agenti di Microsoft 365, partendo da un esempio clonato dal repository GitHub o dalla CLI.