Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Oħloq Aġent Customizzat f'TOML

Lezzjoni 2 / 14 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Lil Hinn mill-Aġenti Integrati
  2. Ċwievet tal-Fajl tal-Aġent
  3. Għodod Li Tista’ Tsemmi
  4. L-Ewwel Aġent: Il-Pjanifikatur
  5. Aġent tad-Dokumentazzjoni
  6. Għażla ta’ Mudell tal-Aġent
  7. Kittiba ta’ Struzzjonijiet
  8. L-Aħjar Prattiki
  9. Punti Ewlenin

Lezzjoni miktuba mill-ġdid fit-2 ta’ Novembru 2026. L-eżempji preċedenti kienu jużaw ċwievet li ma jeżistux fil-fajls tal-aġenti (model, system_prompt, auto_approve) u għodod li ma jeżistux (list_dir, edit_file). Iċ-ċwievet u l-ismijiet tal-għodod issa huma allinjati mar-referenza uffiċjali u mal-kodiċi sors ta’ Vibe. Sorsi: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).

Lil Hinn mill-Aġenti Integrati

L-aġenti integrati jkopru persuni standard, iżda l-proġetti tiegħek għandhom ħtiġijiet uniċi: tim tal-pagamenti jeħtieġ salvagwardji differenti minn tim tad-dokumentazzjoni. Vibe jħallik toħloq aġenti customizzati billi tpoġġi fajl .toml f’~/.vibe/agents/ (livell tal-utent) jew ./.vibe/agents/ (livell tal-proġett, imħaddem biss jekk il-folder ikun affidabbli). L-imġiba definita f’fajl hija leġibbli, tista’ tiġi vverżjonata u kondiviża, kuntrarju għal struzzjonijiet li jiġu ripetuti f’kull sessjoni.

L-isem tal-aġent jaqbel mal-isem tal-fajl: redteam.toml jinbeda b’vibe --agent redteam. L-isem main huwa riżervat.

Ċwievet tal-Fajl tal-Aġent

ĊavettaRwol
agent_type"agent" (default, magħżul mill-utent) jew "subagent" (imniedi biss permezz ta’ delega)
display_name, descriptionIsem u deskrizzjoni viżibbli; id-deskrizzjoni hija obbligatorja għal subagent
instructionsStruzzjonijiet inline miżjuda wara l-prompt tas-sistema (għal subagent, dawn jissostitwixxuh)
system_prompt_idIsem ta’ fajl Markdown f’~/.vibe/prompts/ jew ./.vibe/prompts/, mingħajr l-estensjoni
active_modelAlias tal-mudell li għandu jintuża għal dan l-aġent
enabled_tools, disabled_toolsLista abjad u lista sewda ta’ għodod (ismijiet eżatti, mudelli glob, jew espressjonijiet re:)
[tools.<tool>]Permessi għal kull għodda: permission = "always", "ask", jew "never", plus għal bash, allowlist u denylist ta’ prefissi tal-kmand
safetyIndikatur viżiv biss (kulur tal-bord tal-input): safe, neutral, destructive, smart, jew yolo; ma jinfurzax permessi (Lezzjoni 3)

Għodod Li Tista’ Tsemmi

L-għodod integrati ta’ Vibe jużaw dawn l-ismijiet: read_file, write_file, edit (qabel search_replace), bash, grep, todo, task (delega lil subagent), skill, ask_user_question, web_fetch, u web_search. L-għodod minn server MCP huma msemmija {server}_{tool}, u l-għodod tal-konnettur huma connector_{connector}_{tool}. Isem ta’ għodda miktub ħażin f’enabled_tools ma jaqbel ma’ xejn: ivverifika l-ortografija qabel ma tikkonkludi li aġent “jirrifjuta” jikteb fajl.

L-Ewwel Aġent: Il-Pjanifikatur

