Ενσωματωμένα εργαλεία για το Responses API
Σε αυτήν τη σελίδα
Προσθήκη δυνατοτήτων στο μοντέλο
Τα μοντέλα Grok δεν περιορίζονται μόνο στη δημιουργία κειμένου. Χρησιμοποιώντας την παράμετρο tools, μπορείτε να τους προσφέρετε πρόσβαση σε εργαλεία που επεκτείνουν σημαντικά τις δυνατότητές τους: αναζήτηση στον ιστό σε πραγματικό χρόνο, αναζήτηση στο X (πρώην Twitter), εκτέλεση κώδικα Python και τις δικές σας προσαρμοσμένες συναρτήσεις.
Οι 4 τύποι εργαλείων
web_search
Επιτρέπει στο μοντέλο να αναζητά πληροφορίες στον ιστό σε πραγματικό χρόνο:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Το μοντέλο αποφασίζει αυτόματα πότε θα πραγματοποιήσει αναζήτηση. Τα αποτελέσματα ενσωματώνονται στην απάντησή του μαζί με παραπομπές.
x_search
Αναζητά αναρτήσεις στο X (πρώην Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Ιδιαίτερα χρήσιμο για την καταγραφή της κοινής γνώμης, των τάσεων και των αντιδράσεων σε πραγματικό χρόνο.
code_interpreter
Εκτελεί κώδικα Python στην πλευρά του διακομιστή για υπολογισμούς, ανάλυση δεδομένων ή δημιουργία γραφημάτων:
{
"model": "grok-4.20-0309-reasoning",
"input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
"tools": [{"type": "code_interpreter"}]
}
Το μοντέλο γράφει κώδικα Python, τον εκτελεί στους διακομιστές της xAI και ενσωματώνει τα αποτελέσματα στην απάντησή του.
function
Οι δικές σας συναρτήσεις που το μοντέλο μπορεί να καλέσει. Το μοντέλο δημιουργεί τα ορίσματα, αλλά ο δικός σας κώδικας εκτελεί τη συνάρτηση:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the weather in Paris?",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather for a given city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "City name"},
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
},
"required": ["city"]
}
}]
}
Συνδυασμός πολλαπλών εργαλείων
Μπορείτε να συμπεριλάβετε έως και 128 εργαλεία σε ένα μόνο αίτημα. Το μοντέλο επιλέγει εκείνο (ή εκείνα) που ταιριάζουν:
{
"model": "grok-4.20-0309-reasoning",
"input": "Search for the latest Ligue 1 results and create a scoreboard.",
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Σε αυτό το παράδειγμα, το μοντέλο μπορεί αρχικά να χρησιμοποιήσει το web_search για να βρει τα αποτελέσματα και στη συνέχεια το code_interpreter για να τα μορφοποιήσει σε πίνακα.
Εργαλεία πλευράς διακομιστή vs πλευράς πελάτη
Η διάκριση είναι θεμελιώδης:
-
Εργαλεία πλευράς διακομιστή (
web_search,x_search,code_interpreter): Εκτελούνται αυτόματα από τους διακομιστές της xAI. Δεν χρειάζεται να κάνετε τίποτα· το μοντέλο ξεκινά την αναζήτηση ή τον κώδικα, ανακτά το αποτέλεσμα και το ενσωματώνει στην απάντησή του. -
Εργαλεία πλευράς πελάτη (
function): Το μοντέλο δημιουργεί μια κλήση συνάρτησης με ορίσματα και στη συνέχεια παύει τη δημιουργία. Ο δικός σας κώδικας εκτελεί τη συνάρτηση και εσείς στέλνετε το αποτέλεσμα πίσω σε ένα νέο αίτημα.
Αυτή η διαφορά επηρεάζει άμεσα την αρχιτεκτονική της εφαρμογής σας, όπως θα δείτε στα επόμενα μαθήματα.
Βασικά σημεία
- Τέσσερις τύποι εργαλείων:
web_search,x_search,code_interpreter,function - Τα τρία πρώτα εκτελούνται στην πλευρά του διακομιστή — δεν απαιτείται υποδομή από εσάς
- Τα εργαλεία
functionεκτελούνται στην πλευρά του πελάτη — ο δικός σας κώδικας χειρίζεται την εκτέλεση - Μπορείτε να συνδυάσετε έως και 128 εργαλεία ανά αίτημα
- Το μοντέλο αποφασίζει αυτόματα πότε και ποια εργαλεία θα χρησιμοποιήσει