Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cruthaigh Gníomhaire Saincheaptha i dTOML

Ceacht 2 as 14 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Thar Gníomhairí Inbhunaithe
  2. Eochracha Comhaid Gníomhaire
  3. Uirlisí is Féidir leat a Ainmniú
  4. An Chéad Ghníomhaire: An Pleanálaí
  5. Gníomhaire Doiciméadúcháin
  6. Múnla Gníomhaire a Roghnú
  7. Treoracha a Scríobh
  8. Dea-Chleachtais
  9. Príomhphointí

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

EochairRól
agent_type"agent" (réamhshocrú, roghnaíthe ag an úsáideoir) nó "subagent" (seolta trí tharmligean amháin)
display_name, descriptionAinm taispeána agus cur síos; tá an cur síos éigeantach do fho-ghníomhaire
instructionsTreoracha líne isteach a chuirtear leis tar éis an chóras-phreabhta (do fho-ghníomhaire, téann siad in ionad é)
system_prompt_idAinm comhaid Markdown i ~/.vibe/prompts/ nó ./.vibe/prompts/, gan an leathnú
active_modelAlias an mhúnla le húsáid don ghníomhaire seo
enabled_tools, disabled_toolsLiosta 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
safetyTá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, instructions nó 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