Ambientes no Toolkit de Agentes do Microsoft 365

Criar um agente ou aplicação com o Toolkit de Agentes do Microsoft 365 (anteriormente Teams Toolkit) significa frequentemente executar o mesmo projeto em destinos diferentes, como local, programador ou parque infantil. Os ambientes mantêm cada destino separado enquanto reutiliza a mesma estrutura do projeto e os mesmos comandos de ciclo de vida. O Toolkit de Agentes armazena ficheiros de definições específicas in .env.<environment-name> do ambiente. Cada ficheiro captura as variáveis e saídas desse destino, para que possa aprovisionar, implementar e publicar sem reconfigurar sempre os recursos.

Neste artigo, irá aprender como funcionam estes ficheiros de ambiente, como os ambientes locais e remotos diferem, como adicionar novos ambientes para o seu agente ou projeto de aplicação e como direcionar um ambiente específico para o seu fluxo de trabalho.

Utilizar ficheiros de ambiente com o Toolkit de Agentes

O Toolkit de Agentes segue um padrão de nomenclatura padrão para ficheiros de ambiente, como .env.{environment-name}. Quando executa comandos de ciclo de vida como Aprovisionar, Implementar ou Publicar, tem de especificar um nome de ambiente. Este nome tem de corresponder ao {environment-name} utilizado no ficheiro de ambiente correspondente.

Localização do ficheiro de ambiente

Por predefinição, o Toolkit de Agentes não carrega variáveis de ambiente e simplesmente executa ações, guardando saídas em ./env/.env.dev. Se não especificar um environmentFolderPath, não lê variáveis de um ficheiro .env e assume que o ambiente está definido como dev, com saídas direcionadas para ./env/.env.dev.

Ambientes locais

A criação de um agente ou aplicação do Microsoft Teams envolve recursos locais e na cloud. Os recursos da cloud incluem registos de aplicações e o cliente do Teams, enquanto a lógica do agente ou da aplicação pode ser executada localmente para acelerar o desenvolvimento e os testes. Todos os modelos do Toolkit de Agentes incluem um ambiente pré-configurado local com ./env/.env.local ficheiros e ./env/.env.local.user . Esta configuração permite-lhe executar o seu agente ou aplicação num servidor Web local e depurá-lo com pontos de interrupção no Visual Studio Code (para JavaScript, TypeScript ou agente ou aplicação Python) ou Visual Studio (para agente ou aplicação CSharp).

Para diferenciar entre um ambiente local e todos os outros ambientes, pode criar um ficheiro de projeto separado chamado m365agents.local.yml no mesmo diretório que m365agents.yml.

Criar um novo ambiente manualmente no Visual Studio Code

Cada projeto pode ter um ambiente local e vários ambientes remotos. Depois de criar um projeto, o Toolkit de Agentes configura os seguintes ambientes predefinidos:

• ambiente local para representar a configuração do ambiente do computador local.
• ambiente de desenvolvimento para representar a configuração do ambiente remoto ou da cloud.

Para criar um novo ambiente:

1. Abra a área de trabalho do agente do Teams ou do projeto de aplicação no Visual Studio Code.

2. Selecione o ícone do Toolkit de Agentes do Microsoft 365 na barra de atividade Visual Studio Code.

3. Selecione o + ícone na secção AMBIENTE .

   

4. Introduza um nome para o ambiente e selecione Enter.

   

Filtrar um ambiente para compilação remota

Ao trabalhar com vários ambientes, tem de selecionar um ambiente de destino para criar, depurar e pré-visualizar o seu agente ou aplicação no Microsoft Teams. Pode escolher o ambiente de destino diretamente a partir das definições de compilação.

Selecionar um ambiente

Para dev de destino ou qualquer outro ambiente personalizado:

1. Na secção Ciclo de Vida do toolkit agentes, selecione Aprovisionar para o agente ou aplicação.

   

2. Quando lhe for pedido, selecione um dos ambientes disponíveis (por exemplo, dev ou um ambiente personalizado).

   

O Toolkit de Agentes aprovisiona o agente ou aplicação para o ambiente escolhido. Agora pode criar o seu agente ou aplicação no ambiente selecionado.

Criar no ambiente selecionado

Assim que o ambiente estiver selecionado, o Toolkit de Agentes aprovisiona o agente ou a aplicação para esse ambiente. Agora pode criar, depurar e executar o seu agente ou aplicação no ambiente selecionado.

1. Selecione o ícone Executar e Depurar na barra lateral Visual Studio Code.

2. Selecione a opção para depurar e pré-visualizar o agente remoto ou aplicação no Microsoft Teams.

   

O Toolkit de Agentes cria o agente ou a aplicação no ambiente para o qual aprovisionou. O agente ou aplicação está disponível para visualização e teste no Teams.

Confira também

• Descrição Geral do Toolkit de Agentes do Microsoft 365
• Esquema de manifesto do aplicativo para o Teams
• Adicionar mais recursos de nuvem
• Colaborar com outros desenvolvedores no projeto do Teams
• Testar o comportamento da aplicação num ambiente diferente