Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Vytvorenie vlastného agenta v TOML

Lekcia 2 z 14 Aktualizované 2. novembra 2026 Pokročilý
Na tejto strane
  1. Za hranicami vstavaných agentov
  2. Kľúče v súbore agenta
  3. Názvy nástrojov, ktoré môžeš použiť
  4. Prvý agent: Plánovač
  5. Agent pre dokumentáciu
  6. Výber modelu agenta
  7. Písanie inštrukcií
  8. Osvedčené postupy
  9. Kľúčové poznatky

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, descriptionZobrazovaný názov a popis; popis je povinný pre podagenta (subagent)
instructionsVložené inštrukcie pripojené za systémový prompt (pre podagenta ho nahrádzajú)
system_prompt_idNázov súboru Markdown v ~/.vibe/prompts/ alebo ./.vibe/prompts/ bez prípony
active_modelAlias modelu, ktorý má tento agent používať
enabled_tools, disabled_toolsZoznam 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
safetyIba 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 .toml v ~/.vibe/agents/ alebo ./.vibe/agents/; jeho názov zodpovedá názvu súboru
  • Užitočné kľúče: display_name, description, instructions alebo system_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_model očakáva alias predvoľby modelu (alebo mistral-medium-3.5, ktorý je vstavaný)
  • Bloky [tools.*] umiestni na koniec súboru