Συνδυασμός Εργαλείων Διακομιστή και Πελάτη
Σε αυτήν τη σελίδα
Δύο κατηγορίες εργαλείων στην ίδια πλατφόρμα
Το 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"]
}
}
}
]
Όταν το μοντέλο λαμβάνει αυτό το αίτημα, μπορεί να:
- Χρησιμοποιήσει το
web_searchγια να βρει πληροφορίες (αυτόματη εκτέλεση στην πλευρά του διακομιστή) - Καλέσει το
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) δημιουργούνται αυτόματα για δεδομένα από εργαλεία διακομιστή