Responses API και function_call_output
Σε αυτήν τη σελίδα
Το Responses API: το νέο endpoint
Το Responses API είναι το νέο κύριο endpoint της xAI, ξεχωριστό από το endpoint Chat Completions που είναι συμβατό με το OpenAI. Εισάγει μια διαφορετική μορφή για την κλήση συναρτήσεων, χρησιμοποιώντας τον τύπο function_call_output για την επιστροφή αποτελεσμάτων εργαλείων.
Διαφορές από το Chat Completions
Το endpoint Chat Completions (συμβατό με OpenAI) χρησιμοποιεί μηνύματα με ρόλο tool για την επιστροφή αποτελεσμάτων. Το Responses API χρησιμοποιεί μια διαφορετική μορφή, δομημένη γύρω από τύπους συμβάντων.
Chat Completions (παλιά μορφή)
# Επιστροφή αποτελέσματος μέσω μηνύματος με ρόλο "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (νέα μορφή)
# Επιστροφή αποτελέσματος μέσω αντικειμένου function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Βασικές διαφορές:
- Το
type: "function_call_output"αντικαθιστά τοrole: "tool" - Το
call_idαντικαθιστά τοtool_call_id - Το
outputαντικαθιστά τοcontent
Χρήση του Responses API με το OpenAI SDK
Μπορείτε να χρησιμοποιήσετε το OpenAI SDK για να καλέσετε το Responses API της xAI:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Δημιουργία απάντησης με εργαλεία
response = client.responses.create(
model="grok-4.5",
input="What's the weather like in Paris?",
tools=[{
"type": "function",
"name": "get_weather",
"description": "Get the weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}]
)
Σημειώστε ότι το Responses API χρησιμοποιεί το input αντί για το messages, και η δομή των εργαλείων διαφέρει ελαφρώς (δεν υπάρχει ένθετο αντικείμενο function).
Διαχείριση της απάντησης
Η απάντηση του Responses API περιέχει έναν πίνακα output με συμβάντα:
for item in response.output:
if item.type == "function_call":
print(f"Function: {item.name}")
print(f"Arguments: {item.arguments}")
print(f"Call ID: {item.call_id}")
# Εκτέλεση της συνάρτησης
result = get_weather(city="Paris")
# Συνέχεια της συνομιλίας με το αποτέλεσμα
follow_up = client.responses.create(
model="grok-4.5",
input=[
{"type": "function_call_output",
"call_id": item.call_id,
"output": json.dumps(result)}
],
tools=tools,
previous_response_id=response.id
)
Το πεδίο previous_response_id
Το Responses API εισάγει έναν μηχανισμό αλυσίδωσης συνομιλιών μέσω του previous_response_id. Αντί να στέλνετε ξανά ολόκληρο το ιστορικό μηνυμάτων, απλώς αναφέρεστε στην προηγούμενη απάντηση:
# Πρώτο αίτημα
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Δεύτερο αίτημα (αλυσιδωτό)
response2 = client.responses.create(
model="grok-4.5",
input=[{
"type": "function_call_output",
"call_id": response1.output[0].call_id,
"output": {temp: 22}
}],
previous_response_id=response1.id
)
Αυτό απλοποιεί τη διαχείριση του συμφραζόμενου και μειώνει το μέγεθος του αιτήματος.
Αποθήκευση μηνυμάτων στον διακομιστή
Με την επιλογή store_messages=True, η xAI αποθηκεύει τα μηνύματα στους διακομιστές της:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
Σε συνδυασμό με το previous_response_id, αυτό σας επιτρέπει να διατηρείτε μακρές συνομιλίες χωρίς να χρειάζεται να στέλνετε ξανά ολόκληρο το ιστορικό με κάθε αίτημα.
Πότε να χρησιμοποιήσετε το Responses API;
Για ένα νέο έργο χτισμένο ειδικά πάνω στην xAI, το Responses API είναι η προεπιλεγμένη επιλογή, για πολλούς αθροιστικούς λόγους. Οι καινοτομίες φτάνουν εδώ πρώτες—νέα χαρακτηριστικά προστίθενται στο Responses API πριν από οπουδήποτε αλλού, μερικές φορές αποκλειστικά. Ορισμένα ενσωματωμένα εργαλεία διακομιστή είναι διαθέσιμα μόνο μέσω αυτού του καναλιού. Και για μακρές συνομιλίες, η αλυσίδωση μέσω του previous_response_id είναι δομικά πιο αποδοτική από το να στέλνετε ξανά ολόκληρο το ιστορικό σε κάθε βήμα: λιγότερα tokens μεταφέρονται, λιγότερος κώδικας διαχείρισης κατάστασης από την πλευρά σας.
Το Chat Completions διατηρεί δύο ισχυρές περιπτώσεις χρήσης: υπάρχοντα κώδικα γραμμένο για το API του OpenAI, ο οποίος λειτουργεί ως έχει αλλάζοντας απλώς το base URL, και έργα πολλαπλών παρόχων όπου η φορητότητα έχει προτεραιότητα—σε αυτές τις περιπτώσεις, η συμβατότητα υπερισχύει των αποκλειστικών χαρακτηριστικών.
Βασικά σημεία
- Το Responses API χρησιμοποιεί το
function_call_outputαντί για τον ρόλοtool - Τα πεδία αλλάζουν:
call_idαντί γιαtool_call_id,outputαντί γιαcontent - Το
previous_response_idσας επιτρέπει να αλυσιδώνετε συνομιλίες χωρίς να στέλνετε ξανά το ιστορικό - Το
store_messages=Trueενεργοποιεί την αποθήκευση στον διακομιστή - Το Responses API είναι το προτεινόμενο endpoint για νέα έργα xAI
- Το Chat Completions παραμένει διαθέσιμο για οπισθοσυμβατότητα με το OpenAI