Vibe m’għandux aġent plan integrat; id-dokumentazzjoni tipprovdi dan l-eżempju ta’ qari biss biex tesplora repository u tipproponi pjan qabel kwalunkwe modifika:

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

Inedih b’vibe --agent plan. Ladarba l-pjan jiġi approvat, agħfas Shift+Tab biex tibdel għal accept-edits għall-eżekuzzjoni. Innota l-ordni tal-fajl: f’TOML, kwalunkwe ċavetta miktuba wara header ta’ tabella bħal [tools.bash] tappartjeni għal dik it-tabella. Poġġi ċ-ċwievet tal-livell għoli l-ewwel, u l-blokki [tools.*] fl-aħħar.

Aġent tad-Dokumentazzjoni

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

Jista’ jaqra, ifittex u jikteb, iżda ma jistax iħaddem kmandi: bash mhux fil-lista tiegħu. Kull ħolqien ta’ fajl jeħtieġ l-approvazzjoni tiegħek. Ipprovah fuq modulu żgħir qabel ma tapplikah fuq repository sħiħ.

Għażla ta’ Mudell tal-Aġent

active_model jistenna l-alias ta’ mudell ikkonfigurat. Vibe jiġi b’mudell integrat, Mistral Medium 3.5, bl-alias mistral-medium-3.5. Għal mudell ieħor, iddikjara l-ewwel preset f’config.toml, imbagħad irreferenzja l-alias tiegħu:

# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# fil-fajl tal-aġent
active_model = "codestral"

Mingħajr active_model, l-aġent juża l-mudell tas-sessjoni.

Kittiba ta’ Struzzjonijiet

Jeżistu żewġ triqat. instructions fih test inline miżjud wara l-prompt tas-sistema ta’ Vibe: din hija l-aktar approċċ sempliċi. system_prompt_id jipponta lejn fajl Markdown fil-folder prompts/, utli għal prompts twal riveduti fi code reviews. Dettall komportamentali wieħed huwa importanti: il-prompt ta’ aġent customizzat japplika biss jekk tagħżlu qabel l-ewwel messaġġ tiegħek (permezz ta’ --agent jew Shift+Tab). Jekk tibdel l-aġenti f’nofs is-sessjoni, l-għodod, il-permessi u l-mudell tiegħu japplikaw immedjatament, iżda l-prompt tiegħu jidħol fis-seħħ biss wara /clear.

L-Aħjar Prattiki

Privileġġ minimu l-ewwel: agħti lill-aġent biss l-għodod li jeħtieġ. Aġent tal-analiżi m’għandux bżonn write_file; kittieb m’għandux bżonn bash. It-tneħħija ta’ kull għodda tagħmel kategorija sħiħa ta’ żbalji impossibbli.

Aġent wieħed għal kull responsabbiltà imbagħad: fajl catch-all jipproduċi tweġibiet medjokri kullimkien. Tliet fajls immirati huma aħjar minn wieħed ġeneriku.

Struzzjonijiet preċiżi fl-aħħar: iddefinixxi r-rwol eżatt, il-konvenzjonijiet tal-proġett, il-format tal-output mistenni, u l-iżbalji li għandek tevita. Meta aġent iddisappunta, kważi dejjem ikun għaliex wieħed minn dawn l-erba’ punti jonqos.

Punti Ewlenin

  • Aġent customizzat huwa fajl .toml f’~/.vibe/agents/ jew ./.vibe/agents/; ismu jaqbel mal-isem tal-fajl
  • Ċwievet utli: display_name, description, instructions jew system_prompt_id, active_model, enabled_tools, disabled_tools, [tools.<tool>]
  • Ismijiet tal-għodod: read_file, write_file, edit, bash, grep, todo, task, skill, ask_user_question, web_fetch, web_search
  • active_model jistenna alias ta’ preset tal-mudell (jew mistral-medium-3.5, integrat)
  • Poġġi l-blokki [tools.*] fl-aħħar tal-fajl