Ustvari prilagojenega agenta v TOML
Na tej strani
Lekcija ponovno napisana 2. novembra 2026. Prejšnji primeri so uporabljali ključe, ki v datotekah agentov ne obstajajo (
model,system_prompt,auto_approve), in orodja, ki ne obstajajo (list_dir,edit_file). Ključi in imena orodij so zdaj usklajeni z uradno referenco in izvorno kodo Vibe. Viri: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).
Onkraj vgrajenih agentov
Vgrajeni agenti pokrivajo standardne persone, vendar imajo tvoji projekti edinstvene potrebe: ekipa za plačila zahteva drugačne varnostne ukrepe kot ekipa za dokumentacijo. Vibe ti omogoča ustvarjanje prilagojenih agentov z namestitvijo datoteke .toml v ~/.vibe/agents/ (na ravni uporabnika) ali ./.vibe/agents/ (na ravni projekta, naložena le, če je mapa zaupanja vredna). Obnašanje, definirano v datoteki, je berljivo, različljivo in deljivo, za razliko od navodil, ki jih ponavljaš v vsaki seji.
Ime agenta se ujema z imenom datoteke: redteam.toml se zažene z vibe --agent redteam. Ime main je rezervirano.
Ključi v datoteki agenta
| Ključ | Vloga |
|---|---|
agent_type | "agent" (privzeto, izbere ga uporabnik) ali "subagent" (zažene se le z delegiranjem) |
display_name, description | Prikazno ime in opis; opis je obvezen za podagenta |
instructions | Vrstična navodila, dodana za sistemskim pozivom (za podagenta ta nadomestijo sistemski poziv) |
system_prompt_id | Ime datoteke Markdown v ~/.vibe/prompts/ ali ./.vibe/prompts/, brez končnice |
active_model | Vzdevek modela, ki ga bo uporabljal ta agent |
enabled_tools, disabled_tools | Seznam dovoljenih in blokiranih orodij (točna imena, vzorci glob ali izrazi re:) |
[tools.<tool>] | Dovoljenja za posamezno orodje: permission = "always", "ask" ali "never", poleg tega pa za bash še allowlist in denylist predpon ukazov |
safety | Vizualni kazalnik (barva roba vnosa): safe, neutral, destructive, smart ali yolo; ne uveljavlja nobenih dovoljenj (Lekcija 3) |
Orodja, ki jih lahko imenuješ
Vgrajena orodja Vibe uporabljajo ta imena: read_file, write_file, edit (prej search_replace), bash, grep, todo, task (delegiranje podagentu), skill, ask_user_question, web_fetch in web_search. Orodja s strežnika MCP so poimenovana {server}_{tool}, orodja konektorjev pa connector_{connector}_{tool}. Napačno črkovano ime orodja v enabled_tools se ne ujema z ničemer: preden sklepaš, da agent „noče” zapisati datoteke, preveri črkovanje.
Prvi agent: Načrtovalec
Vibe nima vgrajenega agenta plan; dokumentacija ponuja ta primer samo za branje, ki raziskuje skladišče in predlaga načrt pred kakršno koli spremembo:
# ~/.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"
Zaženi ga z vibe --agent plan. Ko je načrt odobren, pritisni Shift+Tab, da preklopiš na accept-edits za izvedbo. Upoštevaj vrstni red v datoteki: v TOML vsak ključ, zapisan za glavo tabele, kot je [tools.bash], spada k tej tabeli. Najprej navedi ključe na najvišji ravni, bloke [tools.*] pa postavi na konec.
Agent za dokumentacijo
# ~/.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"
Lahko bere, išče in piše, vendar ne more zaganjati ukazov: bash ni na njegovem seznamu. Vsaka kreacija datoteke zahteva tvojo odobritev. Preizkusi ga na majhnem modulu, preden ga uporabiš za celotno skladišče.
Izbira modela agenta
active_model pričakuje vzdevek konfiguriranega modela. Vibe je opremljen z vgrajenim modelom, Mistral Medium 3.5, z vzdevkom mistral-medium-3.5. Za drug model najprej deklariraj prednastavitev v config.toml, nato pa sklicuj na njen vzdevek:
# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# v datoteki agenta
active_model = "codestral"
Brez active_model agent uporabi model seje.
Pisanje navodil
Obstajata dve poti. instructions vsebuje besedilo v vrstici, dodano za sistemskim pozivom Vibe: to je najpreprostejši pristop. system_prompt_id kaže na datoteko Markdown v mapi prompts/, kar je uporabno za dolge pozive, pregledane med pregledi kode. Pomembna je ena podrobnost obnašanja: poziv prilagojenega agenta velja le, če ga izbereš pred svojim prvim sporočilom (prek --agent ali Shift+Tab). Če agente zamenjaš sredi seje, se njegova orodja, dovoljenja in model uporabijo takoj, njegov poziv pa začne veljati šele po /clear.
Najboljše prakse
Najprej najmanjša privilegija: daj agentu le orodja, ki jih potrebuje. Agent za analizo ne potrebuje write_file; pisec ne potrebuje bash. Z odstranitvijo vsakega orodja postane cela kategorija napak nemogoča.
Nato en agent na odgovornost: datoteka za vse namene proizvaja povprečne odgovore povsod. Tri ciljne datoteke so boljše od ene splošne.
Končno natančna navodila: opredeli točno vlogo, konvencije projekta, pričakovano obliko izhoda in napake, ki se jim je treba izogniti. Ko agent razočara, je to skoraj vedno zato, ker manjka ena od teh štirih točk.
Ključne ugotovitve
- Prilagojen agent je datoteka
.tomlv~/.vibe/agents/ali./.vibe/agents/; njegovo ime se ujema z imenom datoteke - Uporabni ključi:
display_name,description,instructionsalisystem_prompt_id,active_model,enabled_tools,disabled_tools,[tools.<tool>] - Imena orodij:
read_file,write_file,edit,bash,grep,todo,task,skill,ask_user_question,web_fetch,web_search active_modelpričakuje vzdevek prednastavitve modela (alimistral-medium-3.5, vgrajen)- Bloke
[tools.*]postavi na konec datoteke