cicora.ai
Spesifikasi APIPanggilan fungsi

Alat dan panggilan fungsi

Huraikan fungsi dengan JSON Schema, laksanakan panggilan dalam aplikasi anda dan kembalikan hasil kepada perbualan.

Rujukan penyepaduan: pilih parameter dan keupayaan yang tersedia daripada tetapan API akaun serta katalog model untuk persekitaran anda.

Huraikan kontrak fungsi

Sesuatu alat mengandungi nama, perihalan yang jelas dan JSON Schema untuk parameter. Perihalan menyatakan bila alat harus dipilih, manakala skema mengehadkan argumen.

Model mencadangkan panggilan; ia tidak memperoleh akses kepada rangkaian, pangkalan data atau fail anda dengan sendirinya.

Alat fungsi dalam permintaan sembang
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"
}

Laksanakan pada pihak anda

  • Semak nama alat terhadap senarai dibenarkan.
  • Sahkan argumen berdasarkan skema sebelum memanggil perkhidmatan dalaman.
  • Gunakan semakan kebenaran, tamat masa dan idempotensi anda sendiri untuk tindakan alat.

Kembalikan hasil

Tambah mesej alat dengan tool_call_id dan hasil bersiri yang ringkas, kemudian teruskan perbualan dengan konteks yang sama.

Asingkan kegagalan pelaksanaan alat daripada kegagalan model: kembalikan sebab berstruktur yang boleh diterangkan oleh model kepada pengguna.