Sukurkite tinkintą agentą TOML formatu
Šiame puslapyje
Pamoka perrašyta 2026 m. lapkričio 2 d. Ankstesniuose pavyzdžiuose naudoti raktai, kurių nėra agentų failuose (
model,system_prompt,auto_approve), ir neegzistuojantys įrankiai (list_dir,edit_file). Dabar raktai ir įrankių pavadinimai atitinka oficialią dokumentaciją bei Vibe šaltinio kodą. Šaltiniai: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).
Anapus integruotų agentų
Integruoti agentai apima standartines vaidmenų kategorijas, tačiau tavo projektai turi unikalių poreikių: mokėjimų komandai reikia kitokių apsaugos priemonių nei dokumentacijos komandai. Vibe leidžia kurti tinkintus agentus, patalpinant .toml failą aplanke ~/.vibe/agents/ (naudotojo lygmeniu) arba ./.vibe/agents/ (projekto lygmeniu, įkeliamas tik jei aplankas patikimas). Faile apibrėžta elgsena yra skaitoma, versijuojama ir lengvai dalinama, skirtingai nei instrukcijos, kartojamos kiekvienos sesijos metu.
agento pavadinimas sutampa su failo pavadinimu: redteam.toml paleidžiamas komanda vibe --agent redteam. Pavadinimas main yra rezervuotas.
Agento failo raktai
| Raktas | Vaidmuo |
|---|---|
agent_type | "agent" (numatytasis, pasirenkamas naudotojo) arba "subagent" (paleidžiamas tik deleguojant) |
display_name, description | Rodomas pavadinimas ir aprašymas; subagentui aprašymas yra privalomas |
instructions | Įterptos instrukcijos, pridėtos po sistemos prompt’u (subagentui jos jį pakeičia) |
system_prompt_id | Markdown failo, esančio aplanke ~/.vibe/prompts/ arba ./.vibe/prompts/, pavadinimas be plėtinio |
active_model | Modelio, kurį naudos šis agentas, aliasas |
enabled_tools, disabled_tools | Leidžiamų ir blokuojamų įrankių sąrašai (tikslūs pavadinimai, glob šablonai arba re: išraiškos) |
[tools.<tool>] | Įrankio leidimai kiekvienam įrankiui atskirai: permission = "always", "ask" arba "never"; bash atveju taip pat galima nustatyti komandų priešdėlių allowlist ir denylist |
safety | Tik vizualus indikatorius (įvesties rėmelio spalva): safe, neutral, destructive, smart arba yolo; jis neprivalo jokių leidimų (3 pamoka) |
Įrankiai, kuriuos gali nurodyti
Integruoti Vibe įrankiai naudoja šiuos pavadinimus: read_file, write_file, edit (anksčiau search_replace), bash, grep, todo, task (delegavimas subagentui), skill, ask_user_question, web_fetch ir web_search. Įrankiai iš MCP serverio vadinami {server}_{tool}, o jungties (connector) įrankiai – connector_{connector}_{tool}. Neteisingai parašytas įrankio pavadinimas enabled_tools sąraše nieko neatitiks: prieš darant išvadą, kad agentas „atsisako“ rašyti failą, patikrink rašybą.
Pirmasis agentas: Planuotojas
Vibe neturi integruoto plan agento; dokumentacijoje pateikiamas tik skaitymui skirtas pavyzdys, skirtas saugyklai išnagrinėti ir planui pasiūlyti prieš atliekant bet kokius pakeitimus:
# ~/.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"
Paleisk jį komanda vibe --agent plan. Kai planas bus patvirtintas, paspausk Shift+Tab, kad perjungtum į accept-edits vykdymui. Atkreipk dėmesį į failo eiliškumą: TOML formatu bet kuris raktas, parašytas po lentelės antrašte, pvz., [tools.bash], priklauso tai lentelei. Pirmiausia išdėstyk aukščiausio lygio raktus, o [tools.*] blokus palik failo pabaigai.
Dokumentacijos agentas
# ~/.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"
Jis gali skaityti, ieškoti ir rašyti, bet negali vykdyti komandų: bash nėra jo sąraše. Kiekvienam failo kūrimui reikia tavo patvirtinimo. Išbandyk jį mažame modulyje prieš taikydamas visai saugyklai.
Agento modelio pasirinkimas
active_model tikisi sukonfigūruoto modelio aliaso. Vibe tiekiamas su integruotu modelu „Mistral Medium 3.5“, kurio aliasas yra mistral-medium-3.5. Norėdamas naudoti kitą modelį, pirmiausia deklaruok prieš nustatymą faile config.toml, tada nurodyk jo aliasą:
# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# agente faile
active_model = "codestral"
Jei active_model nenurodytas, agentas naudoja sesijos modelį.
Instrukcijų rašymas
Yra du keliai. instructions contient tekstą, įterptą tiesiai po Vibe sistemos prompt’u: tai paprasčiausias būdas. system_prompt_id nukreipia į Markdown failą aplanke prompts/, kas naudinga ilgiems prompt’ams, peržiūrimiems kodų recenzijų metu. Yra viena svarbi elgsenos detalė: tinkinto agento prompt’as taikomas tik tada, jei jį pasirenki prieš savo pirmąją žinutę (naudojant --agent arba Shift+Tab). Jei agentus keiti sesijos viduryje, jo įrankiai, leidimai ir modelis įsigalioja iškart, tačiau jo prompt’as pradeda veikti tik po komandos /clear.
Geriausios praktikos
Pirmiausia taikyk mažiausių privilegijų principą: suteik agentui tik tuos įrankius, kurių jam reikia. Analizės agentui nereikia write_file; rašytojui nereikia bash. Pašalinus kiekvieną įrankį, целая kategorija klaidų tampa neįmanoma.
Toliau – vienas agentas vienai atsakomybei: universalus failas visur duos vidutiniškus rezultatus. Trys tiksliniai failai yra geriau nei vienas bendras.
Galiausiai – tikslūs nurodymai: apibrėžk tikslų vaidmenį, projekto konvencijas, laukiamą išvesties formatą ir klaidas, kurių reikia vengti. Kai agentas nuvilia, beveik visada trūksta vieno iš šių keturių punktų.
Svarbiausi punktai
- Tinkintas agentas yra
.tomlfailas aplanke~/.vibe/agents/arba./.vibe/agents/; jo pavadinimas sutampa su failo pavadinimu - Naudingi raktai:
display_name,description,instructionsarbasystem_prompt_id,active_model,enabled_tools,disabled_tools,[tools.<tool>] - Įrankių pavadinimai:
read_file,write_file,edit,bash,grep,todo,task,skill,ask_user_question,web_fetch,web_search active_modeltikisi modelio prieš nustatymo aliaso (arbamistral-medium-3.5, kuris yra integruotas)[tools.*]blokus dėkite failo pabaigoje