Condividi tramite

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 Microsoft 365 Agents SDK 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 si inizia con Agents Toolkit, tutti gli elementi sono configurati per il test usando Agents Playground immediatamente. È possibile eseguire il test in Agents Playground in locale o in Microsoft 365 Copilot o Microsoft Teams. Questo scenario è illustrato in:

Avvia il progetto clonando o con la CLI

Se si avvia il progetto usando l'interfaccia della riga di comando o si clona un esempio e si apre nell'IDE, è possibile usare Agents Playground locale per eseguire il test. Il Playground degli agenti si connette al codice locale.

È possibile installare Agents Playground usando uno dei metodi seguenti:

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

Metti alla prova il tuo agente

  1. Dopo aver creato l'agente di avvio rapido o clonato un esempio dal repository, è possibile usarlo con 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 Provisioning di un'istanza di Azure Bot da usare con Agents SDK.

  3. Configurare correttamente le porte nell'app. Selezionare una porta disponibile per l'agente (il valore predefinito è 3978, ma è possibile 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"

    Dopo l'avvio dell'agente, dovrebbe essere aperto come illustrato nell'immagine seguente. È possibile porre domande e testare l'agente nell'interfaccia del playground.

    Microsoft 365 Agents Playground

Laddove possibile, è consigliabile iniziare con 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.

Summary

Hai testato localmente il Microsoft 365 Agents SDK utilizzando il Microsoft 365 Agents Playground, partendo da un esempio clonato dal repository di GitHub o dall'interfaccia della riga di comando.

  • Last updated on