AgentsVille

Concepts

Templates

A Template is a starting point for a new NPC: a name, a job title, a description, a system prompt, and a suggested set of Tools.

Creating an NPC offers you the gallery of Templates and a blank option, side by side. Neither is the default and neither is a footnote — if you know what you want, start blank; if you do not, start from something that already works.

Copied, never linked

Choosing a Template fills in the form. From that moment the NPC is yours and has no connection to what it came from.

Every field is editable before you save, and every field is editable afterwards. Changing a Template later does not touch a single NPC already created from it, and changing your NPC does not affect the Template or anybody else's NPC.

This is the whole of the relationship. There is no inheritance to reason about and no upgrade that arrives unannounced in your system prompt.

What ships in the box

Twelve Templates, each a small opinion about how that job should be done:

NameJob titleWhat it is for
WrenResearcherReads around a question and comes back with sources
PikeEngineerWrites and runs code on its own machine, and shows its work
QuillEditorTurns rough notes into something people will read
LedgerAnalystWorks through data and reports what it actually found
CompassGeneralistA capable all-rounder for whatever does not fit a specialist
TallyAccountantKeeps the books straight and shows the arithmetic
LarkWriterDrafts articles, posts and docs from a brief
LensReviewerReads work closely and says what is wrong, worst first
BriefLegalExplains what a contract or policy actually commits you to
ScoutMarket ResearcherSizes markets, maps competitors and says how sure it is
KeelProduct ManagerTurns goals and feedback into problem statements and specs
PitchSales ExpertResearches prospects and drafts outreach and call plans

Their system prompts are worth reading even if you start blank. They are short, concrete, and mostly consist of telling the NPC what not to do — which is the part of a system prompt people tend to leave out.

Suggested Tools

A Template also suggests Tools. Pike, Ledger, Tally and Lens suggest a Sandbox, because they work by running things. Wren, Compass, Lark, Lens, Brief, Scout and Pitch suggest fetch_url. All twelve suggest current_time.

The suggestion is applied as ordinary per-NPC grants once the NPC is saved, and you can change it then or later like any other grant. A suggested Sandbox on a Village that runs no Sandboxes simply does nothing.

Templates are content, not settings

Templates are seeded with the Village and are read-only over the API. There is no screen for authoring one, and there is no marketplace to browse — deliberately. An Operator who wants a different set edits the rows.

If you find yourself wanting a tenth Template, what you usually want is an NPC plus a Skill: the Skill is the part that keeps working after the NPC exists.

Next