Testar 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 do Microsoft 365 Agents de três maneiras:

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

Iniciar seu projeto com o kit de ferramentas

Se você começar com o Kit de Ferramentas de Agentes, 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. Este cenário é abordado em:

Iniciar seu projeto clonando ou com a CLI

Se você iniciar seu projeto usando a CLI ou clonar um exemplo e abrir em seu IDE, poderá usar o Playground de Agentes locais para testar. O Agents Playground de conecta ao 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 o npm

  • Instalar Node.js (se ainda não estiver instalado): baixe e instale os Node.js mais recentes 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

Testar seu agente

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

  2. O Agents Playground dá suporte a modos anônimos e autenticados. Para testes anônimos, nenhuma outra configuração é necessária. Se você quiser testar com autenticação, precisará configurar registros de aplicativo do Microsoft Entra ID para o Agents Playground (as opções são fornecidas no texto a seguir) e 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 em 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 Agents Playground e comece com o endpoint do 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 do endpoint do 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 da CLI. Se ambos forem 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"

    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 de testes.

    Playground de agentes do Microsoft 365

Sempre que possível, recomendamos que você comece com o Kit de Ferramentas do Microsoft 365 Agents. O kit de ferramentas torna a introdução, o teste local e a implantação mais fáceis e rápidas. 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. Ao começar manualmente, você deve executar essas etapas manuais por conta própria.

Resumo

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

  • Last updated on