Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Loo kohandatud agent TOML-is

Õppetund 2 / 14 Värskendatud 2. november 2026 Edasijõudnutele
Sellel lehel
  1. Kaugemale sisseehitatud agentidest
  2. Agendi faili võtmed
  3. Tööriistad, mida saad nimetada
  4. Esimene agent: Planeerija
  5. Dokumentatsiooni agent
  6. Agendi mudeli valimine
  7. Juhiste kirjutamine
  8. Parimad tavad
  9. Peamised punktid

Õppetund kirjutati ümber 2. novembril 2026. Varasemad näited kasutasid võtmeid, mida agentide failides ei eksisteeri (model, system_prompt, auto_approve), ja olematuid tööriistu (list_dir, edit_file). Võtmed ja tööriistade nimed on nüüd viidud vastavusse ametliku dokumentatsiooni ja Vibe’i lähtekoodiga. Allikad: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).

Kaugemale sisseehitatud agentidest

Sisseehitatud agendid katavad standardsed isiksused, kuid sinu projektidel on unikaalsed vajadused: maksete meeskond vajab erinevaid kaitsemeetmeid võrreldes dokumentatsiooni meeskonnaga. Vibe võimaldab sul luua kohandatud agente, paigutades .toml faili kausta ~/.vibe/agents/ (kasutajatasand) või ./.vibe/agents/ (projektitasand, laaditakse ainult siis, kui kaust on usaldusväärne). Failis määratletud käitumine on loetav, versioneeritav ja jagatav, erinevalt juhistest, mida kordad igas sessioonis.

Agendi nimi vastab failinimele: redteam.toml käivitub käsuga vibe --agent redteam. Nimi main on reserveeritud.

Agendi faili võtmed

VõtiRoll
agent_type"agent" (vaikimisi, kasutaja valitav) või "subagent" (käivitub ainult delegeerimise teel)
display_name, descriptionKuva nimi ja kirjeldus; alamagendi puhul on kirjeldus kohustuslik
instructionsReasisused juhised, mis lisatakse süsteemiviiba järel (alamagendi puhul asendavad need seda)
system_prompt_idMarkdown-faili nimi kaustas ~/.vibe/prompts/ või ./.vibe/prompts/, ilma laiendita
active_modelSelle agendi jaoks kasutatava mudeli alias
enabled_tools, disabled_toolsTööriistade lubatud nimekiri ja keelunimekiri (täpsed nimed, glob-mustrid või re: avaldised)
[tools.<tool>]Tööriistapõhised õigused: permission = "always", "ask" või "never", lisaks bash puhul käskude eesliidete allowlist ja denylist
safetyAinult visuaalne indikaator (sisendi äärise värv): safe, neutral, destructive, smart või yolo; see ei jõusta mingeid õigusi (Õppetund 3)

Tööriistad, mida saad nimetada

Vibe’i sisseehitatud tööriistad kannavad järgmisi nimesid: read_file, write_file, edit (varem search_replace), bash, grep, todo, task (delegeerimine alamagendile), skill, ask_user_question, web_fetch ja web_search. MCP serveri tööriistad on nimega {server}_{tool} ja connector-tööriistad on connector_{connector}_{tool}. Valesti kirjutatud tööriista nimi võtmes enabled_tools ei sobi millegagi: kontrolli õigekirja enne järelduse tegemist, et agent „keeldub“ faili kirjutamast.

Esimene agent: Planeerija

Vibe’il pole sisseehitatud plan agenti; dokumentatsioon pakub seda kirjutuskaitstud näidet hoidla uurimiseks ja plaani väljatöötamiseks enne muudatuste tegemist:

# ~/.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"

Käivita see käsuga vibe --agent plan. Kui plaan on heaks kiidetud, vajuta Shift+Tab, et lülituda täitmiseks režiimi accept-edits. Pane tähele faili järjestust: TOML-is kuulub iga võti, mis on kirjutatud pärast tabeli päist nagu [tools.bash], sellele tabelile. Paiguta ülemise taseme võtmed esimesena ja [tools.*] plokid faili lõppu.

Dokumentatsiooni agent

# ~/.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"

See saab lugeda, otsida ja kirjutada, kuid ei saa käskude käivitada: bash pole selle nimekirjas. Iga faili loomine nõuab sinu kinnitust. Proovi seda väikese mooduli peal, enne kui rakendad seda tervele hoidlale.

Agendi mudeli valimine

active_model eeldab konfigureeritud mudeli aliast. Vibe’iga kaasneb sisseehitatud mudel Mistral Medium 3.5, aliasega mistral-medium-3.5. Teise mudeli jaoks deklareeri kõigepealt eelseadistus failis config.toml ja viita seejärel selle aliasele:

# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# agendi failis
active_model = "codestral"

Ilma active_model-ita kasutab agent sessiooni mudelit.

Juhiste kirjutamine

On kaks teed. instructions sisaldab reasisest teksti, mis lisatakse Vibe’i süsteemiviiba järel: see on lihtsaim lähenemine. system_prompt_id viitab Markdown-failile kaustas prompts/, mis on kasulik pikkade viipade jaoks, mida vaadatakse läbi koodiülevaatustel. Üks käitumuslik detail on oluline: kohandatud agendi viip kehtib ainult siis, kui valid selle enne oma esimest sõnumit (kasutades --agent või Shift+Tab). Kui lülitud agente sessiooni keskel, rakenduvad selle tööriistad, õigused ja mudel kohe, kuid selle viip jõustub alles pärast /clear.

Parimad tavad

Vähimaid õigusi esmalt: anna agendile ainult need tööriistad, mida ta vajab. Analüüsiagent ei vaja write_file; kirjutaja ei vaja bash. Iga tööriista eemaldamine muudab terve veakategooria võimatuks.

Üks agent ühe vastutusala kohta järgmisena: üldine fail toodab kõikjal keskpäraseid vastuseid. Kolm sihipärast faili on paremad kui üks üldine.

Täpsed juhised lõpuks: määratlege täpne roll, projekti konventsioonid, oodatav väljundvorming ja vead, mida vältida. Kui agent pettumust valmistab, on see peaaegu alati tingitud sellest, et üks neist neljast punktist puudub.

Peamised punktid

  • Kohandatud agent on .toml fail kaustas ~/.vibe/agents/ või ./.vibe/agents/; selle nimi vastab failinimele
  • Kasulikud võtmed: display_name, description, instructions või system_prompt_id, active_model, enabled_tools, disabled_tools, [tools.<tool>]
  • Tööriistade nimed: read_file, write_file, edit, bash, grep, todo, task, skill, ask_user_question, web_fetch, web_search
  • active_model eeldab mudeli eelseadistuse aliast (või sisseehitatud mistral-medium-3.5)
  • Paiguta [tools.*] plokid faili lõppu