cicora.ai
API-spesifikasjonFunksjonskall

Verktøy og funksjonskall

Beskriv funksjoner med JSON Schema, kjør kallet i applikasjonen, og returner resultatet til samtalen.

Integrasjonsreferanse: Velg parametere og tilgjengelige funksjoner fra API-innstillingene for kontoen og modellkatalogen for miljøet ditt.

Beskriv en funksjonskontrakt

Et verktøy inneholder et navn, en tydelig beskrivelse og et JSON Schema for parametere. Beskrivelsen sier når verktøyet skal velges, mens skjemaet avgrenser argumentene.

Modellen foreslår et kall; den får ikke tilgang til nettverket, databasen eller filene dine av seg selv.

Funksjonsverktøy i en chatteforespørsel
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"
}

Kjør på din side

  • Kontroller verktøynavnet mot en tillatelsesliste.
  • Valider argumentene mot skjemaet før en intern tjeneste kalles.
  • Bruk din egen autorisasjon, tidsavbrudd og idempotens på verktøyhandlingen.

Returner resultatet

Legg til en tool-melding med tool_call_id og et kompakt serialisert resultat, og fortsett deretter samtalen med den samme konteksten.

Hold feil ved verktøykjøring atskilt fra modellfeil: returner en strukturert årsak som modellen kan forklare brukeren.