Testar seu agente localmente no Playground de Agentes do Microsoft 365

Os detalhes de como testar seu agente localmente dependem de como você criou o agente.

Você pode criar um agente usando o SDK de Agentes do Microsoft 365 de três maneiras:

  • Começar com o Kit de Ferramentas do Microsoft 365 Agents em C#, JavaScript ou Python usando o Visual Studio ou o Visual Studio Code
  • Clonar a partir de um exemplo e abrir no seu IDE
  • Como usar a CLI

Começar seu projeto com o Kit de Ferramentas de Agentes

Se começar com o Kit de Ferramentas de Agentes, você já terá tido configurado para testar usando o Playground de Agentes imediatamente. Você pode testar no Playground de Agentes localmente, no Microsoft 365 Copilot ou no Microsoft Teams. Esse cenário é abordado em:

Começar seu projeto clonando ou usando a CLI

Se começar seu projeto usando a CLI ou clonar um exemplo e abrir em seu IDE, você poderá usar o Playground de Agentes local para testar. O Agents Playground de conecta ao código local.

Você pode instalar o Playground de Agentes usando uma dos seguintes métodos:

Opção 1: Instalar o binário independente

winget install agentsplayground

Opção 2: Instalar usando npm

  • Instale o Node.js (caso ainda não esteja instalado): baixe e instale o Node.js mais recente em nodejs.org.

  • Instale o pacote do Playground de Agentes:

    Para instalação global (recomendado):

    npm install -g @microsoft/m365agentsplayground

    Para instalação específica de projeto:

    npm install -D @microsoft/m365agentsplayground

Testar o seu agente

  1. Depois que criar seu agente de início rápido ou clonar um exemplo do repositório, você poderá usá-lo com o Playground de Agentes.

  2. O Playground de Agentes oferece suporte aos modos anônimo e autenticado. Para testes anônimos, nenhuma outra configuração é necessária. Se quiser testar com autenticação, você deverá configurar registros de aplicativo do Microsoft Entra ID para o Playground de Agentes (opções são fornecidas no texto a seguir) e para seu aplicativo. Para obter informações, consulte Provisionamento de um Bot do Azure para usar com o SDK de Agentes.

  3. Configure suas portas corretamente no seu aplicativo. Selecione uma porta disponível para seu agente (o padrão é 3978, mas você pode usar qualquer porta disponível).

  4. Execute o código.

  5. Abra o Playground de Agentes e inicie com o ponto de extremidade do seu agente:

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

    Configure a autenticação, se necessário, pelo 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"

    Principais opções:

    • -e, --app-endpoint: URL do ponto de extremidade do seu agente (por exemplo, http://localhost:3978/api/messages)
    • -c, --channel-id: tipo de canal (por exemplo, emulator, webchat, msteams). Cada canal fornece diferentes propriedades de experiência do usuário e de atividade.
    • --client-id: ID do cliente para autenticação
    • --client-secret: segredo do cliente para autenticação
    • --tenant-id: ID do locatário para autenticação

    Use agentsplayground --help para ver a lista completa de opções disponíveis.

    Alternativamente, você pode usar variáveis de ambiente em vez de opções de CLI. Se ambos forem especificados, a opção CLI tem prioridade.

    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"

    Depois que o agente for iniciado, ele deverá ser aberto como mostrado na imagem a seguir. Você pode fazer perguntas e testar seu agente na interface do playground.

    Playground de agentes do Microsoft 365

Sempre que possível, recomendamos que você comece pelo Kit de Ferramentas de Agentes do Microsoft 365. O kit de ferramentas torna o início, os testes locais e a implantação mais fáceis e rápidos. Ele abstrai muito a configuração manual do Serviço de Bot do Azure e dos Registros de Aplicativos do Azure, então, você não precisa fazer isso. Ao iniciar manualmente, você deve realizar essas etapas manuais por conta própria.

Resumo

Você testou seu SDK de Agentes do Microsoft 365 localmente usando o Microsoft 365 Playground de Agentes, começando com um exemplo clonado do repositório do GitHub ou da CLI.

  • Last updated on