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

Δημιουργία Προσαρμοσμένου Πράκτορα σε TOML

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

Μάθημα αναθεωρημένο στις 2 Νοεμβρίου 2026. Τα προηγούμενα παραδείγματα χρησιμοποιούσαν κλειδιά που δεν υπάρχουν στα αρχεία πρακτόρων (model, system_prompt, auto_approve) και ανύπαρκτα εργαλεία (list_dir, edit_file). Τα κλειδιά και τα ονόματα των εργαλείων ευθυγραμμίζονται πλέον με την επίσημη αναφορά και τον πηγαίο κώδικα του Vibe. Πηγές: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).

Πέρα από τους Ενσωματωμένους Πράκτορες

Οι ενσωματωμένοι πράκτορες καλύπτουν τυπικούς ρόλους, αλλά τα έργα σας έχουν μοναδικές ανάγκες: μια ομάδα πληρωμών απαιτεί διαφορετικές δικλείδες ασφαλείας από μια ομάδα τεκμηρίωσης. Το Vibe σάς επιτρέπει να δημιουργείτε προσαρμοσμένους πράκτορες τοποθετώντας ένα αρχείο .toml στο ~/.vibe/agents/ (επίπεδο χρήστη) ή στο ./.vibe/agents/ (επίπεδο έργου, φορτώνεται μόνο αν ο φάκελος είναι αξιόπιστος). Η συμπεριφορά που ορίζεται σε ένα αρχείο είναι αναγνώσιμη, διαχειρίσιμη μέσω εκδόσεων και κοινόχρηστη, σε αντίθεση με οδηγίες που επαναλαμβάνονται σε κάθε συνεδρία.

Το όνομα του πράκτορα ταιριάζει με το όνομα του αρχείου: το redteam.toml εκκινείται με vibe --agent redteam. Το όνομα main είναι δεσμευμένο.

Κλειδιά Αρχείου Πράκτορα

ΚλειδίΡόλος
agent_type"agent" (προεπιλογή, επιλέξιμο από τον χρήστη) ή "subagent" (εκκινείται μόνο μέσω ανάθεσης)
display_name, descriptionΕμφανιζόμενο όνομα και περιγραφή· η περιγραφή είναι υποχρεωτική για υποπράκτορα
instructionsΕνσωματωμένες οδηγίες που προστίθενται μετά το prompt συστήματος (για υποπράκτορα, το αντικαθιστούν)
system_prompt_idΌνομα αρχείου Markdown στο ~/.vibe/prompts/ ή ./.vibe/prompts/, χωρίς την επέκταση
active_modelΨευδώνυμο (alias) του μοντέλου που θα χρησιμοποιηθεί για αυτόν τον πράκτορα
enabled_tools, disabled_toolsΛίστα επιτρεπόμενων και αποκλεισμένων εργαλείων (ακριβή ονόματα, μοτίβα glob ή εκφράσεις re:)
[tools.<tool>]Δικαιώματα ανά εργαλείο: permission = "always", "ask" ή "never", καθώς και για το bash, λίστες allowlist και denylist προθεμάτων εντολών
safetyΟπτικός δείκτης μόνο (χρώμα περιγράμματος εισαγωγής): safe, neutral, destructive, smart ή yolo· δεν επιβάλλει δικαιώματα (Μάθημα 3)

Εργαλεία που Μπορείτε να Ονομάσετε

Τα ενσωματωμένα εργαλεία του Vibe χρησιμοποιούν τα εξής ονόματα: read_file, write_file, edit (πρώην search_replace), bash, grep, todo, task (ανάθεση σε υποπράκτορα), skill, ask_user_question, web_fetch και web_search. Τα εργαλεία από έναν διακομιστή MCP ονομάζονται {server}_{tool} και τα εργαλεία συνδετήρων είναι connector_{connector}_{tool}. Ένα λανθασμένο όνομα εργαλείου στο enabled_tools δεν ταιριάζει με τίποτα: ελέγξτε την ορθογραφία πριν καταλήξετε ότι ένας πράκτορας «αρνείται» να γράψει ένα αρχείο.

Πρώτος Πράκτορας: Ο Σχεδιαστής

Το Vibe δεν διαθέτει ενσωματωμένο πράκτορα plan· η τεκμηρίωση παρέχει αυτό το παράδειγμα μόνο για ανάγνωση, ώστε να εξερευνήσετε ένα αποθετήριο και να προτείνετε ένα σχέδιο πριν από οποιαδήποτε τροποποίηση:

# ~/.vibe/agents/plan.toml
display_name = "Plan"
description = "Explores the repository and proposes a plan before any modification."
safety = "safe"
disabled_tools = ["edit", "write_file"]
instructions = """
Explore the repository and propose a step-by-step implementation plan.
Do not modify any files until the user approves the plan.
"""

