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

max_turns και Εργαλεία Διακομιστή/Πελάτη

Μάθημα 8 / 12 Ενημερώθηκε 30 Ιουλίου 2026 Προχωρημένος
Σε αυτήν τη σελίδα
  1. Εργαλεία Διακομιστή και Εργαλεία Πελάτη
  2. Η Παράμετρος max_turns
  3. Επαναφορά μέσω Εργαλείων Πελάτη
  4. Υβριδικές Ροές Εργασίας
  5. Ορισμός του max_turns
  6. Βασικά σημεία

Εργαλεία Διακομιστή και Εργαλεία Πελάτη

Η πλατφόρμα 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 γύρος)
  2. Εκτελέσει κώδικα για να αναλύσει τα αποτελέσματα (εργαλείο διακομιστή, 1 γύρος)
  3. Ζητήσει από την προσαρμοσμένη συνάρτησή σας να αποθηκεύσει τα αποτελέσματα (εργαλείο πελάτη, επαναφορά)
  4. Εκτελέσει μια νέα αναζήτηση με βάση τα αποθηκευμένα αποτελέσματα (εργαλείο διακομιστή, 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 (σωρευτικό πλαίσιο)