cicora.ai
Spesifikasi APIPemanggilan fungsi

Alat dan pemanggilan fungsi

Jelaskan fungsi dengan JSON Schema, jalankan pemanggilan dalam aplikasi Anda, lalu kembalikan hasilnya ke percakapan.

Referensi integrasi: pilih parameter dan kemampuan yang tersedia dari pengaturan API akun Anda dan katalog model untuk lingkungan Anda.

Jelaskan kontrak fungsi

Sebuah alat memiliki nama, deskripsi yang jelas, dan JSON Schema untuk parameternya. Deskripsi menjelaskan kapan alat harus dipilih, sedangkan skema membatasi argumen.

Model mengusulkan pemanggilan; model tidak dengan sendirinya memperoleh akses ke jaringan, basis data, atau file Anda.

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

Jalankan di sisi Anda

  • Periksa nama alat terhadap daftar yang diizinkan.
  • Validasi argumen terhadap skema sebelum memanggil layanan internal.
  • Terapkan otorisasi, batas waktu, dan idempotensi Anda sendiri pada tindakan alat.

Kembalikan hasil

Tambahkan pesan alat dengan tool_call_id dan hasil serialisasi yang ringkas, lalu lanjutkan percakapan dengan konteks yang sama.

Pisahkan kegagalan eksekusi alat dari kegagalan model: kembalikan alasan terstruktur yang dapat dijelaskan model kepada pengguna.