cicora.ai
API-määritysFunktiokutsut

Työkalut ja funktiokutsut

Kuvaa funktiot JSON Schemalla, suorita kutsu sovelluksessasi ja palauta tulos keskusteluun.

Integraatio-opas: valitse parametrit ja saatavilla olevat ominaisuudet ympäristösi tilin API-asetuksista ja malliluettelosta.

Kuvaa funktiosopimus

Työkalu sisältää nimen, selkeän kuvauksen ja parametrien JSON Scheman. Kuvaus kertoo, milloin työkalu valitaan, ja skeema rajaa argumentit.

Malli ehdottaa kutsua; se ei itsestään saa pääsyä verkkoosi, tietokantaasi tai tiedostoihisi.

Funktiotyökalu keskustelupyynnössä
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"
}

Suorita omalla puolellasi

  • Tarkista työkalun nimi sallittujen luettelosta.
  • Vahvista argumentit skeemaa vasten ennen sisäisen palvelun kutsumista.
  • Sovella työkalutoimintoon omaa valtuutustasi, aikakatkaisujasi ja idempotenssiasi.

Palauta tulos

Lisää tool-viesti, jossa on tool_call_id ja tiiviisti sarjoitettu tulos, ja jatka sitten keskustelua samalla kontekstilla.

Pidä työkalun suoritusvirhe erillään mallivirheestä: palauta rakenteinen syy, jonka malli voi selittää käyttäjälle.