agent_search

Overview

Searches for agents configured in the organization. Returns agent metadata including purpose and capabilities.

Availability

• Tasks: ✓ Available
• Subtasks: ✗ Not available

Signature

 agent_search(search_term?: string) 

Parameters

Returns

Array of agent definitions with:

• agent_id: Unique identifier for the agent
• name: Human-readable agent name
• purpose: What the agent is designed to do
• capabilities: List of capabilities the agent has

Behavior

• Returns agents configured in the organization
• Empty search returns all available agents
• Agent metadata includes purpose and capabilities
• Use with subtask_run to delegate work to specific agents

Example Usage

 // Search for all agents
agent_search()

// Search for deployment agents
agent_search("deploy")

// Search for code review agents
agent_search("review") 

Related

• subtask_run - Spawn subtask with specific agent
• Built-in Tools Overview