Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

tool_choice και έλεγχος εργαλείων

Μάθημα 10 / 16 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Καθοδήγηση του μοντέλου προς τα κατάλληλα εργαλεία
  2. Λειτουργίες του tool_choice
  3. parallel_tool_calls
  4. max_turns
  5. Στρατηγικές ελέγχου
  6. Βασικά σημεία

Καθοδήγηση του μοντέλου προς τα κατάλληλα εργαλεία

Εξ ορισμού, το μοντέλο αποφασίζει ελεύθερα ποια εργαλεία θα χρησιμοποιήσει (ή αν θα χρησιμοποιήσει κανένα). Η παράμετρος tool_choice σας προσφέρει λεπτομερέστερο έλεγχο over αυτής της συμπεριφοράς.

Λειτουργίες του tool_choice

auto (προεπιλογή)

Το μοντέλο αποφασίζει ελεύθερα. Μπορεί να χρησιμοποιήσει ένα εργαλείο, πολλά ή κανένα:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the capital of France?",
  "tools": [{"type": "web_search"}],
  "tool_choice": "auto"
}

Για αυτή την απλή ερώτηση γεγονότων, το μοντέλο πιθανότατα θα απαντήσει χωρίς αναζήτηση στον ιστό. Για μια ερώτηση σχετικά με τρέχοντα γεγονότα, θα ξεκινήσει μια αναζήτηση.

required

Εξαναγκάζει το μοντέλο να χρησιμοποιήσει τουλάχιστον ένα εργαλείο:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Give me today's stock market prices.",
  "tools": [{"type": "web_search"}],
  "tool_choice": "required"
}

Χρήσιμο όταν γνωρίζετε ότι η απάντηση απαιτεί πρόσφατα δεδομένα και το μοντέλο δεν πρέπει να απαντήσει από τη μνήμη του.

none

Απαγορεύει τη χρήση εργαλείων, ακόμη και αν αυτά έχουν δηλωθεί:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Explain the concept of recursion.",
  "tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
  "tool_choice": "none"
}

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

Συγκεκριμένη συνάρτηση

Εξαναγκάζει τη χρήση μιας συγκεκριμένης συνάρτησης:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Paris",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string"}
      },
      "required": ["city"]
    }
  }],
  "tool_choice": {"type": "function", "name": "get_weather"}
}

Το μοντέλο περιορίζεται να καλέσει τη get_weather με τα κατάλληλα ορίσματα.

parallel_tool_calls

Εξ ορισμού, το parallel_tool_calls ορίζεται σε true. Το μοντέλο μπορεί να εκκινήσει πολλαπλά εργαλεία παράλληλα μέσα σε έναν μόνο γύρο:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Compare the weather in Paris and London.",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather for a city",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string"}
      },
      "required": ["city"]
    }
  }],
  "parallel_tool_calls": true
}

Το μοντέλο μπορεί να καλέσει τα get_weather("Paris") και get_weather("Londres") ταυτόχρονα, γεγονός που επιταχύνει την επεξεργασία.

Για να απενεργοποιήσετε αυτή τη συμπεριφορά:

{
  "parallel_tool_calls": false
}

Απενεργοποιήστε τις παράλληλες κλήσεις εάν οι συναρτήσεις σας έχουν παρενέργειες ή εξαρτώνται η μία από την άλλη (για παράδειγμα, εάν η δεύτερη συνάρτηση εξαρτάται από το αποτέλεσμα της πρώτης).

max_turns

Η παράμετρος max_turns περιορίζει τον αριθμό των γύρων αλληλεπίδρασης μεταξύ του μοντέλου και των εργαλείων στην πλευρά του διακομιστή:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Perform an in-depth analysis of the AI market in 2026.",
  "tools": [{"type": "web_search"}, {"type": "code_interpreter"}],
  "max_turns": 5
}

Ένας «γύρος» αντιστοιχεί σε έναν πλήρη κύκλο: το μοντέλο καλεί ένα εργαλείο, λαμβάνει το αποτέλεσμα και στη συνέχεια αποφασίζει αν χρειάζεται άλλη κλήση. Με max_turns: 5, το μοντέλο μπορεί να εκτελέσει έως και 5 κύκλους κλήσεων εργαλείων στην πλευρά του διακομιστή πριν παράγει την τελική του απάντηση.

Συμπεριφορά με εργαλεία πελάτη

Το max_turns ισχύει μόνο για εργαλεία διακομιστή. Όταν το μοντέλο καλεί μια συνάρτηση πελάτη, ο μετρητής μηδενίζεται στο επόμενο αίτημα. Αυτό σημαίνει ότι κάθε διαδρομή πελάτη-διακομιστή δημιουργεί μια νέα κατανομή γύρων.

Στρατηγικές ελέγχου

Σενάριοtool_choiceparallelmax_turns
Αναζήτηση ειδήσεωνrequiredtrue3
Ακριβής υπολογισμός{"type": "function", "name": "calc"}false1
Ελεύθερη συνομιλίαautotrue5
Απάντηση χωρίς εργαλείοnone--

Βασικά σημεία

  • Το tool_choice ελέγχει αν και ποια εργαλεία θα χρησιμοποιήσει το μοντέλο: auto, required, none ή μια συγκεκριμένη συνάρτηση
  • Το parallel_tool_calls (προεπιλογή true) επιτρέπει ταυτόχρονες κλήσεις εργαλείων
  • Το max_turns περιορίζει τους κύκλους εργαλείων διακομιστή· οι κλήσεις πελάτη μηδενίζουν τον μετρητή
  • Χρησιμοποιήστε το required όταν τα πρόσφατα δεδομένα είναι απαραίτητα
  • Απενεργοποιήστε τον παραλληλισμό εάν οι συναρτήσεις σας έχουν εξαρτήσεις μεταξύ τους