cicora.ai
API-specifikationFunktionsanrop

Verktyg och funktionsanrop

Beskriv funktioner med JSON Schema, kör anropet i din applikation och returnera resultatet till konversationen.

Integrationsreferens: välj parametrar och tillgängliga funktioner från API-inställningarna för ditt konto och modellkatalogen för din miljö.

Beskriv ett funktionskontrakt

Ett verktyg innehåller ett namn, en tydlig beskrivning och ett JSON Schema för parametrar. Beskrivningen anger när verktyget ska väljas, medan schemat begränsar argumenten.

Modellen föreslår ett anrop; den får inte åtkomst till ditt nätverk, din databas eller dina filer av sig själv.

Funktionsverktyg i en chattbegäran
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 sida

  • Kontrollera verktygsnamnet mot en lista över tillåtna värden.
  • Validera argument mot schemat innan en intern tjänst anropas.
  • Tillämpa egen auktorisering, egna tidsgränser och idempotens på verktygsåtgärden.

Returnera resultatet

Lägg till ett tool-meddelande med tool_call_id och ett kompakt serialiserat resultat och fortsätt sedan konversationen med samma kontext.

Håll ett fel vid verktygskörning åtskilt från ett modellfel: returnera en strukturerad orsak som modellen kan förklara för användaren.