tool_choice και έλεγχος εργαλείων
Σε αυτήν τη σελίδα
Καθοδήγηση του μοντέλου προς τα κατάλληλα εργαλεία
Εξ ορισμού, το μοντέλο αποφασίζει ελεύθερα ποια εργαλεία θα χρησιμοποιήσει (ή αν θα χρησιμοποιήσει κανένα). Η παράμετρος 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_choice | parallel | max_turns |
|---|---|---|---|
| Αναζήτηση ειδήσεων | required | true | 3 |
| Ακριβής υπολογισμός | {"type": "function", "name": "calc"} | false | 1 |
| Ελεύθερη συνομιλία | auto | true | 5 |
| Απάντηση χωρίς εργαλείο | none | - | - |
Βασικά σημεία
- Το
tool_choiceελέγχει αν και ποια εργαλεία θα χρησιμοποιήσει το μοντέλο:auto,required,noneή μια συγκεκριμένη συνάρτηση - Το
parallel_tool_calls(προεπιλογήtrue) επιτρέπει ταυτόχρονες κλήσεις εργαλείων - Το
max_turnsπεριορίζει τους κύκλους εργαλείων διακομιστή· οι κλήσεις πελάτη μηδενίζουν τον μετρητή - Χρησιμοποιήστε το
requiredόταν τα πρόσφατα δεδομένα είναι απαραίτητα - Απενεργοποιήστε τον παραλληλισμό εάν οι συναρτήσεις σας έχουν εξαρτήσεις μεταξύ τους