cicora.ai
API仕様統一された出力

Responses API

アプリケーションで出力項目と操作を一つのデータモデルとして扱う利点がある場合は、一つのinputオブジェクトを使用します。

連携リファレンス:お使いの環境に合わせて、アカウントのAPI設定とモデルカタログからパラメーターおよび利用可能な機能を選択してください。

応答を作成

Responsesリクエストにはmodelとinputを含めます。inputには短い文字列を指定でき、ワークフローで必要な場合は構造化された項目群も指定できます。

output配列を中心にハンドラーを設計します。テキスト、ツール呼び出し、サービス項目では種類が異なる場合があります。

Responses APIリクエスト
bash
curl --request POST https://cicora.ai/api/v1/responses \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "input": "Summarize the incident report for an engineer."
  }'

ワークフローを管理

  • 応答IDと、関連する会話またはセッションIDを自社システムに保持します。
  • エージェントループの自動ステップ数はアプリケーション側で制限します。
  • 音声、画像、ツールを追加する前に、モデルのパラメーターを確認します。

結果を解析

一つのテキスト項目の位置に依存しないでください。outputを反復処理し、認識できる種類を抽出して、不明な種類は可観測性のために保持します。

ストリーミングが必要な場合は、同じワークフローのストリーミング形式を使用し、差分は項目識別子に基づいてのみ結合します。