Ambientes no Microsoft 365 Agents Toolkit

Criar um agente ou aplicativo com o Microsoft 365 Agents Toolkit (anteriormente Teams Toolkit) geralmente significa executar o mesmo projeto em diferentes destinos, como local, de desenvolvimento ou um playground. Os ambientes mantêm cada destino separado enquanto você reutiliza a mesma estrutura de projeto e comandos de ciclo de vida. O Agents Toolkit armazena arquivos de configurações in .env.<environment-name> específicos do ambiente. Cada arquivo captura as variáveis e saídas desse destino, para que você possa provisionar, implantar e publicar sem reconfigurar os recursos todas as vezes.

Neste artigo, você aprenderá como esses arquivos de ambiente funcionam, como os ambientes locais e remotos diferem, como adicionar novos ambientes para seu agente ou projeto de aplicativo e como direcionar um ambiente específico para seu fluxo de trabalho.

Usando arquivos de ambiente com o Agents Toolkit

O Agents Toolkit segue um padrão de nomenclatura padrão para arquivos de ambiente, como .env.{environment-name}. Ao executar comandos de ciclo de vida como Provisionar, Implantar ou Publicar, você deve especificar um nome de ambiente. Esse nome deve corresponder ao {environment-name} usado no arquivo de ambiente correspondente.

Local do arquivo de ambiente

Por padrão, o Agents Toolkit não carrega variáveis de ambiente e simplesmente executa ações, salvando as saídas no ./env/.env.dev. Se você não especificar um environmentFolderPath, ele não lerá variáveis de um arquivo .env e assumirá que o ambiente está definido como dev, com saídas direcionadas para ./env/.env.dev.

Ambientes locais

Criar um agente ou aplicativo do Microsoft Teams envolve recursos locais e de nuvem. Os recursos de nuvem incluem registros de aplicativo e o cliente do Teams, enquanto a lógica do agente ou do aplicativo pode ser executada localmente para acelerar o desenvolvimento e os testes. Todos os modelos do Agents Toolkit incluem um ambiente pré-configurado local com ./env/.env.local arquivos and ./env/.env.local.user . Essa configuração permite que você execute seu agente ou aplicativo em um servidor Web local e depure-o com pontos de interrupção no Visual Studio Code (para agente ou aplicativo JavaScript, TypeScript ou Python) ou Visual Studio (para agente ou aplicativo CSharp).

Para diferenciar entre um ambiente local e todos os outros ambientes, você pode criar um arquivo 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 Agents Toolkit configura os seguintes ambientes padrão:

• ambiente local para representar a configuração do ambiente da máquina local.
• de desenvolvimento para representar a configuração do ambiente remoto ou de nuvem.

Para criar um novo ambiente:

1. Abra seu espaço de trabalho de agente ou projeto de aplicativo do Teams no Visual Studio Code.

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

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

   

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

   

Direcionando um ambiente para compilação remota

Ao trabalhar com vários ambientes, você deve selecionar um ambiente de destino para compilar, depurar e visualizar seu agente ou aplicativo no Microsoft Teams. Você pode escolher o ambiente de destino diretamente nas configurações de compilação.

Selecionar um ambiente

Para direcionar o dev ou qualquer outro ambiente personalizado:

1. Na seção Ciclo de vida do Kit de ferramentas de agentes, selecione Provisionar para seu agente ou aplicativo.

   

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

   

O Agents Toolkit provisiona o agente ou aplicativo para o ambiente escolhido. Agora você pode criar seu agente ou aplicativo no ambiente selecionado.

Construir no ambiente selecionado

Depois que o ambiente é selecionado, o Kit de Ferramentas de Agentes provisiona o agente ou aplicativo para esse ambiente. Agora você pode compilar, depurar e executar seu agente ou aplicativo no ambiente selecionado.

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

2. Selecione a opção para depurar e visualizar o agente remoto ou aplicativo no Microsoft Teams.

   

O Agents Toolkit cria o agente ou aplicativo no ambiente para o qual você provisionou. O agente ou aplicativo está disponível para visualização e teste no Teams.

Confira também

• Visão geral do Kit de Ferramentas 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 do aplicativo em um ambiente diferente