Agent 訊息傳送端點，是您用來將 Agent 通知訊息傳送給該 Agent 的端點。
刪除 Agent 訊息傳送端點
請使用 a365 cleanup blueprint --endpoint-only 命令來清除 Agent 訊息傳送端點的註冊。 此命令不會影響您的 Agent 程式碼或已部署的端點。 此命令只會透過 Teams Graph (MCP Platform) 移除該註冊項目。
a365 cleanup blueprint --endpoint-only
在 a365.config.json 中設定訊息傳送端點
設定訊息傳送端點之前，請先在您的 a365.config.json 設定檔中指定該端點。 此檔案包含 Agent 部署的核心設定。
新增或更新下列訊息傳送端點設定屬性：
{
"messagingEndpoint": "https://your-endpoint-url.com/api/messages",
"deploymentProjectPath": "."
}
messagingEndpoint：指定可用來將訊息傳送給 Agent 的確切端點 URL。deploymentProjectPath：Agent 專案目錄的路徑。 如果您的 Agent 已經部署，且不需要更新環境設定，則此屬性不適用。 只有在 Agent 程式碼不在您本機電腦上時，才需要將deploymentProjectPath設為.。
設定屬性
| 屬性 | 描述 | 必要 | 預設 | 範例 |
|---|---|---|---|---|
messagingEndpoint |
Agent 接收訊息的 URL | 是 | 無 | https://your-app.azurewebsites.net/api/messages |
deploymentProjectPath |
用於更新設定的 Agent 專案目錄路徑 | 否 | . |
./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 中，以您的 Dev Tunnel URL 更新 messagingEndpoint，再執行設定命令。 如需詳細資訊，請參閱使用 Dev Tunnels 進行測試。
設定 Agent 訊息傳送端點
更新 a365.config.json 檔案後，請使用此命令註冊訊息傳送端點，讓 Agent 365 服務能夠將通知傳送給您的 Agent。
--endpoint-only 作業會透過 Teams Graph (MCP Platform) 註冊端點。
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 端點，之後再將 Agent 部署至雲端。 如需詳細資訊，請參閱使用 Dev Tunnels 進行測試。
若要更新現有的端點 URL：
a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages
端點部署
如果您尚未將 Agent 部署到雲端，請了解如何將 Agent 部署至 Azure。
如果您已將 Agent 部署到雲端，可以依照前述方式設定訊息傳送端點。
了解如何在其他常見雲端上設定訊息傳送端點：