Agent resources

Overview

What agent resources are and how to attach capabilities to an agent.

Agent resources are the bindings between an agent and the artifacts that shape its behavior — rules, MCP configs, skills, vaults, model selection, and integrations. Resources are how an agent gets its personality, its tools, and its secrets.

Each attachment is a small record (ccr_…) that links one agent (cci_…) to one entity (aar_…, amc_…, ask_…, vlt_…, or an integration). You can think of it as a many-to-many join: the same rule can be attached to multiple agents, and a single agent can have many rules.

How it works

  1. Create the artifact via its own API (Rules, MCP configs, Skills, Vaults).
  2. Attach it to an agent with POST /agents/{agent_id}/resources, passing the entity_type and entity_id.
  3. Redeploy the agent (or call /deploy with update_config_only: true) for the change to take effect.
  4. Detach with DELETE /agents/{agent_id}/resources/{resource_id} when no longer needed.

Supported entity types

TypeWhat it does
agent_artifact_ruleAdds a system-prompt rule (text instructions).
agent_artifact_mcp_cfgAdds an MCP server config (external tool).
agent_artifact_skillAdds a packaged skill (.skill / .zip).
vaultInjects vault secrets into the agent's environment.
github_repository_integrationGrants access to a GitHub repo.
anthropic_integrationSelects an Anthropic API account.
llm_modelPins which LLM the agent uses (for example opus-4.5, sonnet-4.6).

When to use it

  • Compose an agent's behavior from existing artifacts. Attach rules, skills, MCP configs, vaults, GitHub repos, and a model — instead of redefining capabilities per agent, mix-and-match what you've already built.
  • Swap an agent's capabilities without recreating it. Detach an outdated skill, attach a new MCP config, switch the model — then /deploy with update_config_only: true to roll the change.

On this page