Vytvoření vlastního agenta v TOML
Na této stránce
Lekce přepsána 2. listopadu 2026. Předchozí příklady používaly klíče, které v souborech agentů neexistují (
model,system_prompt,auto_approve), a nástroje, které neexistují (list_dir,edit_file). Názvy klíčů a nástrojů jsou nyní v souladu s oficiální referencí a zdrojovým kódem Vibe. Zdroje: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).
Za hranicemi vestavěných agentů
Vestavění agenti pokrývají standardní persony, ale tvé projekty mají jedinečné potřeby: tým plateb vyžaduje jiná bezpečnostní opatření než tým dokumentace. Vibe ti umožňuje vytvářet vlastní agenty umístěním souboru .toml do ~/.vibe/agents/ (úroveň uživatele) nebo ./.vibe/agents/ (úroveň projektu, načte se pouze, pokud je složka důvěryhodná). Chování definované v souboru je čitelné, verzovatelné a sdílitelné, na rozdíl od pokynů opakovaných v každé relaci.
Název agenta odpovídá názvu souboru: redteam.toml se spustí příkazem vibe --agent redteam. Název main je vyhrazen.
Klíče v souboru agenta
| Klíč | Role |
|---|---|
agent_type | "agent" (výchozí, volitelné uživatelem) nebo "subagent" (spouští se pouze delegováním) |
display_name, description | Zobrazovaný název a popis; popis je pro podagenta povinný |
instructions | Inline pokyny připojené za systémový prompt (u podagenta jej nahrazují) |
system_prompt_id | Název souboru Markdown ve složce ~/.vibe/prompts/ nebo ./.vibe/prompts/, bez přípony |
active_model | Alias modelu, který má tento agent používat |
enabled_tools, disabled_tools | Whitelist a blacklist nástrojů (přesné názvy, glob vzory nebo výrazy re:) |
[tools.<tool>] | Oprávnění pro konkrétní nástroj: permission = "always", "ask" nebo "never", plus pro bash seznamy allowlist a denylist prefixů příkazů |
safety | Pouze vizuální indikátor (barva okraje vstupu): safe, neutral, destructive, smart nebo yolo; nevynucuje žádná oprávnění (Lekce 3) |
Nástroje, které můžeš pojmenovat
Vestavěné nástroje Vibe mají tyto názvy: read_file, write_file, edit (dříve search_replace), bash, grep, todo, task (delegování na podagenta), skill, ask_user_question, web_fetch a web_search. Nástroje ze serveru MCP se nazývají {server}_{tool} a nástroje konektoru connector_{connector}_{tool}. Překlepnutý název nástroje v enabled_tools nic nespáruje: před závěrem, že agent „odmítá“ zapisovat soubor, ověř pravopis.
První agent: Plánovač
Vibe nemá vestavěného agenta plan; dokumentace poskytuje tento příklad pouze pro čtení, který slouží k prozkoumání repozitáře a návrhu plánu před jakoukoli ú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íš jej příkazem vibe --agent plan. Jakmile je plán schválen, stiskni Shift+Tab a přepni se na accept-edits pro provedení. Všimni si pořadí v souboru: v TOML patří jakýkoli klíč zapsaný po hlavičce tabulky, jako je [tools.bash], do této tabulky. Nejprve umísti klíče nejvyšší úrovně a bloky [tools.*] až na konec.
Agent pro dokumentaci
# ~/.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"
Může číst, hledat a zapisovat, ale nemůže spouštět příkazy: bash není na jeho seznamu. Každé vytvoření souboru vyžaduje tvé schválení. Vyzkoušej jej nejprve na malém modulu, než jej nasadíš na celý repozitář.
Výběr modelu agenta
active_model očekává alias nakonfigurovaného modelu. Vibe je dodáván s vestavěným modelem Mistral Medium 3.5, aliasovaným jako mistral-medium-3.5. Pro jiný model nejprve deklaruj preset v config.toml a poté odkazuj na jeho alias:
# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# v souboru agenta
active_model = "codestral"
Bez active_model použije agent model aktuální relace.
Psaní pokynů
Existují dvě cesty. instructions obsahuje inline text připojený za systémový prompt Vibe: toto je nejjednodušší přístup. system_prompt_id odkazuje na soubor Markdown ve složce prompts/, což je užitečné pro dlouhé prompty recenzované v code review. Důležitý je jeden detail chování: prompt vlastního agenta se aplikuje pouze tehdy, pokud jej vybereš před svou první zprávou (pomocí --agent nebo Shift+Tab). Pokud přepneš agenty uprostřed relace, jeho nástroje, oprávnění a model se použijí okamžitě, ale jeho prompt se projeví až po /clear.
Osvědčené postupy
Nejprve nejmenší privilegia: dej agentovi pouze nástroje, které potřebuje. Analytický agent nepotřebuje write_file; pisatel nepotřebuje bash. Odstraněním každého nástroje učiníš celou kategorii chyb nemožnou.
Dále jeden agent na jednu odpovědnost: soubor typu „vše v jednom“ produkuje průměrné odpovědi všude. Tři cílené soubory jsou lepší než jeden obecný.
Nakonec přesné pokyny: definuj přesnou roli, konvence projektu, očekávaný formát výstupu a chyby, kterým se vyhnout. Když agent zklame, je to téměř vždy proto, že jeden z těchto čtyř bodů chybí.
Klíčové poznatky
- Vlastní agent je soubor
.tomlv~/.vibe/agents/nebo./.vibe/agents/; jeho název odpovídá názvu souboru - Užitečné klíče:
display_name,description,instructionsnebosystem_prompt_id,active_model,enabled_tools,disabled_tools,[tools.<tool>] - Názvy nástrojů:
read_file,write_file,edit,bash,grep,todo,task,skill,ask_user_question,web_fetch,web_search active_modeločekává alias presetu modelu (nebomistral-medium-3.5, vestavěný)- Bloky
[tools.*]umísti na konec souboru