Deploy agent to Azure

重要

你需要是边境预览计划的一部分,才能提前访问 Microsoft Agent 365。 边界将你直接与Microsoft最新的 AI 创新联系起来。 边境预览版受客户协议现有预览条款的约束。 由于这些功能仍在开发中,其可用性和功能可能会随时间而变化。

你已在本地生成代理并对其进行了测试,现在是时候在云中实现它了。 这一步是可选的,如果你已经将代理部署到某些云端(甚至不一定非得是Azure),可以跳过。

本指南将指导你完成将代理代码部署到 Azure 并将其发布到Microsoft管理中心,其中它将成为组织的可发现资产。

还有资源可以展示,如果你已经将代理部署到其他云服务商如AWS或GCP,而不是Azure,如何更新消息端点:

先决条件

在开始之前,请确保具有以下各项:

所需权限和访问权限

  • Azure订阅带贡献者访问权限。
  • 拥有有效且可达的消息端点的可工作代理代码。 请确保你已在本地测试,并验证代理代码是否可构建和运行。
  • 完成 设置代理蓝图步骤 ,才能获得有效的代理蓝图。
  • 确保配置文件a365.config.jsona365.generated.config.json和代码中的配置文件(例如.env文件)都是最新的。

必需工具

部署到 Azure 云

a365 deploy 命令将你的代理部署到设置时创建的 Azure Web 应用中。 它会把你的代理代码上传到 Azure,使其可以在云端运行,并处理针对该端点的任何代理请求。

部署代理

下面是部署命令:

a365 deploy

注释

a365 deploy -h 显示运行该命令的所有选项,包括子命令。

.NET 代理的 deploy 命令:

  • 检测 .NET 项目文件(*.csproj*.fsproj*.vbproj
  • 使用 还原 NuGet 包 dotnet restore
  • 使用 dotnet publish 发布配置发布应用程序
  • 使用入口点 DLL 命令创建 Oryx 清单(例如 dotnet YourApp.dll
  • 根据检测到的 .NET 版本配置 Azure 运行时(默认值: DOTNET|8.0
  • 通过 zip 进行实时部署

警告

机密管理:部署时,环境变量(包括 API 密钥和机密)存储为Azure 应用设置。 虽然环境变量通常用于配置,但它们以纯文本形式存储。 对于生产环境,Microsoft建议对敏感机密使用 Azure 密钥库。 有关详细信息,请参阅在 ASP.NET Core 开发中安全存储应用机密。 请将这些文件视为敏感信息,在任何情况下都不要将它们提交到源代码管理。

验证部署

部署完成后:

  1. 在 Azure 门户中导航到 Web 应用。
  2. 在应用中,转到设置>高级设置
  3. 在部署中心检查部署日志

后续步骤

接下来,将你的代理应用发布到 Microsoft 管理中心,以便从中创建代理实例和用户: 发布代理到 Microsoft 管理中心

您的客服现在已在云端上线,随时准备响应代理请求。 当您的代理处理现实请求时,请考虑代码的以下步骤:

  • 监视性能:使用 可观测性功能 跟踪代理行为并优化响应
  • 添加更多工具:浏览 工具目录 以扩展代理的功能
  • 循环访问和改进:更新代理代码、重新部署和重新发布(请记住递增版本号!)
  • 跨组织进行缩放:分享代理的成功案例以推动采用