Προσαρμοσμένες συναρτήσεις (κλήση συναρτήσεων)
Σε αυτήν τη σελίδα
Σύνδεση του Grok με τις δικές σας υπηρεσίες
Τα εργαλεία διακομιστή (web_search, x_search, code_interpreter) είναι χρήσιμα, αλλά περιορίζονται στις υπηρεσίες της xAI. Με προσαρμοσμένα εργαλεία function, μπορείτε να συνδέσετε το Grok με οποιοδήποτε API ή υπηρεσία στην υποδομή σας.
Πώς λειτουργεί
Η κλήση συναρτήσεων ακολουθεί έναν κύκλο τριών βημάτων:
- Δήλωση: Περιγράφετε τις συναρτήσεις σας (όνομα, περιγραφή, παράμετροι) στο αίτημα.
- Κλήση: Το μοντέλο δημιουργεί μια κλήση συνάρτησης με τα κατάλληλα ορίσματα και διακόπτει τη δημιουργία.
- Αποτέλεσμα: Ο κώδικάς σας εκτελεί τη συνάρτηση και στη συνέχεια στέλνετε το αποτέλεσμα πίσω στο μοντέλο, ώστε να διατυπώσει την απάντησή του.
Δήλωση μιας συνάρτησης
{
"model": "grok-4.20-0309-reasoning",
"input": "Book me a table for 2 people tonight at 8 PM.",
"tools": [{
"type": "function",
"name": "book_restaurant",
"description": "Books a table at a restaurant",
"parameters": {
"type": "object",
"properties": {
"restaurant_name": {
"type": "string",
"description": "Restaurant name"
},
"date": {
"type": "string",
"description": "Date in YYYY-MM-DD format"
},
"time": {
"type": "string",
"description": "Time in HH:MM format"
},
"guests": {
"type": "integer",
"description": "Number of guests"
}
},
"required": ["date", "time", "guests"]
}
}]
}
Η περιγραφή κάθε συνάρτησης και παραμέτρου είναι κρίσιμη. Το μοντέλο τις χρησιμοποιεί για να αποφασίσει πότε θα καλέσει τη συνάρτηση και πώς θα συμπληρώσει τα ορίσματα.
Λήψη της κλήσης συνάρτησης
Όταν το μοντέλο αποφασίσει να καλέσει τη συνάρτησή σας, η απάντηση περιέχει ένα στοιχείο function_call:
{
"id": "resp-xyz789",
"status": "completed",
"output": [{
"type": "function_call",
"name": "book_restaurant",
"arguments": "{\"date\": \"2026-04-03\", \"time\": \"20:00\", \"guests\": 2}",
"call_id": "call-abc123"
}]
}
Το πεδίο arguments είναι μια συμβολοσειρά JSON που πρέπει να αναλύσετε. Το call_id αναγνωρίζει αυτή τη συγκεκριμένη κλήση.
Επιστροφή του αποτελέσματος
Αφού εκτελέσετε τη συνάρτηση στον κώδικά σας, επιστρέψτε το αποτέλεσμα:
import json
# 1. Initial request
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What's the weather like in Paris?",
tools=[{
"type": "function",
"name": "get_weather",
"description": "Retrieves current weather",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}]
)
# 2. Check if the model wants to call a function
for item in response.output:
if item.type == "function_call":
args = json.loads(item.arguments)
# 3. Execute your function
weather_data = get_weather_from_api(args["city"])
# 4. Return the result to the model
final = client.responses.create(
model="grok-4.20-0309-reasoning",
input=[{
"type": "function_call_output",
"call_id": item.call_id,
"output": json.dumps(weather_data)
}],
previous_response_id=response.id
)
print(final.output[0].content[0].text)
Βέλτιστες πρακτικές για τις περιγραφές
Το μοντέλο βασίζεται στις περιγραφές για να κατανοήσει τις συναρτήσεις σας. Να είστε ακριβείς:
{
"name": "search_products",
"description": "Searches for products in the e-commerce catalog. Returns the top 10 results sorted by relevance. Supports search by name, category, or price range.",
"parameters": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search terms (product name, brand, keyword)"
},
"category": {
"type": "string",
"enum": ["electronics", "clothing", "home", "sports"],
"description": "Product category to filter"
},
"max_price": {
"type": "number",
"description": "Maximum price in euros"
}
},
"required": ["query"]
}
}
Χρησιμοποιήστε enum για προκαθορισμένες τιμές, λεπτομερή description για κάθε παράμετρο και ορίστε ως required μόνο τις απαραίτητες παραμέτρους.
Διαχείριση σφαλμάτων
Εάν η συνάρτησή σας αποτύχει, επιστρέψτε το σφάλμα ως αποτέλεσμα:
try:
result = call_external_api(args)
output = json.dumps(result)
except Exception as e:
output = json.dumps({"error": str(e)})
final = client.responses.create(
model="grok-4.20-0309-reasoning",
input=[{
"type": "function_call_output",
"call_id": call_id,
"output": output
}],
previous_response_id=response.id
)
Το μοντέλο ερμηνεύει το σφάλμα και μπορεί να διατυπώσει εκ νέου την απάντησή του ή να δοκιμάσει μια διαφορετική προσέγγιση.
Βασικά σημεία
- Οι προσαρμοσμένες συναρτήσεις συνδέουν το Grok με τις δικές σας υπηρεσίες.
- Ο κύκλος είναι: δήλωση, λήψη κλήσης, εκτέλεση, επιστροφή αποτελέσματος.
- Οι περιγραφές των συναρτήσεων και των παραμέτρων καθοδηγούν την επιλογή του μοντέλου.
- Το πεδίο
argumentsείναι μια συμβολοσειρά JSON που πρέπει να αναλυθεί στην πλευρά του πελάτη. - Επιστρέψτε τα σφάλματα ως αποτελέσματα, ώστε το μοντέλο να μπορεί να προσαρμοστεί.