Testar o agente localmente no Ambiente de Demonstração de Agentes do Microsoft 365

Os detalhes sobre como testar o seu agente localmente dependem da forma como o criou.

Pode criar um agente utilizando o SDK de Agentes do Microsoft 365 de três formas:

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

Comece o seu projeto com o toolkit

Se começar com o Toolkit de Agentes, terá tudo configurado para testar imediatamente no Ambiente de Demonstração de Agentes. Pode testar no Ambiente de Demonstração de Agentes localmente, ou no Microsoft 365 Copilot ou no Microsoft Teams. Este cenário é abordado em:

Comece o seu projeto clonando ou com a CLI

Se iniciar o seu projeto através da CLI ou clonar um exemplo e abri-lo no seu IDE, pode utilizar o Ambiente de Demonstração de Agentes local para testes. O ambiente de demonstração dos agentes liga-se ao seu código local.

Pode instalar o Ambiente de Demonstração de Agentes utilizando uma dos seguintes métodos:

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

winget install agentsplayground

Opção 2: Instalar através do npm

  • Instale o Node.js (se ainda não estiver instalado): transfira e instale o Node.js mais recente em nodejs.org.

  • Instale o pacote do Ambiente de Demonstração de Agentes:

    Para instalação global (recomendado):

    npm install -g @microsoft/m365agentsplayground

    Para a instalação específica do projeto:

    npm install -D @microsoft/m365agentsplayground

Teste o seu agente

  1. Depois de criar um agente de início rápido ou clonar um exemplo do repositório, pode usá-lo com o Ambiente de Demonstração de Agentes.

  2. O Ambiente de Demonstração de Agentes suporta tanto modos anónimos como autenticados. Para testes anónimos, nenhuma configuração adicional é necessária. Se pretender testar com autenticação, deve configurar os registos de aplicações do Microsoft Entra ID tanto para o Ambiente de Demonstração de Agentes (as opções sã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 as suas portas corretamente na sua aplicação. Selecione uma porta disponível para o seu agente (a predefinição é 3978, mas pode utilizar qualquer porta disponível).

  4. Execute o seu código.

  5. Abra o Ambiente de Demonstração de Agentes e comece pelo ponto final do seu agente:

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

    Configure a autenticação, caso seja exigida 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 ponto final do seu agente (por exemplo, http://localhost:3978/api/messages)
    • -c, --channel-id: tipo de canal (por exemplo, emulator, webchat, msteams). Cada canal fornece uma experiência de utilizador e propriedades de atividade diferentes.
    • --client-id: ID de cliente para autenticação
    • --client-secret: segredo do cliente para autenticação
    • --tenant-id: ID do inquilino para autenticação

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

    Alternativamente, pode utilizar variáveis de ambiente em vez de opções da CLI. Se ambas forem especificadas, a opção CLI terá 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"

    Após iniciar o agente, este deverá abrir conforme a imagem seguinte. Pode fazer perguntas e testar o seu agente na interface do ambiente de demonstração.

    Ambiente de demonstração de agentes do Microsoft 365

Sempre que possível, recomendamos que comece pelo Toolkit de Agentes do Microsoft 365. O Toolkit facilita a introdução, os testes locais e a implementação , tornando-os mais simples e rápidos. Abstrai muito a configuração manual do Azure Bot Service e dos Registos de Aplicações do Azure, por isso não tem de o fazer. Ao iniciar manualmente, terá de executar estes passos manualmente.

Resumo

Testou o seu SDK de Agentes do Microsoft 365 localmente utilizando o Ambiente de Demonstração de Agentes do Microsoft 365, começando com um exemplo clonado a partir do repositório do GitHub ou da CLI.

  • Last updated on