Oracle Cloud Infrastructureドキュメント

レスポンスAPIツール

OCI Generative AIはResponses APIのツールをサポートし、サポートされているモデルがレスポンス生成時に統合ツールを使用できるようにします。モデルがデータから関連コンテンツを取得したり、Pythonコードを実行したり、アプリケーション定義関数をコールしたり、リモートMCPサーバーによって公開されるツールを使用できるように、Responses APIリクエストのtoolsプロパティにツール定義を追加します。

ツール・サポートは、APIでのみ使用可能です。要求に応じて、モデルは構成済みツールのいずれかを使用するかどうかを決定できます。必要に応じて、tool_choiceプロパティを使用してツールの動作をガイドすることもできます。
たとえば、次のリクエストでは、toolsプロパティにツールが追加されます。
response = client.responses.create(
    model="openai.gpt-oss-120b",
    tools=[
        {
            "type": "file_search",
            "vector_store_ids": ["<vector_store_id>"]
        }
    ],
    input="Summarize the main ideas in these documents."
)
  • ファイル検索

    ファイル検索を使用して、モデルがレスポンス生成時にベクトル・ストアから関連コンテンツを取得できるようにします。これは、組込みの知識のみに依存するのではなく、ドキュメントを使用してモデルに回答させる場合に役立ちます。

  • コードインタプリタ

    コード・インタプリタを使用して、モデルがOCI管理のサンドボックスでPythonコードを記述して実行できるようにします。これは、計算、データ分析、ファイル処理およびその他の計算負荷の高いタスクに役立ちます。

  • 関数呼び出し

    アプリケーションでツール・ロジックを定義して実行する場合は、関数コールを使用します。モデルは関数名と引数を返し、アプリケーションは関数を実行してから、ワークフローを続行できるように関数出力を送り返します。

  • MCPコール

    MCP Callingを使用して、リクエスト中にリモートMCPサーバーでホストされるOCI生成AIコール・ツールを直接使用できるようにします。これにより、プラットフォームは追加のアプリケーション・ラウンド・トリップを必要とせずにMCPサーバーと通信するため、クライアント側のオーケストレーションが削減されます。