cicora.ai
API-SpezifikationFunktionsaufrufe

Tools und Funktionsaufrufe

Beschreiben Sie Funktionen mit JSON Schema, führen Sie den Aufruf in Ihrer Anwendung aus und geben Sie das Ergebnis an die Unterhaltung zurück.

Integrationsreferenz: Wählen Sie Parameter und verfügbare Funktionen in den API-Einstellungen Ihres Kontos und im Modellkatalog für Ihre Umgebung aus.

Funktionsvertrag beschreiben

Ein Tool enthält einen Namen, eine klare Beschreibung und ein JSON Schema für Parameter. Die Beschreibung legt fest, wann das Tool ausgewählt werden soll, während das Schema die Argumente einschränkt.

Das Modell schlägt einen Aufruf vor; es erhält dadurch nicht von selbst Zugriff auf Ihr Netzwerk, Ihre Datenbank oder Ihre Dateien.

Funktionstool in einer Chat-Anfrage
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"
}

Auf Ihrer Seite ausführen

  • Prüfen Sie den Tool-Namen anhand einer Positivliste.
  • Validieren Sie Argumente anhand des Schemas, bevor Sie einen internen Dienst aufrufen.
  • Wenden Sie Ihre eigene Autorisierung, Ihre eigenen Timeouts und Ihre eigene Idempotenz auf die Tool-Aktion an.

Ergebnis zurückgeben

Fügen Sie eine Tool-Nachricht mit der tool_call_id und einem kompakten serialisierten Ergebnis hinzu und setzen Sie dann die Unterhaltung mit demselben Kontext fort.

Halten Sie einen Fehler bei der Tool-Ausführung von einem Modellfehler getrennt: Geben Sie einen strukturierten Grund zurück, den das Modell dem Benutzer erklären kann.