Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Opret en brugerdefineret agent i TOML

Lektion 2 af 14 Opdateret 2. november 2026 Avanceret
På denne side
  1. Ud over indbyggede agenter
  2. Nøgler i agentfiler
  3. Værktøjer, du kan navngive
  4. Første agent: Planlæggeren
  5. En dokumentationsagent
  6. Valg af agentmodel
  7. Skrivning af instrukser
  8. Bedste praksis
  9. Vigtige pointer

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øgleRolle
agent_type"agent" (standard, vælges af bruger) eller "subagent" (startes kun ved delegering)
display_name, descriptionVist navn og beskrivelse; beskrivelse er obligatorisk for en underagent
instructionsIndlejrede instrukser, der tilføjes efter systemprompten (for en underagent erstatter disse den)
system_prompt_idNavn på en Markdown-fil i ~/.vibe/prompts/ eller ./.vibe/prompts/, uden filtypenavn
active_modelAlias for den model, der skal bruges til denne agent
enabled_tools, disabled_toolsAllowlist 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
safetyKun 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, instructions eller system_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_model forventer et alias for en model-forudindstilling (eller mistral-medium-3.5, indbygget)
  • Placer [tools.*]-blokke til sidst i filen