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

Πράκτορες Κώδικα στην Πράξη: API, Vibe Code CLI και Vibe Code Web

Μάθημα 8 / 14 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Τρεις τρόποι για να θέσετε έναν πράκτορα σε λειτουργία
  2. Μέσω του Mistral API
  3. Μέσω του Vibe Code τοπικά: το CLI και η επέκταση VS Code
  4. Μέσω του Vibe Code Web
  5. Σύγκριση των τριών διαδρομών
  6. Τι κάνει τη διαφορά στην πράξη
  7. Βασικά σημεία

Μάθημα αναθεωρημένο στις 2 Νοεμβρίου 2026. Δεδομένου ότι το Devstral αφαιρέθηκε από το API στις 31 Ιουλίου 2026, τα παραδείγματα API εδώ χρησιμοποιούν το Mistral Small 4. Η ενότητα Vibe αντικατοπτρίζει την τρέχουσα τεκμηρίωση του Vibe Code: εγκατάσταση, το ενσωματωμένο μοντέλο (Mistral Medium 3.5) και τις τρεις επιφάνειες—CLI, επέκταση VS Code και Vibe Code Web. Πηγές: Εγκατάσταση και ρύθμιση · Επιλογή συνεδριών CLI, VS Code ή web · Ρύθμιση παραμέτρων.

Τρεις τρόποι για να θέσετε έναν πράκτορα σε λειτουργία

Ένα μοντέλο πρακτόρων είναι τόσο καλό όσο ο τρόπος με τον οποίο το συνδέετε με την πραγματική εργασία. Η Mistral προσφέρει τρεις διαδρομές: το API, όπου χτίζετε τον δικό σας πράκτορα· το Vibe Code τοπικά, στο τερματικό ή στο VS Code σας· και το Vibe Code Web, το οποίο εκτελεί τον πράκτορα σε ένα απομακρυσμένο sandbox απέναντι σε ένα αποθετήριο GitHub. Το καθένα εξυπηρετεί ένα διαφορετικό μέρος της ημέρας ενός προγραμματιστή.

Μέσω του Mistral API

Το API είναι η πιο ευέλικτη διεπαφή: σας επιτρέπει να δημιουργήσετε τις δικές σας ροές εργασίας πρακτόρων με τα δικά σας εργαλεία και τη λογική ελέγχου σας. Ξεκινήστε με την απλούστερη περίπτωση, μια κλήση chat χωρίς εργαλεία. Εδώ υποβάλλουμε μια ευάλωτη συνάρτηση αυθεντικοποίησης στο Mistral Small 4 και ζητάμε διάγνωση. Η ρύθμιση temperature=0 δεν είναι διακοσμητική: για την ανάλυση ασφαλείας, θέλετε αναπαράγωγα αποτελέσματα, όχι παραλλαγές από τη μία εκτέλεση στην άλλη.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.chat.complete(
    model="mistral-small-2603",
    messages=[
        {
            "role": "system",
            "content": "You are an expert development agent. Analyze the provided code and propose improvements."
        },
        {
            "role": "user",
            "content": """Here is a Python file that handles authentication.
Identify security issues and propose fixes:

def login(username, password):
    query = f"SELECT * FROM users WHERE username='{username}' AND password='{password}'"
    user = db.execute(query).fetchone()
    if user:
        session['user_id'] = user['id']
        return True
    return False
"""
        }
    ],
    temperature=0,
    max_tokens=2000,
)

print(response.choices[0].message.content)

Η λειτουργία πρακτόρων αλλάζει τη φύση της ανταλλαγής. Αντί να λαμβάνετε κείμενο, δηλώνετε εργαλεία που το μοντέλο μπορεί να ζητήσει να καλέσει, και το μοντέλο επιστρέφει tool_calls—ένα όνομα εργαλείου και τα ορίσματά του. Τα τρία εργαλεία παρακάτω αποτελούν τη θεμελιώδη βάση για έναν πράκτορα κώδικα: ανάγνωση αρχείου, εγγραφή αρχείου, εκτέλεση εντολής. Με αυτά, η οδηγία «προσθήκη υποδείξεων τύπου σε όλα τα αρχεία στο src/utils/» γίνεται εκτελέσιμη, whereas στη λειτουργία chat θα παρέμενε απλώς μια πρόταση.

