Cruthaigh Gníomhaire Saincheaptha i dTOML
Ar an leathanach seo
An ceacht athscríofa an 2 Samhain, 2026. Bhain samplaí roimhe seo úsáid as eochracha nach bhfuil i gcomhaid ghníomhairí (
model,system_prompt,auto_approve) agus uirlisí nach bhfuil ann (list_dir,edit_file). Tá na heochracha agus ainmneacha na n-uirlisí ailínithe anois leis an tagairt oifigiúil agus le foinsechód Vibe. Foincí: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).
Thar Gníomhairí Inbhunaithe
Clúdaíonn gníomhairí inbhunaithe pearsantachtaí caighdeánacha, ach tá riachtanais uathúla ag do thionscadail: teastaíonn cosaintí difriúla ó fhoireann íocaíochtaí mar a theastaíonn ó fhoireann doiciméadúcháin. Ligeann Vibe duit gníomhairí saincheaptha a chruthú trí chomhad .toml a chur i ~/.vibe/agents/ (leibhéal an úsáideora) nó i ./.vibe/agents/ (leibhéal an tionscadail, luchtaithe ach amháin má tá an fillteán muiníneach). Tá an iompraíocht sainmhínithe i gcomhad inléite, inleaganaithe, agus inroinnte, seachas treoracha a dhéantar arís gach seisiún.
Freagraíonn ainm an ghníomhaire don ainm comhaid: seolann redteam.toml le vibe --agent redteam. Tá an t-ainm main curtha in áirithe.
Eochracha Comhaid Gníomhaire
| Eochair | Ról |
|---|---|
agent_type | "agent" (réamhshocrú, roghnaíthe ag an úsáideoir) nó "subagent" (seolta trí tharmligean amháin) |
display_name, description | Ainm taispeána agus cur síos; tá an cur síos éigeantach do fho-ghníomhaire |
instructions | Treoracha líne isteach a chuirtear leis tar éis an chóras-phreabhta (do fho-ghníomhaire, téann siad in ionad é) |
system_prompt_id | Ainm comhaid Markdown i ~/.vibe/prompts/ nó ./.vibe/prompts/, gan an leathnú |
active_model | Alias an mhúnla le húsáid don ghníomhaire seo |
enabled_tools, disabled_tools | Liosta ceadaithe agus liosta bacainne d’uirlisí (ainmneacha cruinne, patrúin glob, nó slonn re:) |
[tools.<tool>] | Ceadanna in aghaidh na huirlise: permission = "always", "ask", nó "never", chomh maith le allowlist agus denylist de réamhlitreacha ordaithe do bash |
safety | Táscaire amháin go amhairc (dath imeall an ionchuir): safe, neutral, destructive, smart, nó yolo; ní fhorghníomhaíonn sé ceadanna ar bith (Ceacht 3) |
Uirlisí is Féidir leat a Ainmniú
Úsáideann uirlisí inbhunaithe Vibe na hainmneacha seo: read_file, write_file, edit (search_replace roimhe), bash, grep, todo, task (tarmligean chuig fo-ghníomhaire), skill, ask_user_question, web_fetch, agus web_search. Ainmnítear uirlisí ó fhreastalaí MCP mar {server}_{tool}, agus is iad connector_{connector}_{tool} uirlisí nascóra. Ní mheaitseálann ainm uirlise mílitrithe in enabled_tools aon rud: fíoraigh an litriú sula dtugtar le fios go “diúltaíonn” gníomhaire comhad a scríobh.
An Chéad Ghníomhaire: An Pleanálaí
Níl aon ghníomhaire plan inbhunaithe ag Vibe; soláthraíonn an doiciméadú an sampla léamh-amháin seo chun stór a iniúchadh agus plean a mholadh sula ndéantar aon mhodhnú:
# ~/.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"
Seol é le vibe --agent plan. Nuair a bheidh an plean formheasta, brúigh Shift+Tab chun aistriú go accept-edits le haghaidh feidhmithe. Tabhair faoi deara ord an chomhaid: i dTOML, baineann aon eochair a scríobhtar tar éis ceanntásc tábla cosúil le [tools.bash] leis an tábla sin. Cuir eochracha leibhéil bharr ar dtús, agus bloic [tools.*] ag an deireadh.
Gníomhaire Doiciméadúcháin
# ~/.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"
Is féidir leis léamh, cuardach a dhéanamh, agus scríobh, ach ní féidir leis orduithe a rith: níl bash ina liosta. Éilíonn gach cruthú comhaid do cheadú. Bain triail as ar mhodúl beag sula gcuireann tú i bhfeidhm é ar stór iomlán.
Múnla Gníomhaire a Roghnú
Bíonn alias múnla cumraithe ag teastáil ó active_model. Tagann Vibe le múnla inbhunaithe, Mistral Medium 3.5, a bhfuil an t-alias mistral-medium-3.5 air. Chun múnla eile a úsáid, dearbh réamhshocrú ar dtús i config.toml, ansin tagairt a dhéanamh dá alias:
# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# sa chomhad gníomhaire
active_model = "codestral"
Gan active_model, úsáideann an gníomhaire múnla an tseisiúin.
Treoracha a Scríobh
Tá dhá bhealach ann. Cuireann instructions téacs líne isteach leis a chuirtear le córas-phreabhta Vibe: is é seo an cur chuige is simplí. Léiríonn system_prompt_id comhad Markdown san fhillteán prompts/, atá úsáideach do phreabhtaí fada a ndéantar athbhreithniú orthu in athbhreithnithe cóid. Tá mionsonraí iompraíochta amháin tábhachtach: ní bhaineann preabhta gníomhaire saincheaptha i bhfeidhm ach amháin má roghnaíonn tú é roimh do chéad teachtaireacht (trí --agent nó Shift+Tab). Má athraíonn tú gníomhairí le linn seisiúin, bíonn a uirlisí, a cheadanna agus a mhúnla i bhfeidhm láithreach, ach ní bhíonn éifeacht ag a phreabhta ach tar éis /clear.
Dea-Chleachtais
Príobháideacht íosta ar dtús: ná tabhair don ghníomhaire ach na huirlisí a theastaíonn uaidh. Ní theastaíonn write_file ó ghníomhaire anailíse; ní theastaíonn bash ó scríbhneoir. Déanann gach uirlis a bhaint catagóir iomlán earráidí dodhéanta.
Gníomhaire amháin in aghaidh na freagrachta ina dhiaidh sin: cruthaíonn comhad uileghabhálach freagraí meánacha i ngach áit. Is fearr trí chomhad spriocdhírithe ná ceann ginearálta amháin.
Treoracha cruinne ar deireadh: sainmhínigh an ról beacht, comhthéacsanna an tionscadail, formáid aschuir a bhfuiltear ag súil léi, agus earráidí le seachaint. Nuair a chuireann gníomhaire díomá ort, is de bharr nach bhfuil ceann de na ceithre phointe sin ann beagnach i gcónaí.
Príomhphointí
- Is comhad
.tomlé gníomhaire saincheaptha i~/.vibe/agents/nó i./.vibe/agents/; freagraíonn a ainm don ainm comhaid - Eochracha úsáideacha:
display_name,description,instructionsnósystem_prompt_id,active_model,enabled_tools,disabled_tools,[tools.<tool>] - Ainmneacha uirlisí:
read_file,write_file,edit,bash,grep,todo,task,skill,ask_user_question,web_fetch,web_search - Bíonn alias réamhshocraithe múnla ag teastáil ó
active_model(nómistral-medium-3.5, inbhunaithe) - Cuir bloic
[tools.*]ag deireadh an chomhaid