cicora.ai
API спецификациясыФункция шақыру

Құралдар және функция шақыру

Функцияларды JSON Schema арқылы сипаттап, шақыруды қолданбаңызда орындаңыз және нәтижені сөйлесуге қайтарыңыз.

Интеграция анықтамалығы: параметрлер мен қолжетімді мүмкіндіктерді тіркелгіңіздің API параметрлерінен және ортаңызға арналған модельдер каталогынан таңдаңыз.

Функция шартын сипаттау

Құрал атаудан, анық сипаттамадан және параметрлерге арналған JSON Schema-дан тұрады. Сипаттама құралдың қашан таңдалатынын айтады, ал схема аргументтерді шектейді.

Модель шақыруды ұсынады; ол өздігінен желіңізге, дерекқорыңызға немесе файлдарыңызға қол жеткізбейді.

Чат сұрауындағы функция құралы
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"
}

Өз тарапыңыздан орындау

  • Құрал атауын рұқсат етілген тізіммен салыстырып тексеріңіз.
  • Ішкі қызметті шақырмас бұрын аргументтерді схемаға сай тексеріңіз.
  • Құрал әрекетіне өз авторизацияңызды, күту уақыттарын және идемпотенттілігіңізді қолданыңыз.

Нәтижені қайтару

tool_call_id және ықшам серияланған нәтижесі бар құрал хабарын қосып, сол контекспен сөйлесуді жалғастырыңыз.

Құралды орындау ақауын модель ақауынан бөлек ұстаңыз: модель пайдаланушыға түсіндіре алатын құрылымды себепті қайтарыңыз.