智能体消息传递端点是您向智能体发送智能体通知消息的端点。
删除智能体消息传递端点
使用 a365 cleanup blueprint --endpoint-only 命令清除智能体消息传递端点的注册信息。 此命令不会影响您的智能体代码或已部署的端点。 它仅通过 Teams Graph（MCP 平台）移除注册条目。
a365 cleanup blueprint --endpoint-only
在 a365.config.json 中配置消息端点
在设置消息端点之前，请先在 a365.config.json 配置文件中指定该端点。 该文件包含智能体部署的核心配置。
添加或更新以下消息端点配置属性：
{
"messagingEndpoint": "https://your-endpoint-url.com/api/messages",
"deploymentProjectPath": "."
}
messagingEndpoint：指定可用于向智能体发送消息的确切端点 URL。deploymentProjectPath：智能体项目目录的路径。 如果您的智能体已部署且无需更新环境配置，则此属性不适用。 仅当智能体代码未位于您的机器上时，才将deploymentProjectPath设置为.。
配置属性
| 属性 | 说明 | 必选 | 默认 | 示例 |
|---|---|---|---|---|
messagingEndpoint |
智能体接收消息的 URL | 可以 | 无 | https://your-app.azurewebsites.net/api/messages |
deploymentProjectPath |
用于配置更新的智能体项目目录路径 | 否 | . |
./my-agent 或 . |
端点配置选项
messagingEndpoint 的值取决于您的部署场景：
对于 Azure 部署：
- Azure Web App：
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 - 其他云服务提供商：您的自定义端点 URL
使用 Dev Tunnels 进行本地测试时：
- Dev Tunnel URL：
https://abc123xyz.devtunnels.ms:3978/api/messages
重要提示
deploymentProjectPath 指定 CLI 查找项目文件的位置以及更新环境配置（例如 .env 文件）的位置。
备注
使用 Dev Tunnels 进行本地测试时，请在运行设置命令前，将 a365.config.json 中的 messagingEndpoint 替换为您自己的 Dev Tunnel URL。 有关详细信息，请参阅使用 Dev Tunnels 进行测试。
设置智能体消息传递端点
更新 a365.config.json 文件后，请使用此命令注册消息传递端点，以便 Agent 365 服务能够向您的智能体发送通知。
--endpoint-only 操作通过 Teams Graph（MCP 平台）注册该端点。
a365 setup blueprint --endpoint-only
您也可以直接通过 --messaging-endpoint 传递 URL，而无需编辑 a365.config.json：
a365 setup blueprint --endpoint-only `
--messaging-endpoint https://your-app.azurewebsites.net/api/messages
在本地测试期间，您可以在将智能体部署到云端之前，将此端点设置为 Dev Tunnel 端点。 有关详细信息，请参阅使用 Dev Tunnels 进行测试。
要更新现有端点 URL：
a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages
端点部署
如果您尚未将智能体部署到云端，请了解如何将智能体部署到 Azure。
如果您已将智能体部署到云端，则可以按照前面所示设置消息传递端点。
了解如何在其他一些常用云平台上设置消息传递端点：