Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Vytvoření vlastního agenta v TOML

Lekce 2 z 14 Aktualizováno 2. listopadu 2026 Pokročilý
Na této stránce
  1. Za hranicemi vestavěných agentů
  2. Klíče v souboru agenta
  3. Nástroje, které můžeš pojmenovat
  4. První agent: Plánovač
  5. Agent pro dokumentaci
  6. Výběr modelu agenta
  7. Psaní pokynů
  8. Osvědčené postupy
  9. Klíčové poznatky

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, descriptionZobrazovaný název a popis; popis je pro podagenta povinný
instructionsInline pokyny připojené za systémový prompt (u podagenta jej nahrazují)
system_prompt_idNázev souboru Markdown ve složce ~/.vibe/prompts/ nebo ./.vibe/prompts/, bez přípony
active_modelAlias modelu, který má tento agent používat
enabled_tools, disabled_toolsWhitelist 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ů
safetyPouze 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 .toml v ~/.vibe/agents/ nebo ./.vibe/agents/; jeho název odpovídá názvu souboru
  • Užitečné klíče: display_name, description, instructions nebo system_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_model očekává alias presetu modelu (nebo mistral-medium-3.5, vestavěný)
  • Bloky [tools.*] umísti na konec souboru