cicora.ai
Specifikacija API-jaKlicanje funkcij

Orodja in klicanje funkcij

Funkcije opišite z JSON Schema, klic izvedite v aplikaciji in rezultat vrnite v pogovor.

Referenčna dokumentacija za integracijo: parametre in razpoložljive zmožnosti izberite v nastavitvah API-ja svojega računa in v katalogu modelov za svoje okolje.

Opišite pogodbo funkcije

Orodje vsebuje ime, jasen opis in JSON Schema za parametre. Opis pove, kdaj naj bo orodje izbrano, shema pa omejuje argumente.

Model predlaga klic; sam s tem ne pridobi dostopa do vašega omrežja, zbirke podatkov ali datotek.

Funkcijsko orodje v zahtevi za klepet
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"
}

Izvedite na svoji strani

  • Ime orodja preverite glede na seznam dovoljenih.
  • Pred klicem interne storitve preverite argumente glede na shemo.
  • Za dejanje orodja uporabite lastno avtorizacijo, časovne omejitve in idempotentnost.

Vrnite rezultat

Dodajte sporočilo tool z vrednostjo tool_call_id in zgoščenim serializiranim rezultatom, nato nadaljujte pogovor z istim kontekstom.

Napako pri izvajanju orodja ločite od napake modela: vrnite strukturiran razlog, ki ga model lahko pojasni uporabniku.