Οι δύο κατηγορίες εργαλείων Grok
Σε αυτήν τη σελίδα
Κατανοήστε το οικοσύστημα εργαλείων του Grok API
Το Grok API κάνει περισσότερα από το να παράγει απλώς κείμενο. Παρέχει ένα σύνολο εργαλείων που επιτρέπουν στο μοντέλο να αλληλεπιδρά με τον εξωτερικό κόσμο: αναζήτηση πληροφοριών σε πραγματικό χρόνο, ανάλυση δεδομένων στα μέσα κοινωνικής δικτύωσης ή εκτέλεση κώδικα Python. Για να αξιοποιήσετε αυτές τις δυνατότητες, πρέπει να κατανοήσετε πώς οργανώνονται.
Το Grok API διακρίνει δύο θεμελιώδεις κατηγορίες εργαλείων. Αυτή η διάκριση καθορίζει ποιος εκτελεί το εργαλείο, πού λαμβάνει χώρα η επεξεργασία και τι πρέπει να διαχειριστείτε εσείς ως προγραμματιστές.
Ενσωματωμένα εργαλεία — Πλευρά διακομιστή (Server-Side)
Τα ενσωματωμένα εργαλεία εκτελούνται απευθείας στους διακομιστές της xAI. Όταν το μοντέλο αποφασίσει να χρησιμοποιήσει ένα από αυτά τα εργαλεία, η εκτέλεση είναι αυτόματη και διαφανής. Δεν χρειάζεται να διαχειριστείτε καμία υποδομή ούτε να επεξεργαστείτε ενδιάμεσα αποτελέσματα.
Ακολουθούν τα πέντε διαθέσιμα ενσωματωμένα εργαλεία:
- Web Search (
web_search): Αναζήτηση στον ιστό σε πραγματικό χρόνο, με φιλτράρισμα τομέων και αυτόματες παραπομπές - X Search (
x_search): Αναζήτηση στο X/Twitter, με φιλτράρισμα λογαριασμού και ημερομηνίας - Code Execution (
code_interpreter/code_execution): Εκτέλεση κώδικα Python σε ένα ασφαλές, απομονωμένο περιβάλλον (sandbox) - Collections Search (
collections_search/file_search): Αναζήτηση εντός εγγράφων που έχετε ανεβάσει προηγουμένως - Remote MCP (
mcp): Σύνδεση με εξωτερικούς διακομιστές MCP (Model Context Protocol)
Για να ενεργοποιήσετε ένα ενσωματωμένο εργαλείο, απλώς προσθέστε το στον πίνακα tools στο αίτημά σας:
{
"tools": [{"type": "web_search"}]
}
Κλήση συναρτήσεων (Function Calling) — Πλευρά πελάτη (Client-Side)
Η Κλήση Συναρτήσεων λειτουργεί διαφορετικά. Εσείς ορίζετε προσαρμοσμένες συναρτήσεις που το μοντέλο μπορεί να καλέσει. Ωστόσο, σε αντίθεση με τα ενσωματωμένα εργαλεία, ο κώδικας στην πλευρά του πελάτη (client-side) εκτελεί τη συνάρτηση και επιστρέφει το αποτέλεσμα στο μοντέλο.
Η ροή είναι η εξής:
- Περιγράφετε τις συναρτήσεις σας (όνομα, παράμετροι, περιγραφή) στο αίτημα
- Το μοντέλο αναλύει το αίτημα του χρήστη
- Εάν διαπιστώσει ότι απαιτείται συνάρτηση, επιστρέφει μια κλήση συνάρτησης με ορίσματα
- Ο κώδικάς σας εκτελεί τη συνάρτηση (κλήση API, ερώτημα βάσης δεδομένων, υπολογισμός κ.λπ.)
- Στέλνετε το αποτέλεσμα πίσω στο μοντέλο
- Το μοντέλο διαμορφώνει την τελική του απάντηση
Αυτή η προσέγγιση σας προσφέρει πλήρη έλεγχο: εσείς αποφασίζετε τι κάνουν οι συναρτήσεις σας, ποια δεδομένα διαχειρίζονται και πώς συνδέονται με την υποδομή σας.
Πότε να χρησιμοποιήσετε κάθε κατηγορία
Τα ενσωματωμένα εργαλεία είναι ιδανικά όταν χρειάζεστε πρόσβαση σε πληροφορίες σε πραγματικό χρόνο (ιστός, μέσα κοινωνικής δικτύωσης) ή όταν πρέπει να εκτελέσετε υπολογισμούς χωρίς να διαχειριστείτε υποδομή. Η Κλήση Συναρτήσεων προτιμάται όταν χρειάζεται να αλληλεπιδράσετε με τα δικά σας συστήματα: εσωτερικές βάσεις δεδομένων, επιχειρηματικά API ή οποιαδήποτε υπηρεσία ειδική για την εφαρμογή σας.
Μπορείτε να συνδυάσετε και τις δύο κατηγορίες σε ένα ενιαίο αίτημα. Για παράδειγμα, μπορείτε να ενεργοποιήσετε την Αναζήτηση Ιστού (Web Search) ενώ ταυτόχρονα ορίζετε μια προσαρμοσμένη συνάρτηση που αποθηκεύει τα αποτελέσματα στη βάση δεδομένων σας.
Βασικά σημεία
- Το Grok API προσφέρει δύο κατηγορίες εργαλείων: ενσωματωμένα εργαλεία (εκτελούνται από την xAI) και Κλήση Συναρτήσεων (εκτελούνται από τον κώδικά σας)
- Τα ενσωματωμένα εργαλεία δεν απαιτούν υποδομή στην πλευρά του πελάτη
- Η Κλήση Συναρτήσεων προσφέρει πλήρη έλεγχο, αλλά απαιτεί περισσότερη ανάπτυξη
- Και οι δύο κατηγορίες μπορούν να συνδυαστούν σε ένα ενιαίο αίτημα
- Αυτό το μάθημα εστιάζει στα τρία κύρια ενσωματωμένα εργαλεία: Web Search, X Search και Code Execution