エージェントメッセージングエンドポイント

エージェントメッセージングエンドポイントは、エージェントにエージェント通知メッセージを送信するエンドポイントです。

エージェントメッセージングエンドポイントを削除

a365 cleanup blueprint --endpoint-only コマンドを使用して、エージェントメッセージングエンドポイントの登録をクリアします。このコマンドはエージェントコードやデプロイされたエンドポイントには影響しません。登録エントリのみが削除されます。

M365 エージェント (Teams、Copilot) の場合は、--m365 を渡して、Teams Graph 経由でエンドポイントをクリアします。

# 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`	エージェントがメッセージを受け取るURLです	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（Google Cloud Platform）: https://your-cloud-run-url.run.app/api/messages
その他のクラウドプロバイダー:カスタムエンドポイントURL

Dev トンネルを使用したローカルテストの場合:

開発者トンネルのURL: https://abc123xyz.devtunnels.ms:3978/api/messages

Important

deploymentProjectPathはCLIがプロジェクトファイルをどこで探し、環境設定(.envファイルなど)をどこで更新するかを指定します。

Note

ローカルテストに Dev Tunnel を使用する場合は、セットアップコマンドを実行する前に、messagingEndpoint内のa365.config.jsonを Dev Tunnel URL で更新します。詳細については、 Dev Tunnelsによるテストをご覧ください。