Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Responses API και function_call_output

Μάθημα 10 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το Responses API: το νέο endpoint
  2. Διαφορές από το Chat Completions
  3. Χρήση του Responses API με το OpenAI SDK
  4. Διαχείριση της απάντησης
  5. Το πεδίο previous_response_id
  6. Αποθήκευση μηνυμάτων στον διακομιστή
  7. Πότε να χρησιμοποιήσετε το Responses API;
  8. Βασικά σημεία

Το 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