Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Sukurkite tinkintą agentą TOML formatu

Paskaita 2 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Pažengusiems
Šiame puslapyje
  1. Anapus integruotų agentų
  2. Agento failo raktai
  3. Įrankiai, kuriuos gali nurodyti
  4. Pirmasis agentas: Planuotojas
  5. Dokumentacijos agentas
  6. Agento modelio pasirinkimas
  7. Instrukcijų rašymas
  8. Geriausios praktikos
  9. Svarbiausi punktai

Pamoka perrašyta 2026 m. lapkričio 2 d. Ankstesniuose pavyzdžiuose naudoti raktai, kurių nėra agentų failuose (model, system_prompt, auto_approve), ir neegzistuojantys įrankiai (list_dir, edit_file). Dabar raktai ir įrankių pavadinimai atitinka oficialią dokumentaciją bei Vibe šaltinio kodą. Šaltiniai: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).

Anapus integruotų agentų

Integruoti agentai apima standartines vaidmenų kategorijas, tačiau tavo projektai turi unikalių poreikių: mokėjimų komandai reikia kitokių apsaugos priemonių nei dokumentacijos komandai. Vibe leidžia kurti tinkintus agentus, patalpinant .toml failą aplanke ~/.vibe/agents/ (naudotojo lygmeniu) arba ./.vibe/agents/ (projekto lygmeniu, įkeliamas tik jei aplankas patikimas). Faile apibrėžta elgsena yra skaitoma, versijuojama ir lengvai dalinama, skirtingai nei instrukcijos, kartojamos kiekvienos sesijos metu.

agento pavadinimas sutampa su failo pavadinimu: redteam.toml paleidžiamas komanda vibe --agent redteam. Pavadinimas main yra rezervuotas.

Agento failo raktai

RaktasVaidmuo
agent_type"agent" (numatytasis, pasirenkamas naudotojo) arba "subagent" (paleidžiamas tik deleguojant)
display_name, descriptionRodomas pavadinimas ir aprašymas; subagentui aprašymas yra privalomas
instructionsĮterptos instrukcijos, pridėtos po sistemos prompt’u (subagentui jos jį pakeičia)
system_prompt_idMarkdown failo, esančio aplanke ~/.vibe/prompts/ arba ./.vibe/prompts/, pavadinimas be plėtinio
active_modelModelio, kurį naudos šis agentas, aliasas
enabled_tools, disabled_toolsLeidžiamų ir blokuojamų įrankių sąrašai (tikslūs pavadinimai, glob šablonai arba re: išraiškos)
[tools.<tool>]Įrankio leidimai kiekvienam įrankiui atskirai: permission = "always", "ask" arba "never"; bash atveju taip pat galima nustatyti komandų priešdėlių allowlist ir denylist
safetyTik vizualus indikatorius (įvesties rėmelio spalva): safe, neutral, destructive, smart arba yolo; jis neprivalo jokių leidimų (3 pamoka)

Įrankiai, kuriuos gali nurodyti

Integruoti Vibe įrankiai naudoja šiuos pavadinimus: read_file, write_file, edit (anksčiau search_replace), bash, grep, todo, task (delegavimas subagentui), skill, ask_user_question, web_fetch ir web_search. Įrankiai iš MCP serverio vadinami {server}_{tool}, o jungties (connector) įrankiai – connector_{connector}_{tool}. Neteisingai parašytas įrankio pavadinimas enabled_tools sąraše nieko neatitiks: prieš darant išvadą, kad agentas „atsisako“ rašyti failą, patikrink rašybą.

Pirmasis agentas: Planuotojas

Vibe neturi integruoto plan agento; dokumentacijoje pateikiamas tik skaitymui skirtas pavyzdys, skirtas saugyklai išnagrinėti ir planui pasiūlyti prieš atliekant bet kokius pakeitimus:

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

Paleisk jį komanda vibe --agent plan. Kai planas bus patvirtintas, paspausk Shift+Tab, kad perjungtum į accept-edits vykdymui. Atkreipk dėmesį į failo eiliškumą: TOML formatu bet kuris raktas, parašytas po lentelės antrašte, pvz., [tools.bash], priklauso tai lentelei. Pirmiausia išdėstyk aukščiausio lygio raktus, o [tools.*] blokus palik failo pabaigai.

Dokumentacijos agentas

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

Jis gali skaityti, ieškoti ir rašyti, bet negali vykdyti komandų: bash nėra jo sąraše. Kiekvienam failo kūrimui reikia tavo patvirtinimo. Išbandyk jį mažame modulyje prieš taikydamas visai saugyklai.

Agento modelio pasirinkimas

active_model tikisi sukonfigūruoto modelio aliaso. Vibe tiekiamas su integruotu modelu „Mistral Medium 3.5“, kurio aliasas yra mistral-medium-3.5. Norėdamas naudoti kitą modelį, pirmiausia deklaruok prieš nustatymą faile config.toml, tada nurodyk jo aliasą:

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

Jei active_model nenurodytas, agentas naudoja sesijos modelį.

Instrukcijų rašymas

Yra du keliai. instructions contient tekstą, įterptą tiesiai po Vibe sistemos prompt’u: tai paprasčiausias būdas. system_prompt_id nukreipia į Markdown failą aplanke prompts/, kas naudinga ilgiems prompt’ams, peržiūrimiems kodų recenzijų metu. Yra viena svarbi elgsenos detalė: tinkinto agento prompt’as taikomas tik tada, jei jį pasirenki prieš savo pirmąją žinutę (naudojant --agent arba Shift+Tab). Jei agentus keiti sesijos viduryje, jo įrankiai, leidimai ir modelis įsigalioja iškart, tačiau jo prompt’as pradeda veikti tik po komandos /clear.

Geriausios praktikos

Pirmiausia taikyk mažiausių privilegijų principą: suteik agentui tik tuos įrankius, kurių jam reikia. Analizės agentui nereikia write_file; rašytojui nereikia bash. Pašalinus kiekvieną įrankį, целая kategorija klaidų tampa neįmanoma.

Toliau – vienas agentas vienai atsakomybei: universalus failas visur duos vidutiniškus rezultatus. Trys tiksliniai failai yra geriau nei vienas bendras.

Galiausiai – tikslūs nurodymai: apibrėžk tikslų vaidmenį, projekto konvencijas, laukiamą išvesties formatą ir klaidas, kurių reikia vengti. Kai agentas nuvilia, beveik visada trūksta vieno iš šių keturių punktų.

Svarbiausi punktai

  • Tinkintas agentas yra .toml failas aplanke ~/.vibe/agents/ arba ./.vibe/agents/; jo pavadinimas sutampa su failo pavadinimu
  • Naudingi raktai: display_name, description, instructions arba system_prompt_id, active_model, enabled_tools, disabled_tools, [tools.<tool>]
  • Įrankių pavadinimai: read_file, write_file, edit, bash, grep, todo, task, skill, ask_user_question, web_fetch, web_search
  • active_model tikisi modelio prieš nustatymo aliaso (arba mistral-medium-3.5, kuris yra integruotas)
  • [tools.*] blokus dėkite failo pabaigoje