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

Important

Microsoft Agent 365 の早期アクセスを利用するには、フロンティアプレビュープログラムに参加する必要があります。フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。

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

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

a365 cleanup blueprint --endpoint-onlyコマンドを使ってエージェントのメッセージングエンドポイントエントリを削除してください。このコマンドはエージェントコードやデプロイされたエンドポイントには影響しません。あなたのエージェントに対するこのエンドポイントの登録エントリだけが削除されます。

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	必須	既定値	Example
`messagingEndpoint`	エージェントがメッセージを受け取るURLです	イエス	None	`https://your-app.azurewebsites.net/api/messages`
`deploymentProjectPath`	構成の更新のためのエージェントプロジェクトディレクトリへのパス	いいえ	`.`	`./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ファイルなど)をどこで更新するかを指定します。

注

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