Συνδυασμός Εργαλείων Διακομιστή και Πελάτη
Σε αυτήν τη σελίδα
Υβριδικές Ροές Εργασίας
Η πραγματική δύναμη του Responses API αναδύεται όταν συνδυάζετε εργαλεία διακομιστή (που εκτελούνται αυτόματα από την xAI) και εργαλεία πελάτη (τις δικές σας προσαρμοσμένες συναρτήσεις) σε ένα μόνο αίτημα. Το μοντέλο συντονίζει αυτά τα εργαλεία αυτόνομα, δημιουργώντας σύνθετες ροές εργασίας με μόλις λίγες γραμμές κώδικα.
Συνδυασμός Εργαλείων Διακομιστή και Συναρτήσεων
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Search for the latest Ligue 1 soccer results and send a summary to my team.",
tools=[
{"type": "web_search"},
{
"type": "function",
"name": "send_team_message",
"description": "Sends a message to the team via Slack",
"parameters": {
"type": "object",
"properties": {
"channel": {"type": "string"},
"message": {"type": "string"}
},
"required": ["channel", "message"]
}
}
]
)
Σε αυτό το σενάριο, το μοντέλο:
- Ενεργοποιεί αυτόματα το
web_search(πλευρά διακομιστή) για να βρει τα αποτελέσματα - Ενσωματώνει τα δεδομένα σε μια σύνοψη
- Καλεί το
send_team_message(πλευρά πελάτη) ώστε ο κώδικάς σας να στείλει το μήνυμα στο Slack
Η Υβριδική Ροή Εκτέλεσης
Η ροή διαφέρει ανάλογα με τον τύπο του εργαλείου:
Μόνο Εργαλεία Διακομιστή
Request → [model → web_search → result → model] → Final response
Όλα συμβαίνουν στην πλευρά της xAI. Λαμβάνετε την τελική απάντηση απευθείας με τα αποτελέσματα ενσωματωμένα.
Μόνο Εργαλεία Πελάτη
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Το μοντέλο κάνει παύση, ο κώδικάς σας εκτελείται και στη συνέχεια στέλνετε πίσω το αποτέλεσμα.
Υβριδική Ροή
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Το μοντέλο χρησιμοποιεί πρώτα τα εργαλεία διακομιστή (αυτόματα) και στη συνέχεια καλεί τη συνάρτησή σας όταν χρειάζεται την υποδομή σας.
Κοινά Πρότυπα Συνδυασμού
Αναζήτηση + Ενέργεια
Συνδυάστε το web_search ή το x_search με μια συνάρτηση ενέργειας:
tools = [
{"type": "web_search"},
{"type": "x_search"},
{
"type": "function",
"name": "create_report",
"description": "Creates a report in the CRM",
"parameters": {
"type": "object",
"properties": {
"title": {"type": "string"},
"content": {"type": "string"},
"tags": {"type": "array", "items": {"type": "string"}}
},
"required": ["title", "content"]
}
}
]
Υπολογισμός + Ειδοποίηση
Συνδυάστε το code_interpreter με μια συνάρτηση ειδοποίησης:
tools = [
{"type": "code_interpreter"},
{
"type": "function",
"name": "send_alert",
"description": "Sends an alert if a threshold is exceeded",
"parameters": {
"type": "object",
"properties": {
"metric": {"type": "string"},
"value": {"type": "number"},
"threshold": {"type": "number"}
},
"required": ["metric", "value"]
}
}
]
Το max_turns και τα Υβριδικά Εργαλεία
Η συμπεριφορά του max_turns είναι σημαντική σε ένα υβριδικό πλαίσιο:
- Το
max_turnsπεριορίζει τους κύκλους πλευράς διακομιστή εντός ενός μόνο αιτήματος - Όταν το μοντέλο καλεί μια συνάρτηση πελάτη και ο κώδικάς σας επιστρέφει το αποτέλεσμα, ξεκινά μια νέα κατανομή του
max_turns
Πρακτικά, αυτό σημαίνει ότι οι κλήσεις πελάτη δεν εξαντλούν τον προϋπολογισμό κύκλων του διακομιστή. Το μοντέλο μπορεί να πραγματοποιήσει 3 αναζητήσεις web, να καλέσει τη συνάρτησή σας και στη συνέχεια να πραγματοποιήσει 3 επιπλέον αναζητήσεις αφού λάβει το αποτέλεσμα.
Πλαίσιο Πολλαπλών Γύρων με Αποθήκευση
Για σύνθετες ροές εργασίας που εκτείνονται σε πολλαπλές αλληλεπιδράσεις, συνδυάστε την αποθήκευση και την αλυσίδωση:
# Turn 1: initial search
r1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze AI market trends.",
tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
store=True,
max_turns=5
)
# Turn 2: deepen with your internal data
r2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Compare with our internal data.",
tools=[{
"type": "function",
"name": "query_internal_db",
"description": "Queries the internal database",
"parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
}],
previous_response_id=r1.id,
store=True
)
Βασικά σημεία
- Συνδυάστε εργαλεία διακομιστή και συναρτήσεις πελάτη σε ένα μόνο αίτημα για υβριδικές ροές εργασίας
- Τα εργαλεία διακομιστή εκτελούνται αυτόματα· οι συναρτήσεις πελάτη προκαλούν παύση στη δημιουργία
- Το
max_turnsεπαναφέρεται μετά από κάθε γύρο επικοινωνίας με τον πελάτη - Κοινά πρότυπα: αναζήτηση + ενέργεια, υπολογισμός + ειδοποίηση, συγχώνευση πολλαπλών πηγών
- Χρησιμοποιήστε
store: trueκαιprevious_response_idγια ροές εργασίας πολλαπλών γύρων