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:

  • Clone de um exemplo e abra no seu IDE
  • Comece com o Microsoft 365 Agents Toolkit em C#, JS, ou Python usando Visual Studio ou Visual Studio Code
  • Use a CLI, conforme mostrado no início rápido

Utilizar o ambiente de demonstração de agentes do Microsoft 365

Começou o seu projeto com o conjunto de ferramentas

Se você começar com o kit de ferramentas, terá tudo configurado para testar usando o Agents Playground imediatamente. Você pode testar no Agents Playground localmente ou no Microsoft 365 Copilot ou no Microsoft Teams. Esse cenário é abordado no passo a passo do Visual Studio Code e no passo a passo do Visual Studio, respectivamente.

Você começou o seu projeto através de clonagem ou utilizando a linha de comandos (CLI).

Se você iniciar seu projeto usando a CLI ou clonando um exemplo e abrindo o exemplo em seu IDE, poderá 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

  1. Depois que seu agente de início rápido for criado ou uma amostra for clonada do repositório, você poderá usá-lo com o Agents Playground.

  2. O Agents Playground suporta os modos anônimo e autenticado. Para testes anônimos, nenhuma configuração adicional é necessária. Se quiser testar com autenticação, você precisa configurar os registros do aplicativo Microsoft Entra ID para o Agents Playground (as opções são fornecidas abaixo) e seu aplicativo. Para obter informações, consulte Aprovisionar um Azure Bot para utilizar com o SDK de Agentes.

  3. Configure suas portas corretamente em seu aplicativo. Escolha uma porta disponível para seu agente (o padrão é 3978, mas pode ser 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: O URL do ponto final do seu agente (por exemplo, http://localhost:3978/api/messages)
    • -c, --channel-id: Tipo de canal (por exemplo, emulator, , webchatmsteams). 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 especificados, a opção CLI terá prioridade mais 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"

    Uma vez iniciado, ele deve abrir como visto na imagem a seguir. 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

Você testou com êxito seu SDK do Microsoft 365 Agents localmente usando o Microsoft 365 Agents Playground ao iniciar com uma amostra clonada do repositório GitHub ou da CLI.

  • Last updated on