cicora.ai
ข้อกำหนด APIเอาต์พุตที่ปลอดภัยตามสคีมา

เอาต์พุตที่มีโครงสร้าง

ขอออบเจ็กต์ JSON หรือ JSON Schema เมื่อซอฟต์แวร์เป็นผู้ใช้ผลตอบกลับแทนบุคคล

เอกสารอ้างอิงการเชื่อมต่อ: เลือกพารามิเตอร์และความสามารถที่ใช้ได้จากการตั้งค่า API ของบัญชีและแค็ตตาล็อกโมเดลสำหรับสภาพแวดล้อมของคุณ

ตั้ง response_format

โหมด JSON มีประโยชน์สำหรับออบเจ็กต์เรียบง่าย ส่วน JSON Schema เพิ่มชื่อสคีมา โครงสร้างฟิลด์ คุณสมบัติบังคับ และวิธีปฏิเสธคุณสมบัติเพิ่มเติม

สคีมาที่เข้มงวดช่วยลดการแยกวิเคราะห์เชิงป้องกัน แต่ไม่สามารถใช้แทนการตรวจสอบฝั่งแอปพลิเคชันได้

รูปแบบการตอบกลับ JSON Schema
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "Extract an order summary."}],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "order_summary",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {"items": {"type": "array"}, "total": {"type": "number"}},
        "required": ["items", "total"],
        "additionalProperties": false
      }
    }
  }
}

ออกแบบสคีมา

  • เขียนฟิลด์และคำอธิบายให้กระชับและเฉพาะเจาะจงกับโดเมน
  • ตั้ง additionalProperties: false ในจุดที่ไม่ยอมรับฟิลด์ที่ไม่รู้จัก
  • กำหนดเวอร์ชันสคีมาในโค้ดของคุณเอง แทนการเปลี่ยนสัญญากับฝั่งที่เรียกใช้สคีมาอย่างเงียบ ๆ

จัดการผลลัพธ์

ตรวจสอบ JSON ที่ส่งกลับด้วยตัวตรวจสอบเดียวกับที่ API หรือฐานข้อมูลของคุณใช้

หากโมเดลหรือเส้นทางไม่รับรูปแบบที่ร้องขอ ให้แสดงข้อผิดพลาดแบบควบคุมได้และเลือกตัวเลือกที่เข้ากันได้ผ่านแค็ตตาล็อกโมเดล