OCIレスポンスAPI
OCIレスポンスAPIは、エージェント・ワークフロー用のOCIネイティブAPIです。
インストール
Python
OCI GenAI Auth Pythonパッケージをインストールします:
pip install oci-genai-authGitHubのOCI GenAI認証パッケージを参照してください。
Java
OCI GenAI Auth Java SDK on GitHub を参照してください。
OCIレスポンスAPIについて
OCIレスポンスAPIを使用すると、エージェント・ワークロードをサポートするためのモジュラ・プリミティブを作成できます。これらの機能は、リクエスト・レベルで構成できます。
- オーケストレーション: シングルステップ推論またはマルチステップのエージェント・ワークフローを実行します
- 理由付け: 理由付けを有効または無効にします。
- プラットフォーム管理ツール、クライアント側機能ツール、またはその両方を使用するためのツール
- 会話状態: サービス側またはクライアント・アプリケーションの状態を管理します。
このアプローチでは、次のものが提供されます。
- 同じAPIを使用して、シンプルなアシスタントや複雑なマルチステップ・エージェントを構築する柔軟性
- コスト、レイテンシおよび動作を制御する精度
- ツールを個別のクラウド・リソースとして作成および管理する必要がないため、シンプルさ
ベースURL
OCIレスポンスAPIは次のベースURLで使用します。
https://inference.generativeai.<available-region>.oci.oraclecloud.com/openai/v1<available-region>をgenerativeai.us-chicago-1などのリージョン識別子に置き換えます。
使用可能なリージョンについては、エージェントAPIの使用可能なリージョンを参照してください。
サポートされているSDKおよびフレームワーク
OCIレスポンスAPIは、OpenAI SDKとともに使用できます。また、互換性のあるクライアント側エージェント・フレームワークとともに使用することもできます。
OpenAI SDKでは、次の言語がサポートされています:
- Python
- Java
- TypeScript
- 移動
- .NET
コミュニティ・ライブラリを通じて、より多くの言語サポートを利用できます。
互換性のあるエージェント・フレームワークは次のとおりです。
- OpenAIエージェントSDK (推奨)
- OpenAIコーデックスSDK
- Microsoft Agentフレームワーク
- LangChain
- LangGraph
- CrewAI
- AutoGen
- LlamaIndex
- ピダンティック
OCI Responses APIとチャット完了の比較
| ディメンション | OCIレスポンスAPI | チャット完了APIを使用したOCIチャットAPI |
|---|---|---|
| 主用途 | モデル・インタラクションとエージェント機能のための統合API | モデル・インタラクションのためのAPI |
| 最適 | 対話型チャット、エージェントのワークロード、長時間実行タスク | 対話型のチャットボットとテキスト補完 |
| オーケストレーション | 組み込みのマルチステップ推論と複数のツールコール | 単一ステップの推論または生成。マルチステップ・フローでは外部オーケストレーションが必要 |
| コンテキスト管理 | デフォルトではステートフル(オプションのステートレス使用) | ステートレスのみ。クライアントは会話履歴を管理します。 |
| ツールのサポート | ファイル検索、コード・インタプリタ、リモートMCPなどの組込みツール | 関数呼び出しによるクライアント側のツールに限定 |
| マルチモーダルサポート | テキスト、イメージ、ファイルおよび構造化コンテンツ・ブロックのネイティブ・サポート | 主にテキストで、モデル・バージョンに応じてマルチモーダル・サポートが限定されます。 |
| ストリーミング | ファイングレイン・イベントによるイベントベースのストリーミング | トークンベースのストリーミング |
| 構造化出力 | ネイティブな構造化出力とJSONスキーマの適用 | JSONモードはサポートされていますが、作成は少なくなっています |
| ファイルとベクトルの統合 | Files APIおよびVector Stores APIとの直接統合 | 個別のオーケストレーションが必要 |
| 拡張性 | ホスト・エージェント、MCPツール、メモリーおよびコンテナ用に設計されています。 | 主にチャット・アプリケーション用に設計されています。 |
OCIレスポンスAPIとOpenAIレスポンスAPIの比較
| 能力 | OCIレスポンスAPI | OpenAIレスポンスAPI |
|---|---|---|
| モデル選択 | OCIでホストされるモデルとOpenAI以外のモデルをサポート | OpenAIモデルのみ |
| モデル・サービス・インフラストラクチャ | OCI共有インフラストラクチャまたは専用AIクラスタ | OpenAI共有インフラストラクチャ |
| 認証 | OCI IAMまたはAPIキー | APIキー |
| データ保持 | データはOCIに残ります | データはOpenAIに格納されます。 |
| プライベート・ネットワーク | OCI VCN統合およびプライベート・エンドポイントをサポートします。 | 使用不可 |
| エンドポイント・モデル | リージョン・エンドポイント | グローバル・エンドポイント |
推奨事項
OpenAI SDKは次の場合に使用します。
- ファンクション・ツールを編成するためにクライアント側のフレームワークは必要ありません。
- ツールは、リモートMCPツールを含むサーバー側で実行されます。
- 会話APIを使用して、セッション・メモリーを管理します。
- アプリケーションは、複雑なバックエンドなしで、モバイル・アプリケーションや静的サイトなどのよりシンプルなインタフェースです
次の場合に、OpenAI SDKでエージェント・フレームワークを使用します。
- クライアント側の機能ツールを編成する必要があります。
- ローカル・シェルやファイル・システム・アクセスなどのクライアント側の実行機能が必要です。
- クライアント側で複数のエージェントを調整する必要があります。
- セッション・メモリーは、独自のソリューションまたはサードパーティ・システムを使用して管理します。