Προγραμματισμός με Πράκτορες και Κλήση Εργαλείων
Σε αυτήν τη σελίδα
Το μάθημα ενημερώθηκε στις 2 Νοεμβρίου 2026. Τα αρχικά παραδείγματα χρησιμοποιούσαν το Devstral, το οποίο αφαιρέθηκε από το API στις 31 Ιουλίου 2026. Τώρα χρησιμοποιούν το Mistral Small 4 (
mistral-small-2603) και ο βρόχος πρακτόρων ακολουθεί το μοντέλο της τεκμηρίωσης της Mistral (όλες οι κλήσεις εργαλείων σε μια απάντηση επεξεργάζονται έως την τελική απάντηση). Πηγή: Function calling.
Τι είναι ο προγραμματισμός με πράκτορες;
Ο προγραμματισμός με πράκτορες αλλάζει τη φύση του αιτήματος που απευθύνετε στο μοντέλο. Αντί να ζητάτε ένα απόσπασμα κώδικα, μετά ένα δεύτερο, μετά ένα τρίτο και να τα συνθέτετε εσείς οι ίδιοι, αναθέτετε μια πλήρη εργασία. Το μοντέλο την επιλύει αλυσιδωτά, εκτελώντας μόνο του τα βήματα: εξερεύνηση, σχεδιασμός, υλοποίηση και επαλήθευση. Εσείς παραμένετε ο λήπτης των αποφάσεων για το τι πρέπει να γίνει, αλλά σταματάτε τη μικροδιαχείριση κάθε κίνησης.
Τα μοντέλα Devstral είχαν σχεδιαστεί για αυτή τη ροή εργασίας· τα τρέχοντα μοντέλα γενικής χρήσης, με επικεφαλής το Mistral Small 4, τη διαχειρίζονται μέσω κλήσης εργαλείων (tool calling). Ένας πράκτορας δεν απαντά απλώς σε μια ερώτηση· δρα πάνω στο αποθετήριο.
Ο κύκλος του πράκτορα
Φάση 1 — Κατανόηση
Ο πράκτορας ξεκινά πάντα προσανατολιζόμενος. Διαβάζει τη δομή των φακέλων και των αρχείων, εντοπίζει τα αρχεία που σχετίζονται με την αιτούμενη εργασία, ιχνηλατεί τις εξαρτήσεις μεταξύ των ενοτήτων για να δει τι μπορεί να επηρεάσει μια αλλαγή και σημειώνει τις υπάρχουσες συμβάσεις—ονοματοδοσία, οργάνωση tests και επαναλαμβανόμενα πρότυπα. Αυτή η φάση φαίνεται αντιπαραγωγική επειδή δεν γράφει κώδικα, ωστόσο καθορίζει αν ο τελικός κώδικας θα μοιάζει με δικό σας ή με ξένο.
Φάση 2 — Σχεδιασμός
Πριν γράψει μια μοναδική γραμμή, ο πράκτορας διατυπώνει ένα σχέδιο. Αναλύει την εργασία σε διατεταγμένες υπο-εργασίες, διακρίνει τα αρχεία προς τροποποίηση από εκείνα που πρέπει να δημιουργηθούν, προβλέπει παρενέργειες και κινδύνους παλινδρόμησης (regression) και καταλήγει σε μια τεχνική προσέγγιση. Αυτή είναι η στιγμή που η παρέμβασή σας κοστίζει λιγότερο: η διόρθωση ενός σχεδίου παίρνει τριάντα δευτερόλεπτα· η διόρθωση δέκα αρχείων που έχετε ήδη γράψει παίρνει πολύ περισσότερο χρόνο.
Φάση 3 — Εκτέλεση
Η υλοποίηση ξετυλίγει το σχέδιο βήμα προς βήμα. Ο πράκτορας επεξεργάζεται υπάρχοντα αρχεία, δημιουργεί νέα όταν η δομή το απαιτεί, ενημερώνει τις εισαγωγές (imports) και τις εξαρτήσεις που μετατοπίστηκαν από τις αλλαγές του και προσαρμόζει τα αρχεία διαμόρφωσης στη διαδικασία. Η συνοχή σε αυτές τις αλλαγές είναι ακριβώς αυτό που ένα μοντέλο συμπλήρωσης δεν μπορεί να εγγυηθεί.
Φάση 4 — Επαλήθευση
Τέλος, έρχεται η απόδειξη ότι το έργο αντέχει. Ο πράκτορας εκτελεί την υπάρχουσα σουίτα tests, γράφει νέα tests για τον κώδικα που μόλις πρόσθεσε, διασφαλίζει ότι η δημιουργία (build) περνάει και ελέγχει τη δική του διαφορά (diff) για σφάλματα ή τυχαίες τροποποιήσεις. Ένας πράκτορας που παραλείπει αυτή τη φάση παράγει κώδικα που φαίνεται λογικός, όχι σωστό κώδικα.
Παράδειγμα εφαρμογής: διόρθωση ενός σφάλματος
Υποθέστε ότι λέτε στον πράκτορα: «Οι χρήστες λαμβάνουν σφάλμα 500 όταν υποβάλλουν μια φόρμα με email που περιέχει ’+’». Ο κύκλος τότε λαμβάνει την εξής μορφή:
1. ΚΑΤΑΝΟΗΣΗ
-> Αναζήτηση αρχείων που σχετίζονται με τη φόρμα (αναζήτηση "email" στον κώδικα)
-> Ανάγνωση του controller που διαχειρίζεται την υποβολή
-> Ανάγνωση της συνάρτησης επικύρωσης email
-> Εντοπισμός της regex που απορρίπτει το '+'
2. ΣΧΕΔΙΑΣΜΟΣ
-> Τροποποίηση της regex επικύρωσης για αποδοχή του '+'
-> Προσθήκη unit test για emails με '+'
-> Επαλήθευση ότι κανένα άλλο μέρος του κώδικα δεν φιλτράρει το '+'
3. ΕΚΤΕΛΕΣΗ
-> Τροποποίηση src/validators/email.py: διόρθωση του μοτίβου regex
-> Δημιουργία tests/test_email_validation.py: προσθήκη περιπτώσεων με '+'
-> Τροποποίηση src/controllers/form.py: προσθήκη καταγραφής (log) για αποσφαλμάτωση
4. ΕΠΑΛΗΘΕΥΣΗ
-> Εκτέλεση pytest -> όλα τα tests περνούν
-> Έλεγχος diff -> οι αλλαγές είναι συνεπείς και ελάχιστες
Παρατηρήστε την τρίτη γραμμή του σχεδίου: ο πράκτορας δεν διορθώνει απλώς το σημείο όπου εκδηλώνεται το σφάλμα· ελέγχει ότι κανένα άλλο φίλτρο δεν απορρίπτει τον χαρακτήρα αλλού. Αυτή η αναζήτηση της ρίζας του προβλήματος, και όχι απλώς του συμπτώματος, είναι αυτό που διακρίνει μια διόρθωση από πράκτορα από μια επιφανειακή επιδιόρθωση.
Χρήση εργαλείων στην πράξη
Ο πράκτορας δρα στο περιβάλλον του μέσω κλήσεων συναρτήσεων. Δηλώνετε τα διαθέσιμα εργαλεία στο αίτημα, συμπεριλαμβανομένου του ονόματος, της περιγραφής και του σχήματος παραμέτρων τους· το μοντέλο επιλέγει ποια θα καλέσει και με ποια ορίσματα.
# Παράδειγμα συνομιλίας με πράκτορα
messages = [
{
"role": "user",
"content": "Προσθήκη ισχυρής επικύρωσης κωδικού πρόσβασης στην ενότητα auth."
}
]
tools = [
{
"type": "function",
"function": {
"name": "read_file",
"description": "Ανάγνωση του περιεχομένου ενός αρχείου έργου",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string", "description": "Διαδρομή αρχείου"}
},
"required": ["path"]
}
}
},
{
"type": "function",
"function": {
"name": "write_file",
"description": "Εγγραφή ή τροποποίηση ενός αρχείου έργου",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string"},
"content": {"type": "string"}
},
"required": ["path", "content"]
}
}
},
{
"type": "function",
"function": {
"name": "run_command",
"description": "Εκτέλεση εντολής κελύφους",
"parameters": {
"type": "object",
"properties": {
"command": {"type": "string"}
},
"required": ["command"]
}
}
}
]
response = client.chat.complete(
model="mistral-small-2603",
messages=messages,
tools=tools,
tool_choice="auto", # προεπιλεγμένη τιμή: το μοντέλο αποφασίζει αν θα καλέσει εργαλείο
)
Για αυτό το αίτημα, η τυπική ακολουθία ξεκινά με read_file("src/auth/validators.py") για να κατανοήσει τον υπάρχοντα κώδικα, συνεχίζει με read_file("tests/test_auth.py") για να δει τη μορφή των τρεχόντων tests, και μετά προχωρά στην εγγραφή: write_file("src/auth/validators.py", ...) με τον προστιθέμενο κανόνα επικύρωσης, write_file("tests/test_auth.py", ...) με τις νέες περιπτώσεις, και τελικά run_command("pytest tests/test_auth.py") για επαλήθευση. Η σειρά έχει σημασία: ανοίγοντας και τα δύο αρχεία πριν αγγίξει έναν μοναδικό χαρακτήρα, ο πράκτορας υιοθετεί τις συμβάσεις σας και τις αναπαράγει, αντί να εισάγει άλλες που έχει δει αλλού.
Βρόχος πρακτόρων πολλαπλών γύρων
Τίποτα από αυτά δεν συμβαίνει σε μια μοναδική κλήση. Η καρδιά του προγραμματισμού με πράκτορες είναι ο βρόχος πολλαπλών γύρων: το μοντέλο προτείνει μια ενέργεια, ο κώδικάς σας την εκτελεί και εσείς στέλνετε το αποτέλεσμα πίσω ώστε να αποφασίσει το επόμενο βήμα. Διατηρείτε τον έλεγχο της πραγματικής εκτέλεσης, κάτι που λειτουργεί επίσης ως δικλείδα ασφαλείας.
import json
TOOLS = {"read_file": read_file, "write_file": write_file, "run_command": run_command}
response = client.chat.complete(model="mistral-small-2603", messages=messages, tools=tools)
messages.append(response.choices[0].message)
for _ in range(30): # δικλείδα ασφαλείας: ένας πράκτορας δεν πρέπει ποτέ να κάνει άπειρο βρόχο
tool_calls = response.choices[0].message.tool_calls
if not tool_calls:
break # δεν υπάρχουν άλλες κλήσεις εργαλείων: η τελική απάντηση έχει φτάσει
for tool_call in tool_calls: # μια απάντηση μπορεί να περιέχει πολλαπλές κλήσεις
name = tool_call.function.name
arguments = json.loads(tool_call.function.arguments)
result = TOOLS[name](**arguments)
messages.append({
"role": "tool",
"name": name,
"content": str(result),
"tool_call_id": tool_call.id,
})
response = client.chat.complete(model="mistral-small-2603", messages=messages, tools=tools)
messages.append(response.choices[0].message)
print(response.choices[0].message.content)
Τρεις λεπτομέρειες έχουν σημασία. Το μήνυμα του πράκτορα και κάθε αποτέλεσμα εργαλείου επανεισάγονται στο ιστορικό, συζευγμένα μέσω του tool_call_id: αν παραλείψετε οποιοδήποτε από τα δύο, ο πράκτορας χάνει το νήμα, επαναλαμβάνοντας τις ίδιες κλήσεις εργαλείων σε βρόχο. Μια μοναδική απάντηση μπορεί να περιέχει πολλαπλές κλήσεις εργαλείων, καθώς οι παράλληλες κλήσεις επιτρέπονται από προεπιλογή (parallel_tool_calls=False τις απαγορεύει): επεξεργαστείτε τις όλες. Τέλος, θέστε ένα όριο στον αριθμό των γύρων και ζητήστε από έναν άνθρωπο να επικυρώσει τις εντολές κελύφους και τις εγγραφές αρχείων: ένας πράκτορας που εκτελεί ό,τι προτείνει αποτελεί κίνδυνο, όχι εξοικονόμηση χρόνου.
Βασικά σημεία
- Ο προγραμματισμός με πράκτορες ακολουθεί έναν κύκλο: κατανόηση, σχεδιασμός, εκτέλεση, επαλήθευση
- Ο πράκτορας δρα στο αποθετήριο μέσω κλήσης εργαλείων (
tools,tool_choice) - Ο βρόχος πολλαπλών γύρων επιτρέπει στον πράκτορα να επαναλαμβάνει έως την πλήρη επίλυση
- Ο πράκτορας τροποποιεί πολλαπλά αρχεία με συνοχή σε μια μοναδική εργασία
- Η φάση επαλήθευσης (tests, build) είναι απαραίτητη για την αξιοπιστία