Oħloq Aġent Customizzat f'TOML
F'din il-paġna
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
| Ċavetta | Rwol |
|---|---|
agent_type | "agent" (default, magħżul mill-utent) jew "subagent" (imniedi biss permezz ta’ delega) |
display_name, description | Isem u deskrizzjoni viżibbli; id-deskrizzjoni hija obbligatorja għal subagent |
instructions | Struzzjonijiet inline miżjuda wara l-prompt tas-sistema (għal subagent, dawn jissostitwixxuh) |
system_prompt_id | Isem ta’ fajl Markdown f’~/.vibe/prompts/ jew ./.vibe/prompts/, mingħajr l-estensjoni |
active_model | Alias tal-mudell li għandu jintuża għal dan l-aġent |
enabled_tools, disabled_tools | Lista 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 |
safety | Indikatur 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
.tomlf’~/.vibe/agents/jew./.vibe/agents/; ismu jaqbel mal-isem tal-fajl - Ċwievet utli:
display_name,description,instructionsjewsystem_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_modeljistenna alias ta’ preset tal-mudell (jewmistral-medium-3.5, integrat)- Poġġi l-blokki
[tools.*]fl-aħħar tal-fajl