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

Συνδυασμός Εργαλείων Διακομιστή και Πελάτη

Μάθημα 8 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Δύο κατηγορίες εργαλείων στην ίδια πλατφόρμα
  2. Συνδυασμός και των δύο σε ένα μόνο αίτημα
  3. Η υβριδική ροή
  4. Παραδείγματα από την πραγματικότητα
  5. Χρέωση για εργαλεία διακομιστή
  6. Βασικά σημεία

Δύο κατηγορίες εργαλείων στην ίδια πλατφόρμα

Το API του Grok διακρίνει δύο θεμελιωδώς διαφορετικούς τύπους εργαλείων με βάση την εκτέλεσή τους. Η κατανόηση αυτής της διάκρισης είναι απαραίτητη για τον σχεδιασμό αξιόπιστων αρχιτεκτονικών.

Ενσωματωμένα εργαλεία (πλευρά διακομιστή)

Η xAI εκτελεί αυτά τα εργαλεία αυτόματα στους διακομιστές της. Εσείς δεν διαχειρίζεστε τίποτα—ούτε τοπική εκτέλεση, ούτε προώθηση αποτελεσμάτων. Το μοντέλο τα καλεί και λαμβάνει τα αποτελέσματα απευθείας.

Εργαλείο Αναγνωριστικό Περιγραφή
Web Search web_search Αναζήτηση στον ιστό σε πραγματικό χρόνο
X Search x_search Αναζήτηση στο X/Twitter
Code Interpreter code_interpreter Εκτέλεση Python σε απομονωμένο περιβάλλον (sandbox)
Collections Search collections_search Αναζήτηση στα έγγραφα που έχετε ανεβάσει
Remote MCP mcp Σύνδεση με εξωτερικούς διακομιστές MCP

Προσαρμοσμένες συναρτήσεις (πλευρά πελάτη)

Αυτές είναι οι δικές σας συναρτήσεις, οι οποίες ορίζονται μέσω της κλήσης συναρτήσεων (function calling). Το μοντέλο επιστρέφει ένα tool_call, ο κώδικάς σας εκτελεί τη συνάρτηση και εσείς στέλνετε πίσω το αποτέλεσμα. Αυτός είναι ο μηχανισμός που μάθατε στα προηγούμενα μαθήματα.

Συνδυασμός και των δύο σε ένα μόνο αίτημα

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

tools = [
    # Εργαλείο διακομιστή — εκτελείται αυτόματα από την xAI
    {"type": "web_search"},

    # Εργαλείο πελάτη — εκτελείται από τον κώδικά σας
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Αποθήκευση πληροφοριών στη βάση δεδομένων",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Όταν το μοντέλο λαμβάνει αυτό το αίτημα, μπορεί να:

  1. Χρησιμοποιήσει το web_search για να βρει πληροφορίες (αυτόματη εκτέλεση στην πλευρά του διακομιστή)
  2. Καλέσει το save_to_database για να αποθηκεύσει το αποτέλεσμα (επιστροφή στον πελάτη)

Η υβριδική ροή

Η συμπεριφορά διαφέρει ανάλογα με τον τύπο του εργαλείου:

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

Όταν το μοντέλο χρησιμοποιεί και τους δύο τύπους στο ίδιο αίτημα, τα εργαλεία διακομιστή εκτελούνται πρώτα (χωρίς την παρέμβασή σας). Στη συνέχεια, εάν το μοντέλο χρειάζεται επίσης ένα εργαλείο πελάτη, σας επιστρέφει το tool_call με τα αποτελέσματα των εργαλείων διακομιστή ήδη ενσωματωμένα στο πλαίσιο του.

Παραδείγματα από την πραγματικότητα

Αναζήτηση στον ιστό + επιχειρηματική λογική

# Ο χρήστης ρωτά: "Βρες την τιμή του Bitcoin και αποθήκευσέ την"
# Το μοντέλο:
# 1. Καλεί το web_search για να βρει την τιμή (πλευρά διακομιστή, αυτόματα)
# 2. Καλεί το save_price(symbol="BTC", price=68432) (πλευρά πελάτη)

Αναζήτηση στο X + ειδοποίηση

# "Ειδοποίησέ με για tweets σχετικά με το προϊόν μας από χθες"
# Το μοντέλο:
# 1. Καλεί το x_search για να βρει tweets (πλευρά διακομιστή)
# 2. Καλεί το send_notification(count=12, summary="...") (πλευρά πελάτη)

Ερμηνέας κώδικα + αποθήκευση

# "Υπολόγισε τον μέσο όρο αυτών των δεδομένων και αποθήκευσε το αποτέλεσμα"
# Το μοντέλο:
# 1. Καλεί το code_interpreter για τον υπολογισμό (πλευρά διακομιστή)
# 2. Καλεί το save_result(key="avg", value="42.5") (πλευρά πελάτη)

Χρέωση για εργαλεία διακομιστή

Τα ενσωματωμένα εργαλεία χρεώνονται με δύο τρόπους:

  • Tokens: τυπική κατανάλωση (είσοδος + έξοδος)
  • Κλήσεις (Invocations): σταθερό κόστος ανά κλήση εργαλείου

Το μοντέλο μπορεί να καλέσει πολλαπλά εργαλεία διακομιστή για ένα μόνο αίτημα—τα κόστη αθροίζονται. Λάβετε υπόψη σας αυτό το γεγονός όταν ενεργοποιείτε το web_search: το μοντέλο μπορεί να πραγματοποιήσει πολλαπλές αναζητήσεις για να βελτιώσει τα αποτελέσματά του.

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

  • Δύο τύποι εργαλείων: διακομιστή (αυτόματα) και πελάτη (κλήση συναρτήσεων)
  • Τα εργαλεία διακομιστή (web_search, x_search, code_interpreter) εκτελούνται χωρίς την παρέμβασή σας
  • Μπορείτε να αναμείξετε και τους δύο τύπους σε ένα μόνο αίτημα
  • Τα εργαλεία διακομιστή εκτελούνται πρώτα και στη συνέχεια το μοντέλο μπορεί να καλέσει τις συναρτήσεις σας
  • Κάθε κλήση εργαλείου διακομιστή χρεώνεται (tokens + κόστος ανά κλήση)
  • Οι παραπομπές (citations) δημιουργούνται αυτόματα για δεδομένα από εργαλεία διακομιστή