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

Εκτέλεση και Επιστροφή του Αποτελέσματος

Μάθημα 6 / 14 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το Βήμα που Ελέγχετε Πλήρως
  2. Εκτέλεση της Συνάρτησης στην Πλευρά του Πελάτη
  3. Δημιουργία του Μηνύματος Εργαλείου
  4. Αποστολή του Αποτελέσματος και Λήψη της Τελικής Απόκρισης
  5. Η Πλήρης Ροή σε Ένα Μπλοκ
  6. Δομή Μηνύματος σε Κάθε Βήμα
  7. Προσοχή στη Μορφή του Περιεχομένου
  8. Βασικά σημεία

Το Βήμα που Ελέγχετε Πλήρως

Λάβατε ένα tool_call από το μοντέλο. Σας λέει ποια συνάρτηση να καλέσετε και με ποια ορίσματα—τίποτα περισσότερο. Τώρα ο κώδικάς σας αναλαμβάνει: εκτελεί τη συνάρτηση, ανακτά το αποτέλεσμα και το στέλνει πίσω στο μοντέλο ως μήνυμα με ρόλο tool. Αυτό το μάθημα καλύπτει ολόκληρη αυτή τη διαδρομή μετ’ επιστροφής. Αυτή είναι η μοναδική στιγμή στον κύκλο όπου εσείς λαμβάνετε όλες τις αποφάσεις.

Εκτέλεση της Συνάρτησης στην Πλευρά του Πελάτη

Ας επανεξετάσουμε το λεξικό δρομολόγησης από το Μάθημα 4 και ας το συνδέσουμε με την απόκριση του μοντέλου.

import json
from functools import partial

# Συναρτήσεις ήδη ορισμένες
available_functions = {
    "retrieve_payment_status": partial(retrieve_payment_status, df),
    "retrieve_payment_date": partial(retrieve_payment_date, df),
}

# Το μοντέλο επέστρεψε ένα tool_call
tool_call = response.choices[0].message.tool_calls[0]
function_name = tool_call.function.name
function_params = json.loads(tool_call.function.arguments)

# Εκτέλεση της συνάρτησης
if function_name in available_functions:
    result = available_functions[function_name](**function_params)
    print(f"Result: {result}")
    # → '{"status": "paid"}'
else:
    result = json.dumps({"error": f"Function {function_name} not available"})

Δύο μηχανισμοί λειτουργούν εδώ. Ο πρώτος είναι το **function_params, το οποίο αποσυσκευάζει το λεξικό από το JSON σε ονομαζόμενα ορίσματα: αν το μοντέλο παρήγαγε {"transaction_id": "T1001"}, η κλήση είναι ακριβώς ισοδύναμη με retrieve_payment_status(transaction_id="T1001"). Ο δεύτερος είναι το μπλοκ else. Είναι λιγότερο εντυπωσιακό αλλά απαραίτητο. Ένα μοντέλο μπορεί να παραισθησιογενεί (hallucinate) ένα όνομα συνάρτησης που δεν υπάρχει στη δρομολόγησή σας· χωρίς αυτόν τον έλεγχο, η εφαρμογή σας θα προκαλέσει ένα KeyError και η συνομιλία θα σταματήσει απότομα. Με αυτόν, το σφάλμα γίνεται δεδομένο που το μοντέλο μπορεί να διαχειριστεί ομαλά.

Δημιουργία του Μηνύματος Εργαλείου

Το αποτέλεσμα πρέπει να επιστρέψει στο μοντέλο σε μια συγκεκριμένη μορφή—ένα μήνυμα με ρόλο "tool":

tool_message = {
    "role": "tool",
    "name": function_name,
    "content": result,  # Πρέπει να είναι συμβολοσειρά
    "tool_call_id": tool_call.id
}
ΠεδίοΡόλος
role"tool"—ταυτοποιεί το μήνυμα ως αποτέλεσμα συνάρτησης
nameΤο όνομα της εκτελεσθείσας συνάρτησης
contentΤο αποτέλεσμα ως συμβολοσειρά JSON
tool_call_idΤο ID του αρχικού tool_call—επιτρέπει στο μοντέλο να αντιστοιχίσει το αποτέλεσμα στη σωστή κλήση

Αποστολή του Αποτελέσματος και Λήψη της Τελικής Απόκρισης

Το μοντέλο δεν έχει μνήμη από τη μία κλήση στην επόμενη: δεν θυμάται ότι σας ζήτησε κάτι. Επομένως, πρέπει να ξαναχτίσετε ολόκληρη τη συνομιλία για αυτό, συμπεριλαμβανομένου του δικού του αιτήματος για κλήση εργαλείου, πριν παρουσιάσετε το αποτέλεσμα.

# 1. Προσθήκη του μηνύματος του βοηθού (με το tool_call)
messages.append(response.choices[0].message)

# 2. Προσθήκη του αποτελέσματος της συνάρτησης
messages.append({
    "role": "tool",
    "name": function_name,
    "content": result,
    "tool_call_id": tool_call.id
})

# 3. Κλήση του μοντέλου ξανά με το πλήρες πλαίσιο
final_response = client.chat.complete(
    model="mistral-large-latest",
    messages=messages,
    tools=tools
)

# 4. Εμφάνιση της τελικής απόκρισης
print(final_response.choices[0].message.content)
# → "Payment T1001 status is: paid."

Η σειρά των δύο λειτουργιών append είναι αδιαπραγμάτευτη: το μήνυμα του βοηθού που φέρει το tool_call πρέπει να έρχεται πριν από το μήνυμα tool που το απαντά. Η εναλλαγή τους δημιουργεί ένα ασυνεπές ιστορικό που το API απορρίπτει.

Η Πλήρης Ροή σε Ένα Μπλοκ

Ορίστε η entire διαδικασία, από την ερώτηση του χρήστη μέχρι την τελική απάντηση:

import os
import json
from mistralai.client import Mistral
from functools import partial

# Διαμόρφωση
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
model = "mistral-large-latest"

# Συναρτήσεις και εργαλεία (ορισμένα νωρίτερα)
available_functions = {
    "retrieve_payment_status": partial(retrieve_payment_status, df),
    "retrieve_payment_date": partial(retrieve_payment_date, df),
}

# Βήματα 1-2: Ερώτηση χρήστη + κλήση API
messages = [
    {"role": "user", "content": "What is the status of payment T1001?"}
]

response = client.chat.complete(
    model=model, messages=messages, tools=tools
)

# Βήματα 3-4: Εξαγωγή του tool_call και εκτέλεση
message = response.choices[0].message

if message.tool_calls:
    tool_call = message.tool_calls[0]
    function_name = tool_call.function.name
    function_params = json.loads(tool_call.function.arguments)

    # Εκτέλεση στην πλευρά του πελάτη
    result = available_functions[function_name](**function_params)

    # Βήμα 5: Αποστολή του αποτελέσματος πίσω στο μοντέλο
    messages.append(message)
    messages.append({
        "role": "tool",
        "name": function_name,
        "content": result,
        "tool_call_id": tool_call.id
    })

    final_response = client.chat.complete(
        model=model, messages=messages, tools=tools
    )
    print(final_response.choices[0].message.content)
else:
    print(message.content)

Δομή Μηνύματος σε Κάθε Βήμα

Αξίζει να επιθεωρήσετε τη λίστα messages μόλις ολοκληρωθεί ο κύκλος, καθώς είναι ο καλύτερος τρόπος για να εντοπίσετε δυσλειτουργίες στην κλήση συναρτήσεων. Περιέχει τέσσερα μηνύματα.

# Μήνυμα 1: Η ερώτηση του χρήστη
{"role": "user", "content": "What is the status of payment T1001?"}

# Μήνυμα 2: Η απόκριση του μοντέλου με το tool_call
{"role": "assistant", "tool_calls": [{"id": "call_abc123", ...}]}

# Μήνυμα 3: Το αποτέλεσμα της συνάρτησης
{"role": "tool", "name": "retrieve_payment_status",
 "content": '{"status": "paid"}', "tool_call_id": "call_abc123"}

# Μήνυμα 4 (υπονοούμενο): Η τελική απόκριση του μοντέλου
# → "Payment T1001 status is: paid."

Ακολουθήστε το ID call_abc123: γεννιέται στο Μήνυμα 2 και επανεμφανίζεται στο Μήνυμα 3. Αυτό το νήμα συνδέει το αίτημα με την απάντησή του. Αυτή η δομή είναι το θεμελιώδες μοτίβο της κλήσης συναρτήσεων· κάθε παραλλαγή που θα συναντήσετε αργότερα, είτε πολυβηματική είτε παράλληλη, απλώς το επαναλαμβάνει ή το διπλασιάζει.

Προσοχή στη Μορφή του Περιεχομένου

Ένα σφάλμα εμφανίζεται πιο συχνά από όλα τα άλλα, και οφείλεται στον τύπο του πεδίου content: πρέπει πάντα να είναι συμβολοσειρά.

# Σωστό — Συμβολοσειρά JSON
{"content": '{"status": "paid"}'}

# Σωστό — Απλό κείμενο
{"content": "The status is paid"}

# Λάθος — Λεξικό Python (θα προκαλέσει σφάλμα)
{"content": {"status": "paid"}}

Η διαφορά μεταξύ του πρώτου και του τρίτου παραδείγματος έγκειται στα εισαγωγικά που περιβάλλουν το JSON. Αν η συνάρτησή σας επιστρέφει ένα λεξικό, μετατρέψτε το με json.dumps() πριν την αποστολή—αυτός είναι ακριβώς ο λόγος για τον οποίο όλες οι συναρτήσεις στο Μάθημα 4 τελείωναν με ένα json.dumps().

Βασικά σημεία

  • Η εκτέλεση της συνάρτησης γίνεται στην πλευρά του πελάτη, στον κώδικά σας—ποτέ από το μοντέλο
  • Το αποτέλεσμα στέλνεται πίσω σε ένα μήνυμα με ρόλο "tool" και το αντίστοιχο tool_call_id
  • Το content του μηνύματος εργαλείου πρέπει να είναι συμβολοσειρά (μια συμβολοσειρά JSON)
  • Αφού στείλετε το αποτέλεσμα, καλείτε ξανά το chat.complete() ώστε το μοντέλο να διατυπώσει την τελική απόκριση
  • Επαληθεύετε πάντα ότι η ζητούμενη συνάρτηση υπάρχει στο λεξικό δρομολόγησής σας