max_turns και Εργαλεία Διακομιστή/Πελάτη
Σε αυτήν τη σελίδα
Εργαλεία Διακομιστή και Εργαλεία Πελάτη
Η πλατφόρμα xAI διακρίνει δύο τύπους εργαλείων που μπορεί να χρησιμοποιήσει το Grok σε μια συνομιλία:
- Εργαλεία πλευράς διακομιστή (Server-side tools): αναζήτηση στον ιστό, εκτέλεση κώδικα, αναζήτηση στο X. Αυτά τα εργαλεία εκτελούνται αυτόματα στους διακομιστές της xAI. Το Grok τα επικαλείται, λαμβάνει το αποτέλεσμα και συνεχίζει χωρίς καμία παρέμβασή σας.
- Εργαλεία πλευράς πελάτη (Client-side tools): οι δικές σας προσαρμοσμένες συναρτήσεις (κλήση συνάρτησης). Όταν το Grok θέλει να καλέσει μία από τις συναρτήσεις σας, το API επιστρέφει μια κλήση συνάρτησης σε εσάς. Ο κώδικάς σας την εκτελεί και στη συνέχεια στέλνει το αποτέλεσμα πίσω στο API.
Αυτή η διάκριση είναι καθοριστική για την κατανόηση της συμπεριφοράς του max_turns.
Η Παράμετρος max_turns
Το max_turns ελέγχει τον αριθμό των γύρων βοηθού/εργαλείου που μπορεί να πραγματοποιήσει το Grok σε ένα μόνο αίτημα API. Κάθε χρήση ενός εργαλείου διακομιστή καταναλώνει έναν γύρο.
response = await client.chat.completions.create(
model="grok-4.5",
messages=[{"role": "user", "content": "Search for the latest news on Python 3.13"}],
tools=[...],
max_turns=5 # Grok can use up to 5 server tools
)
Αν το Grok χρειάζεται να εκτελέσει μια αναζήτηση στον ιστό, στη συνέχεια να τρέξει κώδικα για να αναλύσει τα αποτελέσματα και τέλος να πραγματοποιήσει μια δεύτερη αναζήτηση για την ολοκλήρωση, αυτό καταναλώνει 3 γύρους. Με max_turns=5, απομένουν 2 γύροι.
Επαναφορά μέσω Εργαλείων Πελάτη
Σημαντική συμπεριφορά που πρέπει να θυμάστε: οι κλήσεις εργαλείων πλευράς πελάτη επαναφέρουν τον μετρητή max_turns. Όταν ο κώδικάς σας διαχειρίζεται μια κλήση συνάρτησης και επιστρέφει το αποτέλεσμα σε ένα νέο αίτημα API, το Grok λαμβάνει ξανά την πλήρη κατανομή γύρων του.
# First request: max_turns=3
response = await client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=my_tools,
max_turns=3
)
# Grok requests a client function call
if response.choices[0].message.tool_calls:
# You execute the function locally
tool_result = execute_tool(response.choices[0].message.tool_calls[0])
# Second request: max_turns resets to 3
messages.append(response.choices[0].message)
messages.append({"role": "tool", "content": tool_result, ...})
response = await client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=my_tools,
max_turns=3 # new counter
)
Αυτή η επαναφορά είναι λογική: κάθε αίτημα API είναι ανεξάρτητο. Ο μετρητής max_turns ισχύει μόνο για τους γύρους που πραγματοποιούνται εντός του ίδιου αιτήματος.
Υβριδικές Ροές Εργασίας
Ο συνδυασμός εργαλείων διακομιστή και πελάτη επιτρέπει σύνθετες ροές εργασίας. Για παράδειγμα, το Grok μπορεί να:
- Εκτελέσει μια αναζήτηση στον ιστό (εργαλείο διακομιστή, 1 γύρος)
- Εκτελέσει κώδικα για να αναλύσει τα αποτελέσματα (εργαλείο διακομιστή, 1 γύρος)
- Ζητήσει από την προσαρμοσμένη συνάρτησή σας να αποθηκεύσει τα αποτελέσματα (εργαλείο πελάτη, επαναφορά)
- Εκτελέσει μια νέα αναζήτηση με βάση τα αποθηκευμένα αποτελέσματα (εργαλείο διακομιστή, 1 γύρος με νέο μετρητή)
async def hybrid_workflow(question: str) -> str:
messages = [{"role": "user", "content": question}]
while True:
response = await client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=server_and_client_tools,
max_turns=5
)
message = response.choices[0].message
# If no client tool call, we have the final answer
if not message.tool_calls:
return message.content
# Process client tool calls
messages.append(message)
for tool_call in message.tool_calls:
result = await execute_local_tool(tool_call)
messages.append({
"role": "tool",
"tool_call_id": tool_call.id,
"content": result
})
Αυτό το μοτίβο βρόχου διαχειρίζεται αυτόματα την αλληλεπίδραση μεταξύ του Grok και των τοπικών σας συναρτήσεων. Ο βρόχος συνεχίζεται όσο το Grok χρειάζεται να καλέσει τα εργαλεία σας. Σταματά όταν παρέχει μια τελική απάντηση κειμένου.
Ορισμός του max_turns
- max_turns=1: Το Grok μπορεί να χρησιμοποιήσει μόνο ένα εργαλείο διακομιστή. Επαρκές για μια απλή αναζήτηση στον ιστό.
- max_turns=3-5: καλή ισορροπία για τις περισσότερες περιπτώσεις. Το Grok μπορεί να αλυσιδωτήσει αναζήτηση + ανάλυση + επαλήθευση.
- max_turns=10+: για σύνθετες εργασίες που απαιτούν πολλές επαναλήψεις. Προσοχή στο κόστος tokens.
Μια τιμή max_turns πολύ υψηλή δεν κοστίζει τίποτα αν δεν χρησιμοποιηθεί, αλλά μια τιμή max_turns πολύ χαμηλή μπορεί να διακόψει τον συλλογισμό του Grok στη μέση της εργασίας.
Βασικά σημεία
- Τα εργαλεία διακομιστή (αναζήτηση ιστού, εκτέλεση κώδικα) καταναλώνουν γύρους
max_turns - Τα εργαλεία πελάτη (οι συναρτήσεις σας) επαναφέρουν τον μετρητή με κάθε νέο αίτημα
- Το μοτίβο βρόχου
while Trueδιαχειρίζεται την αλληλεπίδραση μέχρι την τελική απάντηση - Ξεκινήστε με
max_turns=5και προσαρμόστε ανάλογα με την πολυπλοκότητα της εργασίας σας - Κάθε γύρος διακομιστή καταναλώνει επιπλέον tokens (σωρευτικό πλαίσιο)