cicora.ai
Προδιαγραφή APIΚλήση συναρτήσεων

Εργαλεία και κλήση συναρτήσεων

Περιγράψτε συναρτήσεις με JSON Schema, εκτελέστε την κλήση στην εφαρμογή σας και επιστρέψτε το αποτέλεσμα στη συνομιλία.

Αναφορά ενσωμάτωσης: επιλέξτε παραμέτρους και διαθέσιμες δυνατότητες από τις ρυθμίσεις API του λογαριασμού σας και τον κατάλογο μοντέλων για το περιβάλλον σας.

Περιγράψτε σύμβαση συνάρτησης

Ένα εργαλείο περιέχει όνομα, σαφή περιγραφή και JSON Schema για τις παραμέτρους. Η περιγραφή δηλώνει πότε πρέπει να επιλεγεί το εργαλείο, ενώ το σχήμα περιορίζει τα ορίσματα.

Το μοντέλο προτείνει μια κλήση· δεν αποκτά από μόνο του πρόσβαση στο δίκτυο, στη βάση δεδομένων ή στα αρχεία σας.

Εργαλείο συνάρτησης σε αίτημα συνομιλίας
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"
}

Εκτελέστε στην πλευρά σας

  • Ελέγξτε το όνομα εργαλείου με βάση μια λίστα επιτρεπόμενων.
  • Επικυρώστε τα ορίσματα με βάση το σχήμα πριν καλέσετε εσωτερική υπηρεσία.
  • Εφαρμόστε τη δική σας εξουσιοδότηση, χρονικά όρια και ιδιοδυναμία στην ενέργεια εργαλείου.

Επιστρέψτε το αποτέλεσμα

Προσθέστε μήνυμα εργαλείου με το tool_call_id και ένα συμπαγές σειριοποιημένο αποτέλεσμα και συνεχίστε τη συνομιλία με το ίδιο πλαίσιο.

Διατηρήστε μια αποτυχία εκτέλεσης εργαλείου διακριτή από αποτυχία μοντέλου: επιστρέψτε έναν δομημένο λόγο που το μοντέλο μπορεί να εξηγήσει στον χρήστη.