Skip to main content

Some screenshots show mcp-s.com, which some existing organizations still use. New organizations use withwillow.ai. Copy the URLs shown in your own organization.

Background agent organization settings

Settings govern every agent in the organization: which runtimes are available, and what owners and end users may do for themselves. Open Build > Background Agents and select the gear icon in the header. The page lives at /manage/background-agents/settings.

Changes are staged until you select Save Changes at the top of the page. Connecting a platform is the exception: those dialogs apply on Connect.

Agent Types​

Chooses which platforms are available when creating an agent. Enable a platform, supply its credentials where one is needed, or define a custom type. Only enabled platforms are selectable in the create dialog, so this card is the source of truth for what your organization can pick.

Agent Types settings with Willow Agents, Custom, Claude Managed Agents, Claude Tag, AWS AgentCore, Cursor Cloud Agents, kagent, Snowflake Cortex Agents, and Add custom type
Available platform cards. Enabled platforms and configured credentials vary by organization.
PlatformSetup
Willow AgentsNone. Runs on Willow's infrastructure and draws on your Willow tokens.
CustomNone.
Claude Managed AgentsSet key, an ANTHROPIC_API_KEY.
Claude TagOptional Set key, a Claude Enterprise Admin API key for managing Slack access from Willow. Each agent is connected in Claude itself — see Connect Claude Tag.
AWS AgentCoreSet credentials. See Connect AWS AgentCore for the execution role and IAM permissions.
Cursor Cloud AgentsSet key for the Cursor cloud agent platform.
Snowflake Cortex AgentsConnect with the Snowflake account and token. See Snowflake setup.
kagentConnect, the kagent controller base URL (and token if required). See Connect kagent for the SandboxAgent wiring.

Platforms that need credentials stay switched off until you supply them. See Platforms for what each runtime does.

Add a custom agent type​

Add custom type registers a runtime of your own, described as "the endpoints Willow calls to run this agent on your own platform." The dialog captures:

FieldPurpose
NameThe platform's display name, for example My Runtime.
DescriptionWhat runs the agent.
DeliveryWillow calls your platform uses configured endpoints; Your platform collects work from Willow uses pull delivery without endpoint fields.
Sync endpointCalled with the full agent snapshot when the Sync button runs.
Message endpointCalled with the prompt whenever a trigger or message fires.
Request body (under each endpoint)Optional. Willow default sends Willow's own body; Custom opens a JSON template where {{variables}} such as {{message}} or {{agent.slug}} are filled in per request. See Custom request bodies.
Auth headerThe header Willow sends the token on. Defaults to Authorization.
Bearer tokenOptional. Encrypted at rest, and sent as Bearer <token> when the header is Authorization.

With pull delivery, Sync body and Message body configure queued payloads instead of endpoint request bodies. The Bearer token must match the value configured on the runtime; it identifies the type when the runtime collects work.

Create adds the type to Agent Types. Agents on a type created this way carry the custom-managed platform value.

For registration steps, see Register a custom agent platform. The delivered payloads are in the harness delivery reference.

Custom request bodies​

Every endpoint field has a Request body control under it, set to Willow default until you change it. Switch it to Custom when your platform expects a shape of its own, and the editor opens pre-filled with Willow's body rewritten as a template:

{
"event": "{{event}}",
"agent_slug": "{{agent_slug}}",
"session_key": "{{session_key}}",
"message": "{{message}}"
}

Text outside a {{variable}} is sent literally, including constants such as a model ID or source flag.

ControlWhat it does
Insert chipsSelect a variable to drop it at the cursor. The chips list every value Willow can supply for that endpoint.
Build with AIDescribe the body your endpoint expects in plain language ("a prompt string and a thread object with an id") and Willow writes the template, wiring the variables for you. Requires Bring Your Own AI.
PreviewShows the exact JSON your endpoint receives, with sample values filled in.
Reset to defaultReturns the template to Willow's default body.
Use JSONataSwaps the template for a JSONata expression evaluated against Willow's body. For reshaping that a template cannot express, such as building arrays.

A variable used on its own as a value ("caps": "{{agent.capabilities}}") keeps its original type, so objects stay objects. A variable inside a longer string ("id": "willow:{{session_key}}") is inserted as text. A variable with no value at request time is sent as null.

Tool Assignment​

SettingEffect
Allow common toolsOwners can assign tools from the organization's shared MCP servers.
Allow custom toolsOwners can generate and assign custom tools to their agents.

Skill Assignment​

SettingEffect
Allow common skillsOwners can assign skills from the organization's shared skill catalog.
Allow custom skillsOwners can create and assign custom skills to their agents.

Credentials​

SettingEffect
Show credentials to ownersAgent owners can view access keys and create, recreate, and revoke tokens from the connect dashboard. Off by default.

End User Permissions​

SettingEffect
Allow end users to create agentsEnd users can create their own agents from the connect dashboard. Off by default.
Require approval for new agentsWhen creation is allowed, end users request agents for administrator approval instead. Nothing runs until the request is approved and the necessary connections and deployment are complete.

Save Changes applies staged organization settings.

These settings govern what agent owners and end users can do in the connect dashboard. The end-user view is documented in the user guide.

Channels​

The Channels configurations card holds organization-level messaging configuration. Set up or Manage on Slack opens its connection settings. App-configuration tokens allow Willow to create each agent's dedicated Slack app.

DeploymentWhat you do
SaaSStore Slack app-configuration tokens (optional, enables one-click app creation per agent).
HybridRegister your slack-background-agent gateway URLs if self-hosting, then store app-configuration tokens.
On-premStore app-configuration tokens. The service URL is set by your deployment (SLACK_BG_AGENT_URL).

The actual Slack app is created and installed per agent under Settings > Slack App. See Set up Slack for background agents for the full setup guide, runtime flow, and troubleshooting.

The card also has a Microsoft Teams row. Its dialog stores your organization's Azure Bot registration: the Microsoft App ID, the directory (tenant) ID, and a client secret. Unlike Slack, Teams uses one bot for the whole organization, so there's no per-agent app to create. This is a preview: agents don't answer in Teams yet. See Set up Microsoft Teams for background agents.

GitHub Apps (coding agents)​

The GitHub Apps (coding agents) card on the Git tab stores the GitHub Apps that agents use to clone and push repositories. Add one App per GitHub organization your agents work in. It appears only when Git Proxy is enabled for your organization.

Under Token permissions, Contents must be write if any agent should push or open pull requests. Leaving it at read blocks those actions for every agent even when a repository is allowlisted as write on the agent. The GitHub App itself needs matching permissions. See Git Access for Coding Agents.