Google Vertex AIをMicrosoft Agent 365に接続する

このガイドを使って、Google Vertex AIエージェントをMicrosoft Agent 365に接続してください。

始める前の準備

  • Agent 365のAI管理者がMicrosoft 365 管理センターで接続を作成できるか確認してください。
  • プラットフォーム管理者にGoogle CloudプロジェクトのIDと地域を尋ねてください。
  • Google Cloud Serviceのアカウントとそのアカウント用のJSONキーを作成しましょう。
  • エージェントが展開されているプロジェクトと地域を使いましょう。

サービス アカウントを作成する

エージェントの発見と管理に必要なVertex AI権限をサービスアカウントに付与します:

aiplatform.reasoningEngines.list
aiplatform.reasoningEngines.get
aiplatform.reasoningEngines.delete

JSONキーには、開く括弧と閉じる括弧を含む完全なサービスアカウントキー文書が含まれていなければなりません。 private_key値だけを入力しないでください。

観測可能性権限の追加

観測可能性データを収集するために、同じサービスアカウントに以下の役割を付与します:

Role 役割ID Purpose
BigQuery データ ビューアー roles/bigquery.dataViewer エクスポートされたトレーステーブルを読み込む
BigQuery ジョブ ユーザー roles/bigquery.jobUser スパンを取得するためのクエリを実行する
モニタリングビューア roles/monitoring.viewer リードリクエストカウントとレイテンシ指標
クラウドトレースユーザー roles/cloudtrace.user Cloud Trace のスパンを表示する

BigQueryの役割は両方必要です。 Data Viewerはテーブルの読み取りを許可し、ジョブユーザーは結果を取得するクエリの実行を許可します。

Google Cloudテレメトリの設定

エージェントをデプロイしたプロジェクトについて:

  1. Vertex AI APIを有効にしてください。
  2. BigQuery APIを有効にしてください。
  3. Cloud Trace APIを有効にしてください。
  4. クラウドモニタリングAPIを有効にしてください。
  5. 展開したエージェントでテレメトリ収集を有効にしてください。
  6. Trace Analytics BigQuery エクスポートを有効にしてください。
  7. trace_analytics_linkデータセットとその_AllSpansビューが存在するか確認してください。

エージェント365はテレメトリ収集やトレースエクスポートを有効にできません。

接続の作成

  1. Microsoft 365 管理センターを開きます。
  2. エージェント>すべてのエージェントを選択します。
  3. 接続プラットフォームで「管理」を選択します。
  4. + Connect a platform を選択し、 Google Vertex AIを選択します。
  5. プロジェクトID、地域、そして完全なサービスアカウントJSONキーを入力してください。
  6. 資格情報を検証します。
  7. 接続を保存します。
  8. 同期エージェントを選択します。

接続を確認する

期待される薬剤が輸入品であることを確認してください。 プロジェクト、リージョン、ロール、API、traceエクスポートが正しく設定されていなければ、接続はエージェントの検証とインポートを行えますが、テレメトリは返されません。

Troubleshoot

症状: 考えられる原因 Resolution
エージェントはインポートしていますが、活動は見当たりません 観察可能性は設定されていません 役割、API、テレメトリ、トレースエクスポートのステップを完了します。
スパンは見られませんが、指標は表示されます BigQueryの役割やtraceエクスポートが欠けています 両方のBigQueryロールを付与し、traceエクスポートを有効にしてください。
クエリは失敗しますが、テーブルは読み取れます roles/bigquery.jobUser がありません サービス アカウントに BigQuery ジョブユーザー ロールを付与します。
リクエスト数やレイテンシの指標はありません モニタリングロールやAPIが欠けています モニタリングビューアを付与し、クラウドモニタリングAPIを有効にしてください。
_AllSpans 存在しない Trace AnalyticsのBigQueryエクスポートは有効になっていません エクスポートを有効にしてデータセットとビューを確認しましょう。
エージェントはインポートしますが、テレメトリは空です 接続範囲がデプロイメントの範囲と一致しません デプロイされたエージェントのプロジェクトと地域を活用してください。

Google Vertex AIに特有でない接続問題については、「 接続プラットフォームのトラブルシューティング」をご覧ください。

  • 最終更新: