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

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

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

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 を . に設定してください。

構成プロパティ

プロパティ	説明	必須	Default	例
`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

開発トンネルによるローカルテスト時:

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

重要

deploymentProjectPath は、CLI がプロジェクトファイルを検索する場所や、.env ファイルなどの環境構成を更新する場所を指定します。

メモ

ローカルテストでDev Tunnelsを使用する場合は、セットアップコマンドを実行する前に、a365.config.json 内の messagingEndpoint をご利用の開発トンネルの URL に置き換えてください。詳細については、開発トンネルを使用したテストを参照してください。