AIエージェントのインポート用にGoogle Vertex AIを構成する

Google Vertex AIからAIエージェントをインポートするには、Google CloudコンソールでOAuth 2.0クライアントを作成する必要があります。その後、クライアント資格情報を取得し、テストユーザーアクセスを構成します。

これらの構成が完了したら、「アプリのAIエージェントのインポートを有効にする」の手順に従います。

OAuth 2.0クライアントを作成する

Google Cloudコンソールに、ターゲットプロジェクトに割り当てられているエディターまたはAIプラットフォームのエディターとしてサインインします。
ダッシュボード上部のドロップダウンメニューからターゲットプロジェクトを選択します。
APIとサービス（APIs & Services） > クライアント（Clients）に移動します。
+ クライアントを作成（+ Create client）を選択します。
アプリケーションタイプ（Application type）をWebアプリケーション（Web application）に設定します。
クライアントにわかりやすい名前を入力します（例：Vertex-Agent-Import-Client）。
認可されたリダイレクトURI（Authorized redirect URIs）で、URIを追加（Add URI）を選択し、次のコールバックURLを入力して、{domain}をOkta orgのルートURLに置き換えます。
```
{domain}/oauth2/v1/sts/callback
```
作成（Create）をクリックします。
OAuthクライアントが作成されました（OAuth client created）ダイアログで、クライアントID（Client ID）とクライアントシークレット（Client Secret）の値をコピーして、安全な場所に保存します。
注:
Oktaでアプリの構成を完了するには、これらの値が必要になります。

テストユーザーアクセスを構成する

APIとサービス（APIs & Services） > OAuth同意画面（OAuth consent screen）に移動します。
オーディエンス（Audience）タブを選択します。
構成済みのユーザータイプに基づいて、次のいずれかの手順を完了します。
- ユーザータイプが外部（External）の場合：ユーザーをテストする（Test users）セクションまでスクロールし、+ ユーザーを追加する（+ Add Users）を選択して、アクセスを必要とするアカウントのメールアドレスを入力します。
- ユーザータイプが内部（Internal）の場合：追加の構成は必要ありません。Google Workspace orgのすべてのユーザーにアクセス権があります。

統合をテストする

OAuthの構成が完了したら、以下の検証手順を実行して、Oktaがユーザーを認証し、Google Vertex AIからAIエージェント応答を取得できることを確認します。

Okta OIDCアプリに対する認可ハンドシェイクを完了させて、有効なユーザーIDトークンを生成します。ターミナルで、Pythonオーケストレータースクリプトを実行します。
```
python3 main_vertex.py
```
スクリプトが検証済みのアクセストークンと短時間のみ有効なGoogle Cloudベアラートークンを出力することを確認します。
スクリプトは、HTTP POSTリクエストをGoogle Vertex AIセッションレジストリに送信し、セッションを初期化します。
```
POST https://{GCP_LOCATION}-aiplatform.googleapis.com/v1/projects/{GCP_PROJECT_ID}/locations/{GCP_LOCATION}/reasoningEngines/{GCP_REASONING_ENGINE_ID}/sessions
```
セッションが正常に作成されると、一意のセッションリソースIDが返されます。
スクリプトは、会話形式のプロンプトをセッションルーターに送信します。
```
POST .../sessions/{session_id}:appendEvent
```
プロンプトは、セッション履歴にUSERイベントとして登録されます。
スクリプトは、GETリクエストを使ってエージェント応答をポーリングします。
```
GET https://{GCP_LOCATION}-aiplatform.googleapis.com/v1beta1/projects/{GCP_PROJECT_ID}/locations/{GCP_LOCATION}/reasoningEngines/{GCP_REASONING_ENGINE_ID}/sessions/{session_id}/events
```
スクリプトは、authorがAGENTまたはASSISTANTであるイベントで返されたsessionEvents配列をスキャンして、応答テキストを表示します。

実行が成功すると、次のような出力が生成されます。

Enter custom prompt for vertex ai: Hello
Initializing identity validation against Okta...
Identity verified and access_token generated successfully via Okta!
Minting short-lived Google Cloud platform bearer token...
Forwarding request to Google Vertex AI Reasoning Engine...

=================== VERTEX REASONING ENGINE RESPONSE ===================
Raw Events Payload for analysis:
{
  "sessionEvents": [
    {
      "name": "projects/575096167212/locations/us-west1/reasoningEngines/7643954369880129536/sessions/6809070451898187776/events/5066757525928411136",
      "author": "USER",
      "content": {},
      "invocationId": "inv-e66fb2c3",
      "actions": {},
      "timestamp": "2026-06-15T22:56:34Z",
      "rawEvent": {
        "text": "Hello"
      }
    }
  ]
}
=========================================================================

次の手順

アプリのAIエージェントのインポートを有効にする