Loo kohandatud agent TOML-is
Sellel lehel
Õppetund kirjutati ümber 2. novembril 2026. Varasemad näited kasutasid võtmeid, mida agentide failides ei eksisteeri (
model,system_prompt,auto_approve), ja olematuid tööriistu (list_dir,edit_file). Võtmed ja tööriistade nimed on nüüd viidud vastavusse ametliku dokumentatsiooni ja Vibe’i lähtekoodiga. Allikad: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).
Kaugemale sisseehitatud agentidest
Sisseehitatud agendid katavad standardsed isiksused, kuid sinu projektidel on unikaalsed vajadused: maksete meeskond vajab erinevaid kaitsemeetmeid võrreldes dokumentatsiooni meeskonnaga. Vibe võimaldab sul luua kohandatud agente, paigutades .toml faili kausta ~/.vibe/agents/ (kasutajatasand) või ./.vibe/agents/ (projektitasand, laaditakse ainult siis, kui kaust on usaldusväärne). Failis määratletud käitumine on loetav, versioneeritav ja jagatav, erinevalt juhistest, mida kordad igas sessioonis.
Agendi nimi vastab failinimele: redteam.toml käivitub käsuga vibe --agent redteam. Nimi main on reserveeritud.
Agendi faili võtmed
| Võti | Roll |
|---|---|
agent_type | "agent" (vaikimisi, kasutaja valitav) või "subagent" (käivitub ainult delegeerimise teel) |
display_name, description | Kuva nimi ja kirjeldus; alamagendi puhul on kirjeldus kohustuslik |
instructions | Reasisused juhised, mis lisatakse süsteemiviiba järel (alamagendi puhul asendavad need seda) |
system_prompt_id | Markdown-faili nimi kaustas ~/.vibe/prompts/ või ./.vibe/prompts/, ilma laiendita |
active_model | Selle agendi jaoks kasutatava mudeli alias |
enabled_tools, disabled_tools | Tööriistade lubatud nimekiri ja keelunimekiri (täpsed nimed, glob-mustrid või re: avaldised) |
[tools.<tool>] | Tööriistapõhised õigused: permission = "always", "ask" või "never", lisaks bash puhul käskude eesliidete allowlist ja denylist |
safety | Ainult visuaalne indikaator (sisendi äärise värv): safe, neutral, destructive, smart või yolo; see ei jõusta mingeid õigusi (Õppetund 3) |
Tööriistad, mida saad nimetada
Vibe’i sisseehitatud tööriistad kannavad järgmisi nimesid: read_file, write_file, edit (varem search_replace), bash, grep, todo, task (delegeerimine alamagendile), skill, ask_user_question, web_fetch ja web_search. MCP serveri tööriistad on nimega {server}_{tool} ja connector-tööriistad on connector_{connector}_{tool}. Valesti kirjutatud tööriista nimi võtmes enabled_tools ei sobi millegagi: kontrolli õigekirja enne järelduse tegemist, et agent „keeldub“ faili kirjutamast.
Esimene agent: Planeerija
Vibe’il pole sisseehitatud plan agenti; dokumentatsioon pakub seda kirjutuskaitstud näidet hoidla uurimiseks ja plaani väljatöötamiseks enne muudatuste tegemist:
# ~/.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"
Käivita see käsuga vibe --agent plan. Kui plaan on heaks kiidetud, vajuta Shift+Tab, et lülituda täitmiseks režiimi accept-edits. Pane tähele faili järjestust: TOML-is kuulub iga võti, mis on kirjutatud pärast tabeli päist nagu [tools.bash], sellele tabelile. Paiguta ülemise taseme võtmed esimesena ja [tools.*] plokid faili lõppu.
Dokumentatsiooni agent
# ~/.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"
See saab lugeda, otsida ja kirjutada, kuid ei saa käskude käivitada: bash pole selle nimekirjas. Iga faili loomine nõuab sinu kinnitust. Proovi seda väikese mooduli peal, enne kui rakendad seda tervele hoidlale.
Agendi mudeli valimine
active_model eeldab konfigureeritud mudeli aliast. Vibe’iga kaasneb sisseehitatud mudel Mistral Medium 3.5, aliasega mistral-medium-3.5. Teise mudeli jaoks deklareeri kõigepealt eelseadistus failis config.toml ja viita seejärel selle aliasele:
# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# agendi failis
active_model = "codestral"
Ilma active_model-ita kasutab agent sessiooni mudelit.
Juhiste kirjutamine
On kaks teed. instructions sisaldab reasisest teksti, mis lisatakse Vibe’i süsteemiviiba järel: see on lihtsaim lähenemine. system_prompt_id viitab Markdown-failile kaustas prompts/, mis on kasulik pikkade viipade jaoks, mida vaadatakse läbi koodiülevaatustel. Üks käitumuslik detail on oluline: kohandatud agendi viip kehtib ainult siis, kui valid selle enne oma esimest sõnumit (kasutades --agent või Shift+Tab). Kui lülitud agente sessiooni keskel, rakenduvad selle tööriistad, õigused ja mudel kohe, kuid selle viip jõustub alles pärast /clear.
Parimad tavad
Vähimaid õigusi esmalt: anna agendile ainult need tööriistad, mida ta vajab. Analüüsiagent ei vaja write_file; kirjutaja ei vaja bash. Iga tööriista eemaldamine muudab terve veakategooria võimatuks.
Üks agent ühe vastutusala kohta järgmisena: üldine fail toodab kõikjal keskpäraseid vastuseid. Kolm sihipärast faili on paremad kui üks üldine.
Täpsed juhised lõpuks: määratlege täpne roll, projekti konventsioonid, oodatav väljundvorming ja vead, mida vältida. Kui agent pettumust valmistab, on see peaaegu alati tingitud sellest, et üks neist neljast punktist puudub.
Peamised punktid
- Kohandatud agent on
.tomlfail kaustas~/.vibe/agents/või./.vibe/agents/; selle nimi vastab failinimele - Kasulikud võtmed:
display_name,description,instructionsvõisystem_prompt_id,active_model,enabled_tools,disabled_tools,[tools.<tool>] - Tööriistade nimed:
read_file,write_file,edit,bash,grep,todo,task,skill,ask_user_question,web_fetch,web_search active_modeleeldab mudeli eelseadistuse aliast (või sisseehitatudmistral-medium-3.5)- Paiguta
[tools.*]plokid faili lõppu