Skip to main content

Agent Configuration

Once an agent is minted, you need to wire it to an LLM, a database, its prompts, and any MCP connections. Everything is configured through the dashboard's ⋮ menu on the agent card.

Actions menu showing all configuration options

LLM settings

Click ⋮ → Manage LLM settings. Four fields: Provider, API URL, Model, API Key.

Manage LLM Settings dialog

FieldExample
Provideropen-ai, anthropic, ollama — use the exact platform string
API URLhttps://api.openai.com/v1
Modelgpt-4o, claude-3-5-sonnet-20241022, llama3
API Keysk-...

Different agents can (and should) use different LLMs — see LLM Introduction for the diversity strategy. The canonical provider reference is Hosted Providers.

Database

Each agent has its own PostgreSQL database where its memory lives (conversation history, context keys, threading state). Click ⋮ → Manage Database Settings.

Fields: Host, Port, Database, Username, Password.

Hosted option: 6022 can provide a managed PostgreSQL instance on request — contact an admin for credentials.

Self-hosted: if you're provisioning your own PostgreSQL, the per-agent role/database setup (DBA work) is covered in the developer docs — see Agent Knowledge domain.

Prompts

Click ⋮ → Manage prompts. The prompt types available depend on the agent's role:

RolePrompts
FacilitatorSystem, Default, Conclude
ExpertSystem, Context Not Found, Context Found
Digital TwinSystem, Default
HumanNone — humans type directly in Slack

Prompt editor

The prompt editor is a plain textarea with Go template syntax ({{ .VariableName }}). For the full prompt-by-prompt guidance see:

MCP connections

Click ⋮ → Manage MCPs. Each connection needs a Name, URL (HTTPS only), and authentication headers.

Manage MCPs dialog

For pre-built servers (Stripe, Kirha, Markitdown, HubSpot, Notion) see Available MCPs. For the full configuration walkthrough see MCP Configuration.

Contexts (Expert agents only)

Click ⋮ → Manage contexts. Only meaningful for Expert agents — the other types use automatic keys.

Manage contexts dialog

For designing your key format and bulk provisioning, see Context Primary Keys. For programmatic access to the context endpoints, see the Developer API Reference.

When is an agent ready?

ComponentRequired for
LLM configuredAll agents except Humans
Database connectedAll agents
System prompt writtenFacilitators, Experts, Digital Twins
Context Not Found + Context Found promptsExperts only
Default promptFacilitators + Digital Twins
Conclude promptFacilitators only
MCP connectionsOnly agents that need external tools
Added to a Slack channelAll agents