tools = [
    {
        "type": "function",
        "function": {
            "name": "read_file",
            "description": "Read the contents of a source file",
            "parameters": {
                "type": "object",
                "properties": {
                    "path": {
                        "type": "string",
                        "description": "Relative path to the file"
                    }
                },
                "required": ["path"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "write_file",
            "description": "Write content to a file",
            "parameters": {
                "type": "object",
                "properties": {
                    "path": {"type": "string"},
                    "content": {"type": "string"}
                },
                "required": ["path", "content"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "run_command",
            "description": "Execute a shell command",
            "parameters": {
                "type": "object",
                "properties": {
                    "command": {"type": "string"}
                },
                "required": ["command"]
            }
        }
    }
]

response = client.chat.complete(
    model="mistral-small-2603",
    messages=[
        {
            "role": "user",
            "content": "Explore the project and add Python type hints to all files in the src/utils/ directory"
        }
    ],
    tools=tools,
    tool_choice="auto",
)

# Process the tool calls returned by the model
for tool_call in response.choices[0].message.tool_calls:
    print(f"Tool: {tool_call.function.name}")
    print(f"Arguments: {tool_call.function.arguments}")

Σημειώστε ότι τίποτα δεν εκτελείται μόνο του: ο βρόχος—κλήση του εργαλείου, επιστροφή της εξόδου στο μοντέλο, αίτημα για το επόμενο βήμα—παραμένει εξ ολοκλήρου δική σας ευθύνη. Αυτή είναι η τιμή της ευελιξίας, και είναι ακριβώς αυτό που το Vibe CLI διαχειρίζεται για εσάς.

Μέσω του Vibe Code τοπικά: το CLI και η επέκταση VS Code

Το Vibe Code είναι η λειτουργία «code» του Vibe, του πράκτορα της Mistral. Τοπικά, διατίθεται σε δύο μορφές που μοιράζονται την ίδια μηχανή, ρύθμιση και ιστορικό συνεδριών: το CLI, στο τερματικό σας, και η επέκταση VS Code, η οποία προσθέτει πλαίσιο επεξεργαστή (ενεργό αρχείο, επιλογή, διαφορές). Η εγκατάσταση του CLI απαιτεί μία γραμμή σε macOS και Linux:

# Official installer (installs uv if needed, then the mistral-vibe package)
curl -LsSf https://mistral.ai/vibe/install.sh | bash

# Or manual installation
uv tool install mistral-vibe

Στη συνέχεια, μεταβείτε στο έργο σας και εκτελέστε το vibe. Κατά την πρώτη εκκίνηση, ένας οδηγός σας ζητά να συνδεθείτε με τον λογαριασμό Mistral (το Vibe Code περιλαμβάνεται στα πακέτα, με όρια χρήσης ανάλογα με το πακέτο) ή να εισαγάγετε ένα κλειδί API. Στη συνέχεια, μιλάτε στον πράκτορα όπως σε έναν συνάδελφο με τα χέρια στο πληκτρολόγιο:

Explain this project's architecture.
Add an API route /health that returns the server status, along with its test.
Run the test suite and fix what fails.

Το Vibe παρέχει τα ίδια τα εργαλεία (ανάγνωση/εγγραφή αρχείου, εντολές κελύφους) και τον βρόχο πρακτόρων που έπρεπε να γράψετε χειροκίνητα με το API. Διατίθεται με ένα ενσωματωμένο μοντέλο, το Mistral Medium 3.5, και η εντολή /model σας επιτρέπει να επιλέξετε ένα άλλο από τα διαμορφωμένα (Small 4, Codestral, ένα τοπικό μοντέλο…). Οι αλλαγές και οι εντολές περνούν από ένα σύστημα έγκρισης που διαμορφώνετε ανά πράκτορα: ελέγξτέ το πριν του εμπιστευτείτε ένα σημαντικό αποθετήριο. Για αυτοματοποίηση, το vibe --prompt εκτελεί μια μη διαδραστική εκτέλεση, χρήσιμη στη συνεχή ενσωμάτωση.

Μέσω του Vibe Code Web

Το Vibe Code Web είναι η τρίτη επιφάνεια: ένα πιλοτήριο για απομακρυσμένους πράκτορες. Δημιουργείτε ένα έργο από ένα ή περισσότερα αποθετήρια GitHub υπό τον ίδιο ιδιοκτήτη, ξεκινάτε μια συνεδρία με μια ακριβή οδηγία και ο πράκτορας εργάζεται σε ένα sandbox διαχειριζόμενο από το cloud: κάνει clone, σχεδιάζει, τροποποιεί, εκτελεί εντολές και δοκιμές, και στη συνέχεια προετοιμάζει έναν κλάδο ή ένα pull request για να το ελέγξετε στο GitHub. Δεν απαιτείται τοπικό αντίγραφο και ο υπολογιστής σας μπορεί να παραμείνει κλειστός ενώ ο πράκτορας εργάζεται. Από το CLI, η εντολή /teleport μεταφέρει μια ενεργή συνεδρία στο web.

Επιλέξτε το CLI ή την επέκταση όταν η εργασία εξαρτάται από αρχεία, υπηρεσίες ή μυστικά που υπάρχουν μόνο στον υπολογιστή σας.

Σύγκριση των τριών διαδρομών

ΚριτήριοPython APIVibe Code (CLI, VS Code)Vibe Code Web
Βρόχος πρακτόρωνΤον γράφετε εσείςΕνσωματωμένοςΕνσωματωμένος
Πρόσβαση σε αρχείαΜέσω των εργαλείων σαςΤοπικό αντίγραφο εργασίαςΑπομακρυσμένο sandbox, αποθετήριο GitHub
ΜοντέλοΑυτό που καλείτεMedium 3.5 ενσωματωμένο, άλλα προαιρετικάΜηχανή Vibe Code
Μη διαδραστική λειτουργίαΝαιΝαι (vibe --prompt, μόνο CLI)Όχι
Περίπτωση χρήσηςΣωληνώσεις, προσαρμοσμένα προϊόνταΚαθημερινή ανάπτυξηΕργασίες μεγάλης διάρκειας σε απομακρυσμένο αποθετήριο

Διαβάζοντας από δεξιά προς τα αριστερά, αυτός ο πίνακας περιγράφει μια κλίμακα ελέγχου: όσο περισσότερο μετακινείστε προς το API, τόσο περισσότερα αποφασίζετε εσείς, συμπεριλαμβανομένου του τι μπορεί να σπάσει.

Τι κάνει τη διαφορά στην πράξη

Η ποιότητα των αποτελεσμάτων εξαρτάται λιγότερο από το μοντέλο και περισσότερο από το πώς διατυπώνετε το αίτημά σας. Το «Προσθήκη επικύρωσης» αφήνει τον πράκτορα να επινοήσει την τοποθεσία, το στυλ και τους κανόνες· το «Προσθήκη επικύρωσης email στο src/auth/validators.py χρησιμοποιώντας το υπάρχον πρότυπο» του δίνει το αρχείο, τη σύμβαση και τα όρια. Στο ίδιο πνεύμα, αναφέρετε ρητά τα σχετικά αρχεία και τους περιορισμούς του έργου, αντί να ελπίζετε ότι θα τα μαντέψει.

Η επαλήθευση παραμένει αδιαπραγμάτευτη: ένας ικανός πράκτορας μπορεί ακόμα να εισαγάγει μια παλινδρόμηση, ειδικά όταν αγγίζει πολλά αρχεία ταυτόχρονα. Κάντε συνήθεια να ελέγχετε τις διαφορές (diff) πριν τις αποδεχτείτε, ακριβώς όπως θα κάνατε για ένα pull request νέου υπαλλήλου. Και λάβετε υπόψη την τελική ρύθμιση: την επιλογή του σωστού εργαλείου. Χρησιμοποιήστε το Vibe Code τοπικά για καθημερινή ανάπτυξη, το Vibe Code Web για εργασίες μεγάλης διάρκειας σε απομακρυσμένο αποθετήριο και το API για τις δικές σας σωληνώσεις.

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

  • Το API παρέχει πλήρη έλεγχο: εσείς γράφετε τα εργαλεία και τον βρόχο πρακτόρων
  • Το Vibe Code εγκαθίσταται με curl -LsSf https://mistral.ai/vibe/install.sh | bash (ή uv tool install mistral-vibe) και διατίθεται με το Mistral Medium 3.5
  • Το CLI και η επέκταση VS Code μοιράζονται ρυθμίσεις και συνεδρίες· το vibe --prompt προορίζεται για αυτοματοποίηση
  • Το Vibe Code Web εκτελεί τον πράκτορα σε απομακρυσμένο sandbox και παράγει κλάδους και pull requests
  • Οι ακριβείς οδηγίες και η αναθεώρηση των διαφορών παραμένουν απαραίτητες