Vytvorenie vlastného agenta v TOML
Na tejto strane
Lekcia prepísaná 2. novembra 2026. Predchádzajúce príklady používali kľúče, ktoré v súboroch agentov neexistujú (
model,system_prompt,auto_approve), a nástroje, ktoré neexistujú (list_dir,edit_file). Názvy kľúčov a nástrojov sú teraz v súlade s oficiálnou referenciou a zdrojovým kódom Vibe. Zdroje: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).
Za hranicami vstavaných agentov
Vstavané agenty pokrývajú štandardné persony, ale tvoje projekty majú jedinečné potreby: tím platobných systémov vyžaduje iné ochranné mechanizmy než tím dokumentácie. Vibe ti umožňuje vytvárať vlastné agenty umiestnením súboru .toml do priečinka ~/.vibe/agents/ (úroveň používateľa) alebo ./.vibe/agents/ (úroveň projektu, načíta sa len vtedy, ak je priečinok dôveryhodný). Správanie definované v súbore je čitateľné, verziovateľné a zdieľateľné, na rozdiel od inštrukcií, ktoré by sa museli opakovať v každej relácii.
Názov agenta zodpovedá názvu súboru: redteam.toml sa spustí príkazom vibe --agent redteam. Názov main je vyhradený.
Kľúče v súbore agenta
| Kľúč | Úloha |
|---|---|
agent_type | "agent" (predvolené, používateľ ho môže vybrať) alebo "subagent" (spúšťa sa len delegovaním) |
display_name, description | Zobrazovaný názov a popis; popis je povinný pre podagenta (subagent) |
instructions | Vložené inštrukcie pripojené za systémový prompt (pre podagenta ho nahrádzajú) |
system_prompt_id | Názov súboru Markdown v ~/.vibe/prompts/ alebo ./.vibe/prompts/ bez prípony |
active_model | Alias modelu, ktorý má tento agent používať |
enabled_tools, disabled_tools | Zoznam povolených a blokovaných nástrojov (presné názvy, vzory glob alebo regulárne výrazy re:) |
[tools.<tool>] | Oprávnenia pre konkrétne nástroje: permission = "always", "ask" alebo "never", plus pre bash zoznamy allowlist a denylist prefixov príkazov |
safety | Iba vizuálny indikátor (farba okraja vstupu): safe, neutral, destructive, smart alebo yolo; nevynucuje žiadne oprávnenia (Lekcia 3) |
Názvy nástrojov, ktoré môžeš použiť
Vstavané nástroje Vibe majú tieto názvy: read_file, write_file, edit (predtým search_replace), bash, grep, todo, task (delegovanie na podagenta), skill, ask_user_question, web_fetch a web_search. Nástroje zo servera MCP majú názov {server}_{tool} a nástroje konektorov majú názov connector_{connector}_{tool}. Preklep v názve nástroja v enabled_tools znamená, že sa nič nenajde: predtým, ako usúdiš, že agent „odmieta“ zapísať súbor, skontroluj pravopis.
Prvý agent: Plánovač
Vibe nemá vstavaného agenta plan; dokumentácia poskytuje tento príklad len na čítanie, ktorý slúži na preskúmanie repozitára a navrhnutie plánu pred akoukoľvek úpravou:
# ~/.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"
Spustíš ho príkazom vibe --agent plan. Keď je plán schválený, stlač Shift+Tab a prepni sa na accept-edits kvôli realizácii. Všimni si poradie v súbore: v TOML patrí každý kľúč napísaný po hlavičke tabuľky, ako je [tools.bash], do tejto tabuľky. Najprv uveď kľúče najvyššej úrovne a bloky [tools.*] umiestni na koniec.
Agent pre dokumentáciu
# ~/.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"
Tento agent môže čítať, vyhľadávať a zapisovať, ale nemôže spúšťať príkazy: bash nie je v jeho zozname. Každé vytvorenie súboru si vyžaduje tvoje schválenie. Vyskúšaj ho najprv na malom module, než ho použiješ na celý repozitár.
Výber modelu agenta
active_model očakáva alias nakonfigurovaného modelu. Vibe sa dodáva so vstavaným modelom Mistral Medium 3.5, ktorý má alias mistral-medium-3.5. Ak chceš použiť iný model, najprv deklaruj predvoľbu v súbore config.toml a potom odkáž na jej alias:
# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# v súbore agenta
active_model = "codestral"
Bez active_model použije agent model aktuálnej relácie.
Písanie inštrukcií
Existujú dve cesty. instructions obsahuje vložený text, ktorý sa pripojí za systémový prompt Vibe: toto je najjednoduchší prístup. system_prompt_id odkazuje na súbor Markdown v priečinku prompts/, čo je užitočné pre dlhé prompty, ktoré sa recenzujú v rámci code review. Dôležitý je jeden behaviorálny detail: prompt vlastného agenta sa aplikuje len vtedy, ak ho vyberieš pred svojou prvou správou (cez --agent alebo Shift+Tab). Ak prepneš agentov uprostred relácie, jeho nástroje, oprávnenia a model sa aplikujú okamžite, ale jeho prompt nadobudne účinnosť až po príkaze /clear.
Osvedčené postupy
Najprv najmenšie oprávnenia: daj agentovi len tie nástroje, ktoré potrebuje. Analytický agent nepotrebuje write_file; pisateľ nepotrebuje bash. Odstránením každého nástroja znemožníš celú kategóriu chýb.
Ďalej jeden agent na jednu zodpovednosť: súbor typu „všetko v jednom“ produkuje priemerné odpovede všade. Tri cielené súbory sú lepšie ako jeden všeobecný.
Nakoniec presné inštrukcie: definuj presnú úlohu, konvencie projektu, očakávaný formát výstupu a chyby, ktorým sa treba vyhnúť. Keď agent sklame, takmer vždy je to preto, že chýba jeden z týchto štyroch bodov.
Kľúčové poznatky
- Vlastný agent je súbor
.tomlv~/.vibe/agents/alebo./.vibe/agents/; jeho názov zodpovedá názvu súboru - Užitočné kľúče:
display_name,description,instructionsalebosystem_prompt_id,active_model,enabled_tools,disabled_tools,[tools.<tool>] - Názvy nástrojov:
read_file,write_file,edit,bash,grep,todo,task,skill,ask_user_question,web_fetch,web_search active_modeločakáva alias predvoľby modelu (alebomistral-medium-3.5, ktorý je vstavaný)- Bloky
[tools.*]umiestni na koniec súboru