使用 Microsoft 365 Agents Toolkit (以前是 Teams 工具包) 生成代理或应用通常意味着在本地、开发人员或操场等不同目标中运行同一项目。 在重复使用相同的项目结构和生命周期命令时，环境使每个目标保持独立。 代理工具包存储特定于环境的设置 in .env.<environment-name> 文件。 每个文件捕获该目标的变量和输出，因此你可以预配、部署和发布，而无需每次重新配置资源。
在本文中，你将了解这些环境文件的工作原理、本地环境和远程环境的不同之处、如何为代理或应用项目添加新环境，以及如何为工作流定位特定环境。
将环境文件与代理工具包配合使用
代理工具包遵循环境文件的标准命名模式，例如 .env.{environment-name}。 运行 “预配”、“ 部署”或 “发布”等生命周期命令时，必须指定环境名称。 此名称必须与相应环境文件中使用的 匹配 {environment-name} 。
注意
可以在当前 shell 环境中为 Agents Toolkit 定义环境变量，这会在命名冲突期间替代文件中的任何 .env 值。
环境文件位置
默认情况下，代理工具包不会加载环境变量，只是执行操作，将输出保存到 ./env/.env.dev。 如果未指定 ， environmentFolderPath则它不会从 .env 文件读取变量，并假定环境设置为 dev，并且输出将定向到 ./env/.env.dev。
本地环境
构建Microsoft Teams 代理或应用涉及云和本地资源。 云资源包括应用注册和 Teams 客户端，而代理或应用逻辑可以在本地运行以加快开发和测试速度。 所有代理工具包模板都包括带有 ./env/.env.local 和 ./env/.env.local.user 文件的预配置local环境。 通过此设置，可以在本地 Web 服务器上运行代理或应用，并使用适用于 JavaScript、TypeScript 或 Python 代理的 Visual Studio Code (中的断点对其进行调试，或者使用适用于 CSharp 代理或应用) 的应用) 或 Visual Studio (进行调试。
若要区分本地环境和所有其他环境，可以在与 相同的目录中m365agents.yml创建名为 m365agents.local.yml 的单独项目文件。
在 Visual Studio Code 中手动创建新环境
每个项目可以有一个本地环境和多个远程环境。 创建项目后，Agents Toolkit 将配置以下默认环境：
- 用于 表示本地计算机环境配置的本地环境。
- 用于 表示远程或云环境配置的开发环境。
若要创建新环境，请执行以下操作：
在 Visual Studio Code 中打开 Teams 代理或应用项目工作区。
从Visual Studio Code活动栏中选择“Microsoft 365 代理工具包”图标。
选择“+环境”部分中的图标。
输入环境的名称，然后选择 Enter。
面向远程生成环境
使用多个环境时，必须选择目标环境，以在 Microsoft Teams 中生成、调试和预览代理或应用。 可以直接从生成设置中选择目标环境。
选择环境
若要面向开发人员或任何其他自定义环境，请执行以下操作：
在“代理工具包”的 “生命周期 ”部分中，选择“为代理或应用 预配 ”。
出现提示时，选择其中一个可用环境 (
dev或自定义环境) 。
代理工具包为所选环境预配代理或应用。 现在可以在所选环境中生成代理或应用。
在所选环境中生成
选择环境后，代理工具包会为该环境预配代理或应用。 现在可以在所选环境中生成、调试和运行代理或应用。
从
Visual Studio Code边栏中选择“运行和调试”图标。选择调试和预览 Microsoft Teams 中的远程代理或应用的选项。
代理工具包在已预配的环境中生成代理或应用。 代理或应用可用于在 Teams 中查看和测试。