[tools.bash]
permission = "ask"

Εκκινήστε τον με vibe --agent plan. Μόλις εγκριθεί το σχέδιο, πατήστε Shift+Tab για να μεταβείτε στο accept-edits για εκτέλεση. Σημειώστε τη σειρά του αρχείου: στο TOML, κάθε κλειδί που γράφεται μετά από μια επικεφαλίδα πίνακα όπως το [tools.bash] ανήκει σε αυτόν τον πίνακα. Τοποθετήστε πρώτα τα κλειδιά ανώτατου επιπέδου και τα μπλοκ [tools.*] στο τέλος.

Ένας Πράκτορας Τεκμηρίωσης

# ~/.vibe/agents/doc-writer.toml
display_name = "Technical Writer"
description = "Writes technical documentation based on source code."
safety = "neutral"
enabled_tools = ["read_file", "grep", "write_file", "edit", "ask_user_question"]
instructions = """
Based on the source code:
1. Write a docstring for every public function.
2. Maintain a structured README with examples.
3. Document required environment variables.
Style: professional, concise, supported by code examples.
"""

[tools.write_file]
permission = "ask"

Μπορεί να διαβάσει, να αναζητήσει και να γράψει, αλλά δεν μπορεί να εκτελέσει εντολές: το bash δεν βρίσκεται στη λίστα του. Κάθε δημιουργία αρχείου απαιτεί την έγκρισή σας. Δοκιμάστε το σε μια μικρή ενότητα πριν το εφαρμόσετε σε ολόκληρο το αποθετήριο.

Επιλογή Μοντέλου Πράκτορα

Το active_model αναμένει το ψευδώνυμο ενός διαμορφωμένου μοντέλου. Το Vibe διαθέτει ένα ενσωματωμένο μοντέλο, το Mistral Medium 3.5, με ψευδώνυμο mistral-medium-3.5. Για άλλο μοντέλο, δηλώστε πρώτα μια προεπιλογή στο config.toml και στη συνέχεια αναφερθείτε στο ψευδώνυμό του:

# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# στο αρχείο του πράκτορα
active_model = "codestral"

Χωρίς το active_model, ο πράκτορας χρησιμοποιεί το μοντέλο της συνεδρίας.

Συγγραφή Οδηγιών

Υπάρχουν δύο διαδρομές. Το instructions περιέχει ενσωματωμένο κείμενο που προστίθεται μετά το prompt συστήματος του Vibe: αυτή είναι η απλούστερη προσέγγιση. Το system_prompt_id δείχνει σε ένα αρχείο Markdown στον φάκελο prompts/, χρήσιμο για μεγάλα prompts που ελέγχονται σε αναθεωρήσεις κώδικα. Μια λεπτομέρεια συμπεριφοράς έχει σημασία: το prompt ενός προσαρμοσμένου πράκτορα εφαρμόζεται μόνο αν τον επιλέξετε πριν από το πρώτο σας μήνυμα (μέσω --agent ή Shift+Tab). Αν αλλάξετε πράκτορες κατά τη διάρκεια μιας συνεδρίας, τα εργαλεία, τα δικαιώματα και το μοντέλο του εφαρμόζονται αμέσως, αλλά το prompt του τίθεται σε ισχύ μόνο μετά το /clear.

Βέλτιστες Πρακτικές

Ελάχιστο προνόμιο πρώτα: δώστε σε έναν πράκτορα μόνο τα εργαλεία που χρειάζεται. Ένας πράκτορας ανάλυσης δεν χρειάζεται το write_file· ένας συγγραφέας δεν χρειάζεται το bash. Η αφαίρεση κάθε εργαλείου καθιστά αδύνατη μια ολόκληρη κατηγορία σφαλμάτων.

Ένας πράκτορας ανά ευθύνη στη συνέχεια: ένα αρχείο «για όλα» παράγει μετριόκριτες απαντήσεις παντού. Τρία στοχευμένα αρχεία είναι καλύτερα από ένα γενικό.

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

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

  • Ένας προσαρμοσμένος πράκτορας είναι ένα αρχείο .toml στο ~/.vibe/agents/ ή ./.vibe/agents/· το όνομά του ταιριάζει με το όνομα του αρχείου
  • Χρήσιμα κλειδιά: display_name, description, instructions ή system_prompt_id, active_model, enabled_tools, disabled_tools, [tools.<tool>]
  • Ονόματα εργαλείων: read_file, write_file, edit, bash, grep, todo, task, skill, ask_user_question, web_fetch, web_search
  • Το active_model αναμένει ένα ψευδώνυμο προεπιλογής μοντέλου (ή το mistral-medium-3.5, ενσωματωμένο)
  • Τοποθετήστε τα μπλοκ [tools.*] στο τέλος του αρχείου