TownsifyDocs
Open console
Reference

Agent configuration sections

Profile, reporting, tools, triggers, actions, communications and budget fields.

Console address
/townships/:townshipId/team/agents/:agentId/configuration/:section
Console section
Township · Team
Reviewed
14 October 2026
On this page

Each section edits part of the same agent definition. Fields and YAML remain alternate editing modes. Save records the definition, and deployment makes changed behaviour live where required.

Profile

Identity, display name and responsibilities define the agent's role. The stable ID remains the key for tasks and stored definitions.

Agent configuration: profile in the Townsify console, shown with illustrative dataOpen full size
Illustrative dataAgent configuration: profile. Captured from the running console.

Reporting

Reports to and manages identify relationships with other agents. Run checks in Team → Hierarchy to compare those fields with the hierarchy.

Agent configuration: reporting in the Townsify console, shown with illustrative dataOpen full size
Illustrative dataAgent configuration: reporting. Captured from the running console.

Tools

Grants select tools and tool_config sets their permissions and provider-specific options. A grant does not create a provider credential. Credentials belong in Connections.

Agent configuration: tools in the Townsify console, shown with illustrative dataOpen full size
Illustrative dataAgent configuration: tools. Captured from the running console.

Triggers

Triggers wake an agent from a schedule, event or supported delivery. A paused agent or township suppresses triggering as well as task consumption.

Agent configuration: triggers in the Townsify console, shown with illustrative dataOpen full size
Illustrative dataAgent configuration: triggers. Captured from the running console.

Actions

Action steps configure follow-up work after a matched trigger. They run asynchronously after event work is recorded. Provider failure does not erase accepted ingress work.

Agent configuration: actions in the Townsify console, shown with illustrative dataOpen full size
Illustrative dataAgent configuration: actions. Captured from the running console.

Communications

Communications defines how the agent receives and routes supported messages. A provider channel is optional and needs its own configured connection.

Agent configuration: communications in the Townsify console, shown with illustrative dataOpen full size
Illustrative dataAgent configuration: communications. Captured from the running console.

Budget

Agent limits can restrict daily and monthly spend. Blank values remove an agent-level limit, while organisation and mission limits can still apply.

Agent configuration: budget in the Townsify console, shown with illustrative dataOpen full size
Illustrative dataAgent configuration: budget. Captured from the running console.

Need more help?

Open Mysaria from the console header to ask about the page you're on, or send work to an agent in your township.