cicora.ai
API specifikacijaFunkcijų iškvietimas

Įrankiai ir funkcijų iškvietimas

Aprašykite funkcijas su JSON Schema, vykdykite iškvietimą savo programoje ir grąžinkite rezultatą į pokalbį.

Integracijų žinynas: savo paskyros API nustatymuose ir jūsų aplinkos modelių kataloge pasirinkite parametrus bei galimas funkcijas.

Aprašykite funkcijos sutartį

Įrankis turi pavadinimą, aiškų aprašą ir parametrų JSON Schema. Aprašas nurodo, kada įrankį pasirinkti, o schema apriboja argumentus.

Modelis pasiūlo iškvietimą; dėl to jis pats negauna prieigos prie jūsų tinklo, duomenų bazės ar failų.

Funkcinis įrankis pokalbio užklausoje
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"
}

Vykdykite savo pusėje

  • Patikrinkite įrankio pavadinimą pagal leidžiamųjų sąrašą.
  • Prieš iškviesdami vidinę paslaugą patikrinkite argumentus pagal schemą.
  • Įrankio veiksmui taikykite savo autorizavimą, skirtąjį laiką ir idempotentiškumą.

Grąžinkite rezultatą

Pridėkite tool pranešimą su tool_call_id ir glaustu serializuotu rezultatu, tada tęskite pokalbį su tuo pačiu kontekstu.

Įrankio vykdymo klaidą atskirkite nuo modelio klaidos: grąžinkite struktūrizuotą priežastį, kurią modelis gali paaiškinti naudotojui.