Partilhar via

Teste seu agente localmente no Microsoft 365 Agents Playground

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

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

  • Comece com o Microsoft 365 Agents Toolkit em C#, JavaScript ou Python usando Visual Studio ou Visual Studio Code
  • Clone de um exemplo e abra no seu IDE
  • Utilizar a CLI

Comece o seu projeto com a caixa de ferramentas

Se começares com o Agents Toolkit, tens tudo configurado para testar logo no Agents Playground. Você pode testar no Agents Playground localmente ou no Microsoft 365 Copilot ou no Microsoft Teams. Este cenário é abordado em:

Comece o seu projeto clonando ou com o CLI

Se começares o teu projeto usando a CLI ou clonares uma amostra e abrir no teu IDE, podes usar o Agents Playground local para testar. O Agents Playground se conecta ao seu código local.

Você pode instalar o Agents Playground usando um dos seguintes métodos:

Opção 1: Instalar o binário autônomo

winget install agentsplayground

Opção 2: Instalar usando npm

  • Instalar Node.js (se ainda não estiver instalado): Transfira e instale o Node.js mais recente a partir do nodejs.org.

  • Instale o pacote do Agents Playground:

    Para instalação global (recomendado):

    npm install -g @microsoft/m365agentsplayground

    Para instalação específica do projeto:

    npm install -D @microsoft/m365agentsplayground

Teste o seu agente

  1. Depois de criares o teu agente de início rápido ou clonares um sample do repositório, podes usá-lo com o Agents Playground.

  2. O Agents Playground suporta os modos anônimo e autenticado. Para testes anónimos, não é necessária outra configuração. Se quiser testar com autenticação, precisa de configurar os registos da aplicação Microsoft Entra ID tanto para o Agents Playground (as opções estão fornecidas no texto que se segue) como para a sua aplicação. Para obter informações, consulte Aprovisionar um Azure Bot para utilizar com o SDK de Agentes.

  3. Configure suas portas corretamente em seu aplicativo. Seleciona uma porta disponível para o teu agente (o padrão é 3978, mas podes usar qualquer porta disponível).

  4. Execute o seu código.

  5. Abra o Agents Playground e comece com o endpoint do seu agente:

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

    Configure a autenticação, se exigido pelo seu 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 de endpoint 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 e atividade do usuário.
    • --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.

    Como alternativa, você pode usar variáveis de ambiente em vez de opções de CLI. Se ambos forem especificados, a opção CLI tem maior 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 de iniciar o seu agente, deverá abrir-se automaticamente, tal como pode ver na imagem seguinte. Você pode fazer perguntas e testar seu agente na interface de teste.

    Ambiente de demonstração de agentes do Microsoft 365

Sempre que possível, recomendamos que você comece com o Microsoft 365 Agents Toolkit. O kit de ferramentas torna a introdução, o teste local 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 Aplicativo do Azure para que você não precise fazê-lo. Ao iniciar manualmente, você deve executar essas etapas manuais por conta própria.

Summary

Testava o teu Microsoft 365 Agents SDK localmente usando o Microsoft 365 Agents Playground, começando com uma amostra clonada do repositório do GitHub ou da linha de comando.

  • Last updated on