Agent Platform セッションでは、ユーザーとエージェント間のやり取りの履歴が保持されます。セッションは、長期記憶と会話のコンテキストの明確なソースを提供します。
Agent Platform セッションを使用するには、次の方法があります。
Agent Development Kit(ADK): ADK エージェントを Gemini Enterprise Agent Platform にデプロイすると、セッション管理が自動的に処理されます。
API 呼び出し: ADK エージェントを使用してセッションを管理しない場合は、Agent Platform Sessions に直接 API 呼び出しを行うことができます。
基本コンセプト
セッション: セッションは、ユーザーとエージェント システム間の一つの会話の流れにおけるメッセージとアクション(イベント)の時系列を表します。
イベント: イベントには、会話の内容のほか、関数呼び出しなどのエージェントが実行したアクションが保存されます。イベントは、カスタムデータやさまざまなフレームワークに対応する柔軟なスキーマをサポートしています。
状態: 状態は、現在の会話中のみに関連する一時データを保持します。
記憶: 特定のユーザーの複数のセッションでアクセスできるパーソナライズされた情報です。エージェントは記憶を使用してユーザーへの回答をパーソナライズし、セッション間の継続性を確保できます。
コア機能
Agent Platform セッションのコア機能は次のとおりです。
新しい会話を開始する: ユーザーがエージェントとのやり取りを開始したときに、新しいセッションを作成します。
既存の会話を再開する: 特定のセッションを取得して、エージェントが一時停止した会話を再開できるようにします。
進行状況の保存: セッションの履歴に新しいインタラクション(イベント)を追加して、セッションを更新します。
会話のリスト: 特定のユーザーとアプリケーションのアクティブなセッション スレッドを見つけられます。
クリーンアップ: 会話が終了したときや不要になったときに、セッション オブジェクトとそれに関連付けられたデータを削除します。
エンタープライズ セキュリティとガバナンス
Agent Platform Sessions は、エンタープライズ セキュリティ管理をサポートしており、会話履歴、セッション状態、イベントを不正アクセスやデータ漏洩から保護できます。
VPC Service Controls(VPC Service Controls)
Agent Platform Sessions は、セッション データと会話イベントのデータ引き出しのリスクを軽減するために、VPC Service Controls をサポートしています。sessions と events は、Agent Platform API(aiplatform.googleapis.com)を介して提供される Agent Runtime(reasoningEngines)インスタンスの子リソースであるため、Agent Platform API を VPC Service Controls サービス境界に追加すると、すべてのセッション オペレーション(CreateSession、GetSession、ListSessions、UpdateSession、DeleteSession、AppendEvent、ListEvents)が保護されます。
Sessions の VPC Service Controls を構成する場合は、次のガイドラインに従ってください。
- 境界の構成: Agent Platform API(
aiplatform.googleapis.com)を VPC Service Controls のサービス境界に追加します。セッションをホストする親 Agent Runtime インスタンスを作成する前に、プロジェクトがサービス境界に追加されていることを確認します。 - プライベート エンドポイント接続: VPC ネットワークから
restricted.googleapis.com(199.36.153.4/30)または Google API の内部 Private Service Connect エンドポイントを介して、LOCATION-aiplatform.googleapis.com(グローバル エンドポイントの場合はaiplatform.googleapis.com)にリクエストを転送します。 - サービス境界で Agent Gateway と Sessions を使用する: Agent Runtime にデプロイされたエージェントが、Agent-to-Anywhere(外向き)モードで適用される Agent Gateway にバインドされている場合、エージェントから Sessions へのアウトバウンド API 呼び出しはゲートウェイを通過します。境界またはゲートウェイのブロックを回避するには:
vpcEgressをALL_TRAFFICに設定したエージェント接続テンプレート(AgentConnectivityTemplate)と、googleapis.com.のプライベート Cloud DNS ピアリングを使用して、ゲートウェイを構成します。詳細については、Agent Gateway の VPC Service Controls コンプライアンスをご覧ください。- エージェントが Sessions エンドポイント(
https://LOCATION-aiplatform.googleapis.com/API_VERSION/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/sessions)を呼び出せるように、Agent Registry にリージョン エンドポイントと mTLSAgent Platform APIエンドポイントを登録して許可リストに登録し、エージェント ID に IAP Egressor(roles/iap.egressor)ロールを付与します。詳しい手順については、Agent Gateway を介して Agent Runtime トラフィックをルーティングするをご覧ください。
顧客管理の暗号鍵(CMEK)
デフォルトでは、 Google Cloud は Google-owned and Google-managed encryption keysを使用して、保存されているセッション状態と会話イベントを暗号化します。Cloud Key Management Service(Cloud KMS)で管理する鍵を使用してセッション データを保護するには、親 Agent Runtime インスタンスを作成するときに encryption_spec(kms_key_name)を指定します。そのインスタンスに保存されているすべてのセッションとイベントは、CMEK 構成を継承します。一般的なプロジェクトと鍵の設定手順については、Gemini Enterprise Agent Platform の CMEK をご覧ください。
Sessions で CMEK を使用する場合は、次の制限事項が適用されます。
- グローバル エンドポイントとデプロイされたランタイムの制限: Sessions が
globalエンドポイント(location="global")を使用するように構成されている場合、CMEK は使用できません。Cloud Key Management Service では、暗号鍵が地理的なデータ所在地の境界内に存在する必要があるためです。CMEK を使用するには、サポート対象の地域またはマルチリージョンのロケーションに、一致する Cloud KMS 鍵を使用してスタンドアロンの親インスタンスを作成します(エージェント ランタイム コードはデプロイしません)。マルチリージョン インスタンスの場合は、usにはus鍵、euにはeurope鍵を使用します。親インスタンスが Agent Runtime にエージェントもデプロイする場合は、単一リージョンのロケーションを使用する必要があります。デプロイされたランタイムは、マルチリージョン エンドポイント(usまたはeu)で CMEK をサポートしていないためです。 - 暗号鍵を更新できない: Cloud KMS 鍵を使用してインスタンスを作成すると、そのインスタンスの鍵を変更することはできません。別の鍵を使用するには、新しいインスタンスを作成する必要があります。