Opret en brugerdefineret agent i TOML
På denne side
Lektionen er omskrevet den 2. november 2026. Tidligere eksempler brugte nøgler, der ikke findes i agentfiler (
model,system_prompt,auto_approve), og værktøjer, der ikke eksisterer (list_dir,edit_file). Nøgler og værktøjsnavne er nu tilpasset den officielle reference og Vibe-kildekoden. Kilder: Agents · Configuration reference — Agent definition files · built-in tools (mistral-vibe repo).
Ud over indbyggede agenter
Indbyggede agenter dækker standardpersonas, men dine projekter har unikke behov: Et betalingsteam kræver andre sikkerhedsforanstaltninger end et dokumentationsteam. Vibe lader dig oprette brugerdefinerede agenter ved at placere en .toml-fil i ~/.vibe/agents/ (brugerniveau) eller ./.vibe/agents/ (projektniveau, indlæses kun hvis mappen er betroet). Adfærd defineret i en fil er læsbar, versionsstyret og delbar, i modsætning til instrukser, der gentages ved hver session.
Agentens navn svarer til filnavnet: redteam.toml startes med vibe --agent redteam. Navnet main er reserveret.
Nøgler i agentfiler
| Nøgle | Rolle |
|---|---|
agent_type | "agent" (standard, vælges af bruger) eller "subagent" (startes kun ved delegering) |
display_name, description | Vist navn og beskrivelse; beskrivelse er obligatorisk for en underagent |
instructions | Indlejrede instrukser, der tilføjes efter systemprompten (for en underagent erstatter disse den) |
system_prompt_id | Navn på en Markdown-fil i ~/.vibe/prompts/ eller ./.vibe/prompts/, uden filtypenavn |
active_model | Alias for den model, der skal bruges til denne agent |
enabled_tools, disabled_tools | Allowlist og blocklist over værktøjer (nøjagtige navne, glob-mønstre eller re:-udtryk) |
[tools.<værktøj>] | Tilladelser pr. værktøj: permission = "always", "ask" eller "never", plus for bash, allowlist og denylist over kommandopræfikser |
safety | Kun visuel indikator (input-rammefarve): safe, neutral, destructive, smart eller yolo; den håndhæver ingen tilladelser (Lektion 3) |
Værktøjer, du kan navngive
Vibes indbyggede værktøjer bruger disse navne: read_file, write_file, edit (tidligere search_replace), bash, grep, todo, task (delegering til en underagent), skill, ask_user_question, web_fetch og web_search. Værktøjer fra en MCP-server navngives {server}_{værktøj}, og connector-værktøjer er connector_{connector}_{værktøj}. Et forkert stavet værktøjsnavn i enabled_tools matcher ingenting: tjek stavemåden, før du konkluderer, at en agent “nægter” at skrive en fil.
Første agent: Planlæggeren
Vibe har ingen indbygget plan-agent; dokumentationen leverer dette skrivebeskyttede eksempel til at udforske et repository og foreslå en plan før enhver ændring:
# ~/.vibe/agents/plan.toml
display_name = "Plan"
description = "Udforsker repository'et og foreslår en plan før enhver ændring."
safety = "safe"
disabled_tools = ["edit", "write_file"]
instructions = """
Udforsk repository'et og foreslæg en trinvis implementeringsplan.
Ændr ingen filer, før brugeren har godkendt planen.
"""
[tools.bash]
permission = "ask"
Start den med vibe --agent plan. Når planen er godkendt, skal du trykke på Shift+Tab for at skifte til accept-edits til udførelse. Bemærk filrækkefølgen: I TOML tilhører enhver nøgle skrevet efter en tabeloverskrift som [tools.bash] den tabel. Placer topniveau-nøgler først og [tools.*]-blokke til sidst.
En dokumentationsagent
# ~/.vibe/agents/doc-writer.toml
display_name = "Teknisk forfatter"
description = "Skriver teknisk dokumentation baseret på kildekode."
safety = "neutral"
enabled_tools = ["read_file", "grep", "write_file", "edit", "ask_user_question"]
instructions = """
Baseret på kildekoden:
1. Skriv en docstring for hver offentlig funktion.
2. Vedligehold en struktureret README med eksempler.
3. Dokumentér krævede miljøvariabler.
Stil: Professionel, koncis, understøttet af kodeeksempler.
"""
[tools.write_file]
permission = "ask"
Den kan læse, søge og skrive, men kan ikke køre kommandoer: bash står ikke på listen. Oprettelse af hver fil kræver din godkendelse. Prøv den på et lille modul, før du anvender den på et helt repository.
Valg af agentmodel
active_model forventer aliasset for en konfigureret model. Vibe leveres med en indbygget model, Mistral Medium 3.5, med aliaset mistral-medium-3.5. Til en anden model skal du først erklære en forudindstilling i config.toml og derefter referere til dens alias:
# ~/.vibe/config.toml
[[models]]
name = "codestral-latest"
provider = "mistral"
alias = "codestral"
# i agentfilen
active_model = "codestral"
Uden active_model bruger agenten sessionens model.
Skrivning af instrukser
Der findes to veje. instructions indeholder indlejret tekst, der tilføjes efter Vibes systemprompt: dette er den enkleste tilgang. system_prompt_id peger på en Markdown-fil i mappen prompts/, hvilket er nyttigt til lange prompts, der gennemgås i code reviews. Én adfærdsmæssig detalje er vigtig: En brugerdefineret agents prompt gælder kun, hvis du vælger den før din første besked (via --agent eller Shift+Tab). Hvis du skifter agent midt i en session, gælder dens værktøjer, tilladelser og model øjeblikkeligt, men dens prompt træder først i kraft efter /clear.
Bedste praksis
Mindste privilegium først: Giv kun en agent de værktøjer, den har brug for. En analyseagent har ikke brug for write_file; en forfatter har ikke brug for bash. Ved at fjerne hvert værktøj gør du en hel kategori af fejl umulig.
Én agent pr. ansvar derefter: En alt-i-et-fil producerer middelmådige svar overalt. Tre målrettede filer slår én generisk fil.
Præcise instrukser til sidst: Definér den nøjagtige rolle, projektkonventioner, forventet outputformat og fejl, der skal undgås. Når en agent skuffer, skyldes det næsten altid, at et af disse fire punkter mangler.
Vigtige pointer
- En brugerdefineret agent er en
.toml-fil i~/.vibe/agents/eller./.vibe/agents/; dens navn svarer til filnavnet - Nyttige nøgler:
display_name,description,instructionsellersystem_prompt_id,active_model,enabled_tools,disabled_tools,[tools.<værktøj>] - Værktøjsnavne:
read_file,write_file,edit,bash,grep,todo,task,skill,ask_user_question,web_fetch,web_search active_modelforventer et alias for en model-forudindstilling (ellermistral-medium-3.5, indbygget)- Placer
[tools.*]-blokke til sidst i filen