cicora.ai
ข้อกำหนด APIการเรียกใช้ฟังก์ชัน

เครื่องมือและการเรียกใช้ฟังก์ชัน

อธิบายฟังก์ชันด้วย JSON Schema ดำเนินการเรียกใช้ในแอปพลิเคชันของคุณ และส่งผลลัพธ์กลับไปยังการสนทนา

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

อธิบายสัญญาของฟังก์ชัน

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

โมเดลเสนอการเรียกใช้ แต่ไม่ได้รับสิทธิ์เข้าถึงเครือข่าย ฐานข้อมูล หรือไฟล์ของคุณด้วยตัวเอง

เครื่องมือฟังก์ชันในคำขอแชต
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "What is the weather in Tashkent?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Read current weather for a city.",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"],
        "additionalProperties": false
      }
    }
  }],
  "tool_choice": "auto"
}

ดำเนินการในฝั่งของคุณ

  • ตรวจสอบชื่อเครื่องมือกับรายการที่อนุญาต
  • ตรวจสอบอาร์กิวเมนต์ตามสคีมาก่อนเรียกบริการภายใน
  • ใช้การอนุญาต การหมดเวลา และ idempotency ของคุณเองกับการดำเนินการของเครื่องมือ

ส่งคืนผลลัพธ์

เพิ่มข้อความ tool พร้อม tool_call_id และผลลัพธ์แบบซีเรียลไลซ์ที่กระชับ แล้วดำเนินการสนทนาต่อด้วยบริบทเดิม

แยกความล้มเหลวในการดำเนินการของเครื่องมือออกจากความล้มเหลวของโมเดล ส่งคืนเหตุผลที่มีโครงสร้างซึ่งโมเดลอธิบายแก่ผู้ใช้ได้