代理消息终端

代理消息终端是你向代理发送代理通知消息的终端。

删除代理消息端点

使用 a365 cleanup blueprint --endpoint-only 命令清除代理消息传送终结点的注册。 这个命令不会影响你的代理代码或已部署的终端。 它仅删除注册条目。

对于 M365 智能体（Teams、Copilot），通过 Teams Graph 传递 --m365 来清除终结点：

# M365 agents — clears via Teams Graph (MCP Platform)
a365 cleanup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 cleanup blueprint --endpoint-only

在 a365.config.json 中配置消息端点

在设置消息端点之前，请在配置文件 a365.config.json 中指定它。 该文件包含您的代理部署的核心配置。

添加或更新这些消息端点配置属性：

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

  • messagingEndpoint指定可以向代理发送消息的具体端点URL。

  • deploymentProjectPath：智能体项目目录的路径。 如果代理已部署且不需要更新环境配置，则此属性不相关。 仅当智能体代码未位于您的机器上时，才将 deploymentProjectPath 设置为 .。

配置属性

财产 Description 必选 Default Example
messagingEndpoint 你的代理接收消息的网址 Yes 没有 https://your-app.azurewebsites.net/api/messages
deploymentProjectPath 用于配置更新的代理项目目录路径 No . ./my-agent 或 .

端点配置选项

messagingEndpoint价值取决于你的部署场景：

对于 Azure 部署：

  • Azure Web 应用：https://your-app-name.azurewebsites.net/api/messages

对于非 Azure 部署：

  • AWS：https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP：https://your-cloud-run-url.run.app/api/messages
  • 其他云服务提供商：您的自定义端点网址

对于使用Dev Tunnels进行本地测试：

  • 开发者隧道网址： https://abc123xyz.devtunnels.ms:3978/api/messages

重要

它 deploymentProjectPath 指定了 CLI 在哪里查找项目文件，以及在哪里更新环境配置（如 .env 文件）。

注意

使用 Dev Tunnels 进行本地测试时，请在运行设置命令前，将 a365.config.json 中的 messagingEndpoint 替换为您自己的 Dev Tunnel URL。 关于更多信息，请参见 Dev Tunnels 测试。

设置代理消息端点

更新 a365.config.json 文件后，使用此命令注册消息终结点，以便代理 365 服务可以向代理发送通知。

对于 M365 代理（Teams，Copilot），请将 --m365 传递给 Teams Graph 以进行注册：

# M365 agents — registers via Teams Graph (MCP Platform)
a365 setup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 setup blueprint --endpoint-only

在本地测试期间，你可以先将该端点设置为开发隧道端点，然后再部署到云端。 关于更多信息，请参见 Dev Tunnels 测试。

要更新现有的终结点 URL，请执行以下步骤：

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages --m365

终端部署

如果尚未将代理部署到云，了解如何将代理部署到 Azure。

如果你已经部署了代理到云端，可以像之前展示的那样设置消息端点。

了解如何在其他一些流行的云上设置消息端点：

  • Last updated on