List Phoenix Agents
phoenix_list_agents — discover/browse Phoenix agents & workflows available to invoke. Each row returns the agent's instance id (a UUID), name, description, allowed tools, and input schema — the id and input schema are exactly what phoenix_invoke_agent needs. These are Phoenix's own orchestration agents/workflows (e.g. an Account Research Brief that assembles a cited deliverable), NOT the raw HG data tools and NOT the org's stored artifacts. Use this when you need to discover which agents exist or look up an agent_id / its expected inputs before starting a run. Do NOT use this to query company/firmographic/technographic data (call the relevant HG data tool directly) or to browse already-produced deliverables — use phoenix_list_artifacts.
Credits
Free — No credits consumed. See the full credit table for how AI Credits work.
Parameters
This tool does not require any parameters.
Use Cases
- Discover which HG Agents an organization has published before invoking one
- Look up the agent_id (UUID) to pass to phoenix_invoke_agent
- Inspect an agent's expected input schema so you can build a valid inputs object
- Check which HG data tools a given agent is allowed to call
Example Usage
List all published agents for this org
{
"tool": "phoenix_list_agents",
"arguments": {}
}
Response Format
| Field | Type | Description |
|---|---|---|
agents | array | Published agents available to the authenticated organization |
agents[].id | string | Agent instance ID |
agents[].name | string | Agent name |
agents[].description | string | Agent description |
agents[].version | string | Current published version ID |
agents[].tools | array | Available tools |
agents[].inputs | object | Expected input schema |
count | number | Total number of agents |
Related Tools
phoenix_invoke_agent, phoenix_get_run_status, phoenix_list_artifacts, phoenix_onboarding