cicora.ai
Špecifikácia APIVolanie funkcií

Nástroje a volanie funkcií

Opíšte funkcie pomocou JSON Schema, vykonajte volanie vo svojej aplikácii a vráťte výsledok do konverzácie.

Referenčná dokumentácia integrácie: parametre a dostupné funkcie vyberte z nastavení API účtu a katalógu modelov pre svoje prostredie.

Opíšte zmluvu funkcie

Nástroj obsahuje názov, jasný opis a JSON Schema pre parametre. Opis uvádza, kedy sa má nástroj vybrať, zatiaľ čo schéma obmedzuje argumenty.

Model navrhne volanie; sám tým nezíska prístup k vašej sieti, databáze ani súborom.

Funkčný nástroj v požiadavke chatu
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"
}

Vykonajte na svojej strane

  • Skontrolujte názov nástroja voči zoznamu povolených položiek.
  • Pred volaním internej služby overte argumenty voči schéme.
  • Na úkon nástroja použite vlastnú autorizáciu, časové limity a idempotentnosť.

Vráťte výsledok

Pridajte správu nástroja s tool_call_id a kompaktným serializovaným výsledkom, potom pokračujte v konverzácii s rovnakým kontextom.

Zlyhanie vykonania nástroja oddeľte od zlyhania modelu: vráťte štruktúrovaný dôvod, ktorý model dokáže vysvetliť používateľovi.