Interactions API の概要

Interactions API は、Gemini Enterprise Agent Platform でホストされている Gemini モデルと Agentic Workflows を使用して、生成 AI アプリケーションとエージェント ワークフローを構築するための統合されたステートフル インターフェースを提供します。既存の generateContent API と機能が重複していますが、generateContent API は引き続き完全にサポートされます。

Interactions API を使用する理由

Interactions API には、生成 AI アプリケーションと Agentic Workflows を構築するうえで、次のような重要なメリットがあります。

  • モデルとエージェント用の単一の API: 標準の Gemini モデルと、特殊なエージェント（Gemini Deep Research Agent やカスタム マネージド エージェントなど）を直接呼び出すための統合されたエンドポイントとパターン。
  • すぐに使える新機能: previous_interaction_id を使用したオプションのサーバーサイド会話状態、デバッグと UI レンダリング用のオブザーバブル実行ステップ、background=true を使用した長時間実行タスクのバックグラウンド実行などの機能。
  • 新機能のリリース: 今後、すべての新しいモデル、マルチモーダル機能、ツール、エージェント機能は、Interactions API でサポートされます。

Interactions API の仕組み

Interactions API は Interaction リソースを中心に構成されています。Interaction は、会話またはタスクの完全なターンを表し、実行 steps の時系列シーケンスを含むセッション レコードとして機能します。

  • user_input: ターンに提供される入力メッセージ、マルチモーダル ファイル、ツール結果。interactions.get で取得された保存済みのインタラクションには、完全なコンテキストの user_input ステップが含まれます。一方、interactions.create レスポンスは、そのターン中に生成されたステップのみを返します。
  • thought: モデルまたはエージェントがレスポンスを計画する際に生成される中間推論の要約。
  • ツール呼び出しと結果のステップ: クライアントサイドまたはサーバーサイドのツール呼び出しと出力（function_call や function_result など）。
  • model_output: モデルまたはエージェントによって生成された最終的なテキスト、構造化 JSON、またはマルチモーダル コンテンツ。

interactions.create を呼び出すと、Agent Platform は入力を処理し、構成されたサーバーサイド ツールまたはエージェント ループを実行して、結果の Interaction リソースを返します。Python、TypeScript/JavaScript、REST のコードサンプルについては、Interactions API デベロッパー ガイドをご覧ください。

サポートされているモデル

次の Gemini モデルは Interactions API をサポートしています。

クリックして、サポートされているモデルを開く

上記のモデルに加えて、Interactions API は、次の特殊なマルチモーダル モデルと音声生成ツールをサポートしています。

  • gemini-omni-flash-preview: 会話型動画の生成、編集、シネマティックな制御のための高性能マルチモーダル モデル。
  • lyria-3-clip-preview と lyria-3-pro-preview: 高音質の音声クリップとフルソングの作曲用の生成音楽モデル（store=false を使用したステートレス インタラクションでのみサポート）。

サポートされているエージェント

model ではなく agent パラメータを指定することで、Interactions API を介して次のエージェントを呼び出すことができます。

  • antigravity-preview-05-2026: 複数ステップの推論、コーディング、ファイル オペレーション、ツールの使用のために設計された汎用自律エージェント。
  • deep-research-preview-04-2026: 自律的なマルチステップのウェブリサーチと合成用に設計された Gemini Deep Research エージェント。
  • Agent Platform にデプロイされたカスタム マネージド エージェント。

機能と仕様

以降のセクションでは、Interactions API のコア機能、技術仕様、運用上の考慮事項について説明します。

状態管理

デフォルトでは、Interactions API はリクエストを保存するため、previous_interaction_id を使用してサーバーサイドの状態管理機能を利用できます。store=false を設定すると、ステートレスな動作を有効にできます。

サポートされているツールとグラウンディング

Interactions API の Gemini 3 モデルでは、次の組み込みツール、グラウンディング プロバイダ、検索機能がサポートされています。

  • Google 検索によるグラウンディングとWeb Grounding for Enterprise: Google 検索または Web Grounding for Enterprise からのリアルタイムのウェブ情報を使用して、モデルのレスポンスをグラウンディングします。
  • Gemini Enterprise Agent Platform の Agent Search と RAG Engine: Agent Search と RAG Engine を使用して、非公開のエンタープライズ データストアとドキュメント リポジトリに対してモデルの回答をグラウンディングします。
  • xAI Search: モデルをリアルタイムのソーシャル検索とナレッジ グラウンディングに接続します。
  • パラレル検索: Parallel Web Systems の検索 API から提供されるリアルタイムの公開ウェブデータを使用して、モデルの回答をグラウンディングします。
  • コード実行: モデルが安全なサンドボックス環境で Python コードを生成して実行できるようにします。
  • 関数呼び出し: 構造化された関数引数を返すことで、モデルが外部ツール、API、データベースに接続できるようにします。

Interactions API は、Enterprise 向けウェブ グラウンディングと Google 検索によるグラウンディングをサポートしています。これらの機能のご利用には、サービス固有の規約も適用されます。

課金

Interactions API の使用料金は、トークンの使用量に基づいて請求されます。

中断されたリクエストまたは処理されなかったリクエストの請求は、次のように処理されます。

  • 手動キャンセル: 完了前にインタラクションがキャンセルされた場合（キャンセル リクエストの送信など）、キャンセルまでに消費されたトークンに対して課金されます。
  • 失敗したリクエスト: 内部システム エラーまたはバックエンドの障害が原因でインタラクション リクエストが失敗した場合、失敗したリクエストに対して課金されることはありません。

セキュリティとコンプライアンス

プレビュー版では、Interactions API には次のセキュリティ、コンプライアンス、データ所在地に関する考慮事項があります。

  • セキュリティとコンプライアンスの認証: Interactions API プレビューは FedRAMP をサポートしておらず、国防総省（DoD）影響レベル 5（IL5）または国際武器取引規則（ITAR）の要件に準拠していません。
  • 顧客管理の暗号鍵（CMEK）: Interactions API は、us と eu のマルチリージョンでサービング プロファイル（scope が INTERACTIONS_API に設定されている）を介して、保存されたインタラクション データの CMEK をサポートしています。
  • VPC Service Controls: Interactions API プレビューは、API 境界を保護するための VPC Service Controls（VPC-SC）をサポートしています。
  • データ所在地: Interactions API プレビューはデータ所在地をサポートしておらず、セッション ストレージに関するコミットメントもありません。
  • エンドポイント: Interactions API プレビューは、グローバル エンドポイント（locations/global）をサポートしています。また、CMEK を使用する場合は、us と eu のマルチリージョン エンドポイント（locations/us と locations/eu）をサポートしています。

サポートされている SDK

Interactions API には、統合された Google Gen AI SDK または直接の REST 呼び出しを使用してアクセスできます。

  • Python: google-genai バージョン 2.3.0 以降
  • TypeScript / JavaScript: @google/genai バージョン 2.3.0 以降
  • Go: google.golang.org/genai
  • Java: com.google.genai:google-genai

以前の SDK（google-cloud-aiplatform、@google-cloud/vertexai、google-generativeai）は Interactions API をサポートしていません。

次のステップ