Testa il tuo agente localmente in Microsoft 365 Agents Playground

I dettagli su come testare l'agente in locale dipendono da come hai creato l'agente.

È possibile creare un agente usando Managed Disks in tre modi:

  • Iniziare con Microsoft 365 Agents Toolkit in C#, JavaScript o Python con Visual Studio o Visual Studio Code
  • Clonare da un esempio e aprire nell'IDE
  • Usare la CLI

Avviare il progetto con il toolkit

Se inizi con l'Agents Toolkit, hai tutto configurato per il test usando subito l'Agents Playground. Puoi testare su Agents Playground sia localmente, sia in Microsoft Copilot o Microsoft Teams. Questo scenario è illustrato in:

Avvia il progetto clonando o con la CLI

Se inizi il tuo progetto usando la CLI o cloni un campione e lo apri nel tuo IDE, puoi usare il Playground locale degli agenti per testare. Il Playground degli agenti si connette al codice locale.

Puoi installare l'Agents Playground utilizzando uno dei seguenti metodi:

Opzione 1: Installare il file binario autonomo

winget install agentsplayground

Opzione 2: Installare con npm

  • Installare Node.js (se non è già installato): scaricare e installare la Node.js più recente da nodejs.org.

  • Installare il pacchetto Agents Playground:

    Per l'installazione globale (scelta consigliata):

    npm install -g @microsoft/m365agentsplayground

    Per l'installazione specifica del progetto:

    npm install -D @microsoft/m365agentsplayground

Testa il tuo agente

  1. Dopo aver creato il tuo agente di avvio rapido o clonato un campione dal repository, usalo con l'Agents Playground.

  2. Agents Playground supporta sia modalità anonime che autenticate. Per i test anonimi, non sono necessarie altre configurazioni. Se si vuole testare con l'autenticazione, è necessario configurare le registrazioni dell'app Microsoft Entra ID per Agents Playground (le opzioni sono disponibili nel testo seguente) e per l'applicazione. Per informazioni, vedere Effettuare il provisioning di Azure Bot da usare con Agents SDK.

  3. Configurare correttamente le porte nell'app. Seleziona una porta disponibile per il tuo agente (il predefinito è 3978, ma puoi usare qualsiasi porta disponibile).

  4. Esegui il codice.

  5. Apri Agents Playground e inizia dall'endpoint dell'agente.

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

    Configurare l'autenticazione se richiesto dall'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 dell'agente (ad esempio, http://localhost:3978/api/messages)
    • -c, --channel-id: tipo di canale (ad esempio, emulator, webchat, msteams). Ogni canale offre diverse proprietà dell'esperienza utente e delle attività.
    • --client-id: ID client per l'autenticazione
    • --client-secret: segreto client per l'autenticazione
    • --tenant-id: ID locatario per l'autenticazione

    Usare agentsplayground --help per visualizzare l'elenco completo delle opzioni disponibili.

    In alternativa, è possibile usare le variabili di ambiente anziché le opzioni dell'interfaccia della riga di comando. Se vengono specificati entrambi, l'opzione dell'interfaccia della riga di comando ha priorità più alta.

    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"

    Quando il tuo agente inizia, si apre come si vede nell'immagine seguente. È possibile porre domande e testare l'agente nell'interfaccia del playground.

    Microsoft 365 Agents Playground

Dove possibile, inizia con il Microsoft 365 Agents Toolkit. Il toolkit consente di iniziare, testare in locale e distribuire in modo più semplice e rapido. Astrae gran parte della configurazione manuale del servizio Azure Bot e di registrazioni App di Azure, quindi non devi farlo tu. Iniziando manualmente, è necessario eseguire manualmente questi passaggi manuali.

Sommario

Hai testato localmente il tuo Managed Disks utilizzando il Microsoft 365 Agents Playground. Hai iniziato con un campione clonato dal repository GitHub o dalla CLI.

  • Ultimo aggiornamento: