Συλλογισμός σε πράκτορες και συνομιλίες
Σε αυτήν τη σελίδα
Μάθημα ξαναγραμμένο στις 2 Νοεμβρίου 2026 για τα Mistral Small 4 και Large 4. Η τεκμηρίωση της Mistral αναφέρει ότι το
reasoning_effortείναι διαθέσιμο στα endpoints Agents και Conversations μέσα στο πεδίοcompletion_args. Πηγές: Reasoning · Python SDK — Conversations.
Τρεις τρόποι κλήσης ενός μοντέλου συλλογισμού
Τα προηγούμενα μαθήματα χρησιμοποίησαν το API Chat Completions: στέλνατε το πλήρες ιστορικό με κάθε κλήση και το reasoning_effort τοποθετούνταν απευθείας στο αίτημα. Η Mistral προσφέρει δύο ακόμη διεπαφές: το Agents API, το οποίο αποθηκεύει μια επαναχρησιμοποιήσιμη διαμόρφωση (μοντέλο, οδηγίες, εργαλεία, παράμετροι), και το Conversations API, το οποίο διατηρεί το ιστορικό στον διακομιστή. Σε αυτά τα δύο API, δεν ορίζετε τον συλλογισμό στο ανώτατο επίπεδο· τον ενσωματώνετε μέσα στο completion_args μαζί με άλλες παραμέτρους δημιουργίας.
Ένας πράκτορας που συλλογίζεται
Ο ορισμός του επιπέδου συλλογισμού στον ορισμό του πράκτορα αποφεύγει την επανάληψή του σε κάθε κλήση και διασφαλίζει ότι όλη η ομάδα σας χρησιμοποιεί την ίδια ρύθμιση:
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
agent = client.beta.agents.create(
model="mistral-small-2603",
name="Financial Analyst",
instructions=(
"You analyze financial situations for SMEs. "
"End every response with a quantified recommendation and its assumptions."
),
completion_args={"reasoning_effort": "high"},
)
reponse = client.beta.conversations.start(
agent_id=agent.id,
inputs="Our working capital requirement has doubled in a year while revenue grew by 15%. What should we look at first?",
)
Ανάγνωση εξόδων συνομιλίας
Μια συνομιλία δεν επιστρέφει choices· επιστρέφει μια λίστα εγγραφών (outputs). Η απάντηση του μοντέλου βρίσκεται σε εγγραφές τύπου message.output. Όπως και στα Chat Completions, το περιεχόμενο είναι είτε μια συμβολοσειρά είτε μια λίστα τμημάτων που μπορεί να περιλαμβάνουν ένα ThinkChunk. Η συνάρτηση separer από το Μάθημα 3 λειτουργεί ακριβώς όπως πριν:
for entry in reponse.outputs:
if entry.type == "message.output":
reflexion, texte = separer(entry.content)
print(texte)
Άλλες εγγραφές περιγράφουν τι συνέβη κατά τη διάρκεια του γύρου, όπως η εκτέλεση εργαλείου (tool.execution) ή μια κλήση συνάρτησης. Αγνοήστε τες αν σας ενδιαφέρει μόνο η τελική απάντηση.
Μια συνομιλία χωρίς πράκτορα
Για εφάπαξ εργασίες, το Conversations API δέχεται απευθείας ένα μοντέλο, χωρίς προηγούμενη ρύθμιση πράκτορα. Ο διακομιστής διατηρεί το ιστορικό και εσείς συνεχίζετε την ανταλλαγή με το conversations.append, προσαρμόζοντας το επίπεδο συλλογισμού για έναν συγκεκριμένο γύρο εάν χρειάζεται:
conv = client.beta.conversations.start(
model="mistral-large-4-0",
inputs="Propose a migration plan for a 2 TB PostgreSQL database with zero downtime.",
completion_args={"reasoning_effort": "high"},
)
suite = client.beta.conversations.append(
conversation_id=conv.conversation_id,
inputs="Summarize this plan in five steps for executive leadership.",
completion_args={"reasoning_effort": "low"}, # a summary doesn't need deep reflection
)
Αυτό αποτελεί ένα συγκεκριμένο πλεονέκτημα έναντι των Chat Completions, όπου η τεκμηρίωση απαιτεί να επαναλαμβάνετε το πλήρες μήνυμα του βοηθού, συμπεριλαμβανομένου του συλλογισμού, σε κάθε νέο γύρο (Μάθημα 7). Με το Conversations API, ο διακομιστής διατηρεί το ιστορικό· δεν χρειάζεται να το ξαναστείλετε σε κάθε κλήση.
Συλλογισμός και εργαλεία
Ένας πράκτορας μπορεί να συνδυάσει συλλογισμό και εργαλεία: τα tools και το completion_args είναι ανεξάρτητα πεδία κατά τη δημιουργία ενός πράκτορα. Ένας πράκτορας ανάλυσης μπορεί έτσι να διαθέτει αναζήτηση στον ιστό και βαθύ συλλογισμό:
agent_veille = client.beta.agents.create(
model="mistral-small-2603",
name="Competitive Intelligence",
instructions="You compare competitor offers using cited public sources.",
tools=[{"type": "web_search"}],
completion_args={"reasoning_effort": "high"},
)
Προσέξτε όμως το κόστος: ο συλλογισμός και οι κλήσεις εργαλείων αθροίζονται στον λογαριασμό για έναν μόνο γύρο.
Σύγκριση των τριών προσεγγίσεων
| Κριτήριο | Chat Completions | Agents | Conversations |
|---|---|---|---|
| Πού ορίζεται ο συλλογισμός | reasoning_effort στο αίτημα | completion_args στον πράκτορα | completion_args στο start ή append |
| Ιστορικό | Επαναποστολή σε κάθε κλήση, συμπεριλαμβανομένου του συλλογισμού | Μεταφέρεται από τη συνομιλία | Διατηρείται στον διακομιστή |
Ενσωματωμένα εργαλεία (web_search…) | Όχι | Ναι | Ναι |
| Τυπική χρήση | Εφάπαξ κλήσεις, πλήρης έλεγχος | Κοινή, επαναχρησιμοποιήσιμη διαμόρφωση | Ανταλλαγές πολλαπλών γύρων |
Βέλτιστες πρακτικές ενσωμάτωσης
Ορίστε το επίπεδο συλλογισμού στον πράκτορα όταν η εργασία είναι ομοιόμορφη και ανά γύρο όταν ποικίλλει: ένας αρχικός γύρος ανάλυσης με high, ακολουθούμενος από γύρους διατύπωσης με low ή none, ανάλογα με το μοντέλο. Επαληθεύστε ότι η τιμή ταιριάζει στο μοντέλο του πράκτορα: το Small 4 δέχεται high και none· το Large 4 δέχεται low, medium και high. Τέλος, καταγράψτε τη χρήση token ανά γύρο· είναι ο μόνος τρόπος να γνωρίζετε εάν ο συλλογισμός αποδίδει για τη δική σας περίπτωση χρήσης.
Βασικά σημεία
- Στα API Agents και Conversations, περάστε το
reasoning_effortμέσα στοcompletion_args - Οι απαντήσεις φτάνουν στα
outputs· το κείμενο βρίσκεται σε εγγραφέςmessage.output, συμπεριλαμβανομένου του συλλογισμού - Το Conversations API διατηρεί το ιστορικό στον διακομιστή: δεν χρειάζεται επαναποστολή σε κάθε γύρο
- Μπορείτε να αλλάξετε το επίπεδο σε κάθε γύρο με το
conversations.append - Ένας πράκτορας μπορεί να συνδυάσει ενσωματωμένα εργαλεία και συλλογισμό, με κόστος τη σωρευτική χρήση