type string
出力項目のタイプ。指定できる値:
-
message:モデルの最終的な返信を含むメッセージ。
-
reasoning:推論出力。reasoning.effort が none 以外の値に設定されている場合、または思考モードが有効になっている場合に返されます。推論トークンは output_tokens_details.reasoning_tokens でカウントされ、それに応じて課金されます。
-
function_call:関数呼び出し出力。カスタム function ツールを使用する場合に返されます。関数呼び出しを処理し、結果を返す必要があります。
-
web_search_call:ウェブ検索呼び出し出力。web_search ツールを使用する場合に返されます。
-
code_interpreter_call:コード実行出力。code_interpreter ツールを使用する場合に返されます。
-
web_extractor_call:ウェブ抽出出力。web_extractor ツールを使用する場合に返されます。web_search ツールと併用する必要があります。
-
web_search_image_call:テキストからイメージへの検索呼び出し出力。web_search_image ツールを使用する場合に返されます。見つかったイメージのリストが含まれます。
-
image_search_call:イメージからイメージへの検索呼び出し出力。image_search ツールを使用する場合に返されます。見つかった類似イメージのリストが含まれます。
-
mcp_call:MCP 呼び出し出力。mcp ツールを使用する場合に返されます。MCP サービスからの結果が含まれます。
-
file_search_call:ナレッジベース検索呼び出し出力。file_search ツールを使用する場合に返されます。ナレッジベースからの取得クエリと結果が含まれます。
id string
出力項目の一意の識別子。すべての出力タイプに存在します。
role string
メッセージロール。常に assistant です。type が message の場合にのみ存在します。
status string
出力項目のステータス。指定できる値: completed、in_progress。type が reasoning でない場合に存在します。
name string
ツールまたは関数名。type が function_call、web_search_image_call、image_search_call、または mcp_call の場合に存在します。
web_search_image_call と image_search_call の場合、値はそれぞれ "web_search_image" と "image_search" に固定されます。
mcp_call の場合、値は MCP サービスで呼び出された特定の関数名です (例: amap-maps-maps_geo)。
arguments string
ツール呼び出しの引数。JSON 文字列としてフォーマットされています。type が function_call、web_search_image_call、image_search_call、または mcp_call の場合に存在します。使用する前に JSON.parse() を使用して解析してください。内容はツールのタイプによって異なります:
-
web_search_image_call: {"queries": ["search keyword 1", "search keyword 2"]}。queries フィールドには、ユーザー入力に基づいてモデルが自動的に生成した検索キーワードのリストが含まれます。
-
image_search_call: {"img_idx": 0, "bbox": [0, 0, 1000, 1000]}。img_idx フィールドは入力イメージのインデックスです (0 から始まります)。bbox フィールドには、検索エリアのバウンディングボックス座標 [x1, y1, x2, y2] が含まれ、値の範囲は 0 から 1000 です。
-
function_call:ユーザー定義の関数パラメーターのスキーマに従って生成された引数オブジェクト。
-
mcp_call:MCP サービスで呼び出された関数の引数オブジェクト。
call_id string
関数呼び出しの一意の識別子。type が function_call の場合にのみ存在します。関数呼び出しの結果を返す際に、リクエストと応答を関連付けるためにこの ID を使用します。
content array
メッセージコンテンツ配列。type が message の場合にのみ存在します。
配列要素のプロパティ
type string
コンテンツタイプ。常に output_text です。
text string
モデルによって生成されたテキストコンテンツ。
annotations array
テキストアノテーション。通常は空の配列です。
summary array
推論のまとめ。type が reasoning の場合にのみ存在します。各要素には type フィールド (値は summary_text) と text フィールド (まとめのテキスト) が含まれます。
action object
検索アクション情報。type が web_search_call の場合にのみ存在します。
プロパティ
type string
検索タイプ。常に search です。
sources array
検索ソース。各要素には type フィールドと url フィールドが含まれます。
code string
モデルによって生成および実行されたコード。type が code_interpreter_call の場合にのみ存在します。
outputs array
コード実行出力。type が code_interpreter_call の場合にのみ存在します。各要素には type フィールド (値は logs) と logs フィールド (コード実行ログ) が含まれます。
container_id string
コードインタープリターのコンテナ識別子。type が code_interpreter_call の場合にのみ存在します。同じ会話内で複数のコード実行を関連付けるために使用します。
goal string
抽出の目的の説明で、Web ページから抽出する情報を指定します。type が web_extractor_call の場合にのみ存在します。
output string
ツール呼び出しの出力結果。文字列としてフォーマットされています。
-
type が web_extractor_call の場合、このフィールドには抽出されたウェブページコンテンツのまとめが含まれます。
-
type が web_search_image_call または image_search_call の場合、このフィールドはイメージ検索結果の配列を含む JSON 文字列です。各結果には title (イメージのタイトル)、url (イメージの URL)、および index (序数) フィールドが含まれます。
-
type が mcp_call の場合、このフィールドは MCP サービスから返された JSON 文字列の結果です。
urls array
抽出されたウェブページの URL。type が web_extractor_call の場合にのみ存在します。
server_label string
MCP サービスラベル。type が mcp_call の場合にのみ存在します。この呼び出しに使用された MCP サービスを識別します。
queries array
ナレッジベース取得に使用されたクエリ。type が file_search_call の場合にのみ存在します。各要素はモデルによって生成された検索クエリです。
results array
ナレッジベース取得結果。type が file_search_call の場合にのみ存在します。
配列要素のプロパティ
file_id string
一致したドキュメントのファイル ID。
filename string
一致したドキュメントのファイル名。
score float
関連性スコア。範囲は 0 から 1 です。値が高いほど関連性が高いことを示します。
text string
一致したドキュメントコンテンツのスニペット。