cicora.ai
API-specifikációFüggvényhívás

Eszközök és függvényhívás

A függvényeket JSON Schema segítségével írja le, a hívást az alkalmazásban hajtsa végre, majd az eredményt adja vissza a beszélgetésnek.

Integrációs referencia: válassza ki a paramétereket és az elérhető képességeket a fiókja API-beállításaiból és a környezetéhez tartozó modellkatalógusból.

Függvényszerződés leírása

Egy eszköznek neve, egyértelmű leírása és a paramétereihez JSON Schema sémája van. A leírás közli, mikor választandó az eszköz, a séma pedig korlátozza az argumentumokat.

A modell javasol egy hívást; ettől önmagában nem kap hozzáférést a hálózathoz, adatbázishoz vagy fájlokhoz.

Függvényeszköz csevegési kérésben
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"
}

Végrehajtás a saját oldalon

  • Ellenőrizze az eszköz nevét egy engedélyezési lista alapján.
  • Belső szolgáltatás hívása előtt ellenőrizze az argumentumokat a séma alapján.
  • Alkalmazza saját engedélyezését, időtúllépéseit és idempotenciáját az eszközműveletre.

Az eredmény visszaadása

Adjon hozzá tool szerepű üzenetet a tool_call_id értékkel és tömören szerializált eredménnyel, majd ugyanazzal a kontextussal folytassa a beszélgetést.

Az eszközvégrehajtás hibáját tartsa külön a modellhibától: adjon vissza strukturált okot, amelyet a modell elmagyarázhat a felhasználónak.