Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Ustvari prilagojenega agenta v TOML

Lekcija 2 od 14 Posodobljeno 2. november 2026 Napredni
Na tej strani
  1. Onkraj vgrajenih agentov
  2. Ključi v datoteki agenta
  3. Orodja, ki jih lahko imenuješ
  4. Prvi agent: Načrtovalec
  5. Agent za dokumentacijo
  6. Izbira modela agenta
  7. Pisanje navodil
  8. Najboljše prakse
  9. Ključne ugotovitve

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, descriptionPrikazno ime in opis; opis je obvezen za podagenta
instructionsVrstična navodila, dodana za sistemskim pozivom (za podagenta ta nadomestijo sistemski poziv)
system_prompt_idIme datoteke Markdown v ~/.vibe/prompts/ ali ./.vibe/prompts/, brez končnice
active_modelVzdevek modela, ki ga bo uporabljal ta agent
enabled_tools, disabled_toolsSeznam 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
safetyVizualni 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 .toml v ~/.vibe/agents/ ali ./.vibe/agents/; njegovo ime se ujema z imenom datoteke
  • Uporabni ključi: display_name, description, instructions ali system_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_model pričakuje vzdevek prednastavitve modela (ali mistral-medium-3.5, vgrajen)
  • Bloke [tools.*] postavi na konec datoteke