Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izveido pielāgotu aģentu TOML formātā

Nodarbība 2 no 14 Atjaunota 2026. gada 2. novembris Augstākais
Šajā lapā
  1. Pāri iebūvētajiem aģentiem
  2. Aģenta faila atslēgas
  3. Rīki, kurus vari nosaukt
  4. Pirmais aģents: Plānotājs
  5. Dokumentācijas aģents
  6. Aģenta modeļa izvēle
  7. Instrukciju rakstīšana
  8. Labākā prakse
  9. Galvenās atziņas

Nodarbība pārrakstīta 2026. gada 2. novembrī. Iepriekšējos piemēros tika izmantotas atslēgas, kas aģentu failos neeksistē (model, system_prompt, auto_approve), kā arī neeksistējoši rīki (list_dir, edit_file). Atslēgas un rīku nosaukumi tagad ir saskaņoti ar oficiālo atsauces dokumentāciju un Vibe pirmkodu. Avoti: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).

Pāri iebūvētajiem aģentiem

Iebūvētie aģenti aptver standarta lomas, taču taviem projektiem ir unikālas vajadzības: maksājumu komandai ir nepieciešami citi drošības pasākumi nekā dokumentācijas komandai. Vibe ļauj izveidot pielāgotus aģentus, ievietojot .toml failu mapē ~/.vibe/agents/ (lietotāja līmenī) vai ./.vibe/agents/ (projekta līmenī, tiek ielādēts tikai tad, ja mape ir uzticama). Failā definētā uzvedība ir lasāma, versijējama un koplietojama, atšķirībā no instrukcijām, kas jāatkārto katrā sesijā.

Aģenta nosaukums sakrīt ar faila nosaukumu: redteam.toml tiek palaists ar komandu vibe --agent redteam. Nosaukums main ir rezervēts.

Aģenta faila atslēgas

AtslēgaLoma
agent_type"agent" (noklusējums, lietotājs var izvēlēties) vai "subagent" (tiek palaists tikai deleģējot)
display_name, descriptionAttēlojamais nosaukums un apraksts; apakšaģentam apraksts ir obligāts
instructionsIekļautās instrukcijas, kas tiek pievienotas pēc sistēmas uzvednes (apakšaģentam tās to aizstāj)
system_prompt_idMarkdown faila nosaukums mapē ~/.vibe/prompts/ vai ./.vibe/prompts/, bez paplašinājuma
active_modelModelim paredzētā aliasa nosaukums, ko izmantot šim aģentam
enabled_tools, disabled_toolsAtļauto un bloķēto rīku saraksts (precīzi nosaukumi, glob raksti vai re: izteiksmes)
[tools.<rīks>]Atļaujas konkrētam rīkam: permission = "always", "ask" vai "never", kā arī priekš bash komandu prefiksu allowlist un denylist
safetyTikai vizuāls indikatora elements (ievades robežas krāsa): safe, neutral, destructive, smart vai yolo; tas nepiespiež nekādas atļaujas (3. nodarbība)

Rīki, kurus vari nosaukt

Vibe iebūvētie rīki izmanto šos nosaukumus: read_file, write_file, edit (agrāk search_replace), bash, grep, todo, task (deleģēšana apakšaģentam), skill, ask_user_question, web_fetch un web_search. Rīki no MCP servera tiek nosaukti formātā {server}_{rīks}, bet konektoru rīki – connector_{konektors}_{rīks}. Nepareizi uzrakstīts rīka nosaukums sadaļā enabled_tools neatbildīs nekam: pārbaudi pareizrakstību, pirms secini, ka aģents “atsakās” rakstīt failu.

Pirmais aģents: Plānotājs

Vibe nav iebūvēta plan aģenta; dokumentācija sniedz šo tikai lasāmo piemēru, lai izpētītu repozitoriju un piedāvātu plānu pirms jebkādām izmaiņām:

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

Palaid to ar vibe --agent plan. Kad plāns ir apstiprināts, nospied Shift+Tab, lai pārietu uz accept-edits izpildei. Ņem vērā faila struktūru: TOML formātā jebkura atslēga, kas rakstīta pēc tabulas galvenes, piemēram, [tools.bash], pieder šai tabulai. Vispirms norādi augšējā līmeņa atslēgas, bet [tools.*] blokus izvieto faila beigās.

Dokumentācijas aģents

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

Tas var lasīt, meklēt un rakstīt, bet nevar izpildīt komandas: bash nav tā sarakstā. Katra faila izveide prasa tavu apstiprinājumu. Izmēģini to uz neliela moduļa, pirms to piemēro visam repozitorijam.

Aģenta modeļa izvēle

active_model sagaida konfigurēta modeļa aliasu. Vibe nāk ar iebūvētu modeli Mistral Medium 3.5, kura alias ir mistral-medium-3.5. Lai izmantotu citu modeli, vispirms deklarē iepriekšēju iestatījumu (preset) failā config.toml, pēc tam norādi tā aliasu:

# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# aģenta failā
active_model = "codestral"

Bez active_model aģents izmantos sesijas modeli.

Instrukciju rakstīšana

Ir divi ceļi. instructions satur iekļauto tekstu, kas tiek pievienots pēc Vibe sistēmas uzvednes: šī ir vienkāršākā pieeja. system_prompt_id norāda uz Markdown failu mapē prompts/, kas ir noderīgi garām uzvednēm, kuras tiek pārskatītas koda apskates laikā. Ir viens svarīgs uzvedības aspekts: pielāgota aģenta uzvedne tiek piemērota tikai tad, ja to izvēlies pirms sava pirmā ziņojuma (izmantojot --agent vai Shift+Tab). Ja sesijas laikā pārslēdzies uz citu aģentu, tā rīki, atļaujas un modelis stājas spēkā nekavējoties, bet tā uzvedne tiek aktivizēta tikai pēc komandas /clear.

Labākā prakse

Vispirms minimālās privilēģijas: piešķir aģentam tikai tos rīkus, kas tam ir nepieciešami. Analīzes aģentam nav vajadzīgs write_file; rakstītājam nav vajadzīgs bash. Katra rīka noņemšana padara veselu kļūdu kategoriju neiespējamu.

Tālāk – viens aģents vienai atbildībai: visaptverošs fails rada viduvējas atbildes visur. Trīs mērķtiecīgi faili ir labāki par vienu vispārīgu.

Visbeidzot – precīzas instrukcijas: definē precīzu lomu, projekta konvencijas, sagaidāmo izvades formātu un kļūdas, no kurām jāizvairās. Ja aģents tevi vīlis, gandrīz vienmēr iemesls ir kāda no šiem četriem punktiem trūkums.

Galvenās atziņas

  • Pielāgots aģents ir .toml fails mapē ~/.vibe/agents/ vai ./.vibe/agents/; tā nosaukums sakrīt ar faila nosaukumu
  • Noderīgas atslēgas: display_name, description, instructions vai system_prompt_id, active_model, enabled_tools, disabled_tools, [tools.<rīks>]
  • Rīku nosaukumi: read_file, write_file, edit, bash, grep, todo, task, skill, ask_user_question, web_fetch, web_search
  • active_model sagaida modeļa iepriekšēja iestatījuma (preset) aliasu (vai mistral-medium-3.5, kas ir iebūvēts)
  • Izvieto [tools.*] blokus faila beigās