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

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",
  "needDeployment": false,
  "deploymentProjectPath": "."
}

messagingEndpoint: エージェントにメッセージを送れる正確なエンドポイントURLを指定します。
needDeployment: Azure Web アプリにコードをデプロイするかどうかを CLI に示します。
deploymentProjectPath: エージェントコードをクラウドにデプロイしてください。エージェントがすでに展開されていて再度デプロイする必要がない場合は、このプロパティは関係ありません。エージェントコードが自分のマシンに存在しない場合のみdeploymentProjectPath.に設定してください。

構成プロパティー

プロパティ	Description	必須	既定値	Example
`messagingEndpoint`	エージェントがメッセージを受け取るURLです	イエス	None	`https://your-app.azurewebsites.net/api/messages`
`needDeployment`	CLI を Azure (`true`) にデプロイする必要があるか、自己ホスト (`false`) を行うか	いいえ	`true`	`false` AWS/GCP/開発トンネル用
`deploymentProjectPath`	デプロイや設定の更新のためのエージェントプロジェクトディレクトリへのパス	いいえ	`.`	`./my-agent` または `.`

エンドポイントの設定オプション

messagingEndpoint値は展開シナリオによって異なります:

Azure 展開の場合 (needDeployment: true):

Azure Web アプリ: https://your-app-name.azurewebsites.net/api/messages

非Azure展開の場合 (needDeployment: false):

Aws： https://your-api-gateway-url.amazonaws.com/api/messages
GCP（Google Cloud Platform）: https://your-cloud-run-url.run.app/api/messages
その他のクラウドプロバイダー:カスタムエンドポイントURL

開発トンネル(needDeployment: false)によるローカルテストの場合:

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

Important

Azureにデプロイする場合は、needDeployment を true に設定します。 CLIは自動的に展開を処理します。
AWS、GCP、またはDev Tunnelsでは、 needDeployment を false に設定して、展開を別途管理していることを示します。
deploymentProjectPathはCLIがプロジェクトファイルをどこで探し、環境設定(.envファイルなど)をどこで更新するかを指定します。

注

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