cicora.ai
Specifikace APIVolání funkcí

Nástroje a volání funkcí

Popište funkce pomocí JSON Schema, proveďte volání ve své aplikaci a vraťte výsledek do konverzace.

Referenční dokumentace integrace: parametry a dostupné možnosti vybírejte v nastavení API svého účtu a v katalogu modelů pro své prostředí.

Popis kontraktu funkce

Nástroj obsahuje název, jasný popis a JSON Schema pro parametry. Popis určuje, kdy má být nástroj vybrán, zatímco schéma omezuje argumenty.

Model navrhne volání; sám tím nezíská přístup k vaší síti, databázi ani souborům.

Funkční nástroj v požadavku 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"
}

Provedení na vaší straně

  • Zkontrolujte název nástroje podle seznamu povolených položek.
  • Před voláním interní služby ověřte argumenty podle schématu.
  • Na akci nástroje uplatněte vlastní autorizaci, časové limity a idempotenci.

Vrácení výsledku

Přidejte zprávu nástroje s tool_call_id a kompaktním serializovaným výsledkem a poté pokračujte v konverzaci se stejným kontextem.

Selhání provedení nástroje odlišujte od selhání modelu: vraťte strukturovaný důvod, který model může uživateli vysvětlit.