cicora.ai
API-specifikationFunktionskald

Værktøjer og funktionskald

Beskriv funktioner med JSON Schema, kør kaldet i applikationen, og returnér resultatet til samtalen.

Integrationsreference: Vælg parametre og tilgængelige funktioner fra API-indstillingerne for kontoen og modelkataloget for dit miljø.

Beskriv en funktionskontrakt

Et værktøj indeholder et navn, en tydelig beskrivelse og et JSON Schema for parametre. Beskrivelsen angiver, hvornår værktøjet skal vælges, mens skemaet afgrænser argumenterne.

Modellen foreslår et kald; den får ikke selv adgang til dit netværk, din database eller dine filer.

Funktionsværktøj i en chatanmodning
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"
}

Kør på din side

  • Kontrollér værktøjsnavnet mod en tilladelsesliste.
  • Validér argumenterne mod skemaet, før en intern tjeneste kaldes.
  • Brug din egen autorisation, timeouts og idempotens på værktøjshandlingen.

Returnér resultatet

Tilføj en tool-meddelelse med tool_call_id og et kompakt serialiseret resultat, og fortsæt derefter samtalen med den samme kontekst.

Hold fejl ved værktøjskørsel adskilt fra modelfejl: returnér en struktureret årsag som modellen kan forklare brugeren.