Skip to main content

​
What it does

The Manage Agents tool gives agents awareness of the other agents in their organization. Agents can list all available agents, create new ones, and update existing configurations — all through a single tool with an action parameter. This is especially powerful when paired with Call Agent: an agent can discover what’s available, then make an informed decision about which agent to delegate to.

​
Key features

  • Discover agents: List all agents in the org with their names, IDs, descriptions, tools, tags, and stage
  • Create agents: Build new agents with a name, system prompt, model, and tools — no UI needed
  • Update agents: Modify an existing agent’s description, system prompt, model, tools, or stage
  • Self-awareness: The calling agent is marked with isCurrentAgent: true in list results

​
Parameters

ParameterTypeRequiredDescription
actionstringYes"list", "create", or "update"
namestringNoFilter for list — case-insensitive regex match on agent name
stagestringNoFilter for list, or set stage on update. Values: "development" or "released"
targetAgentIdintegerFor updateThe ID of the agent to update
agentNamestringFor createName of the new agent
descriptionstringNoAgent description (for create / update)
systemPromptstringNoSystem prompt / instructions (for create / update)
modelstringNoModel ID, e.g. "claude-sonnet-4-20250514" (for create / update)
toolNamesstring[]NoArray of tool names to assign, e.g. ["search_google", "scrape_url"] (for create / update)
showInChatbooleanNoWhether the agent appears in the chat dropdown. Defaults to true

​
Common use cases

​
Agent discovery for call_agent

“What agents are available in our org that I could delegate research tasks to?” The agent lists all agents, inspects their tools and descriptions, and recommends the best fit before calling it.

​
Dynamic agent creation

“Create a new agent called ‘Daily Digest Bot’ that uses search_google and send_email to compile daily news summaries” The agent creates a fully configured agent — ready to use immediately in development stage.

​
Updating agent configuration

“Add the execute_python tool to agent 42 and update its description” The agent updates the target agent’s tools and metadata. Existing tool configs (like callable agent IDs) are preserved when tools are updated.

​
Self-replicating workflows

An orchestrator agent can create specialized sub-agents on the fly, configure them with the right tools and prompts, then call them via call_agent — all in a single conversation.

​
How tool assignment works

When creating or updating agents, pass tool names as simple strings in the toolNames array. The platform automatically:
  • Resolves each name to its full schema definition
  • Adds companion tools (e.g., search_knowledge_base automatically adds read_kb_file and list_kb_files)
  • Preserves existing tool-specific configs (like callableAgentIds) on update
  • Validates tool names and returns an error for any unrecognized tools

​
What you get back

​
List response

{
  "status": "success",
  "content": {
    "totalAgents": 12,
    "agents": [
      {
        "id": 38,
        "name": "Research Assistant",
        "description": "General-purpose research agent",
        "model": "anthropic:claude-sonnet-4-6",
        "stage": "released",
        "tools": ["search_google", "scrape_url", "ask_web"],
        "tags": [{"id": 2, "name": "Research"}],
        "isCurrentAgent": true
      }
    ]
  }
}

​
Create / Update response

{
  "status": "success",
  "content": {
    "id": 510,
    "name": "Daily Digest Bot",
    "description": "Compiles daily news summaries",
    "model": "claude-sonnet-4-20250514",
    "stage": "development",
    "tools": ["search_google", "send_email"],
    "message": "Agent \"Daily Digest Bot\" created successfully (ID: 510)"
  }
}

​
Best practices

  • List before you call: Use action: "list" to discover agent names and IDs before using call_agent, rather than guessing
  • New agents start in development: Created agents always start in development stage — promote to released via update when ready
  • Tool names from existing agents: If you’re unsure which tool names are valid, list an existing agent to see its tool names
  • Preserve tool configs on update: When updating tools, the platform preserves existing configs (like callableAgentIds) for tools that remain in the set
  • Call Agent - Call other agents after discovering them with manage_agents
  • Schedule Task - Schedule recurring tasks on agents you’ve created
  • Load Skill - Load specialized skills into agents