List Agents Command

The agent list command displays all AI Agents registered in your organization.

Usage

xpander agent list [--format <format>] [--filter <status>]

Options

OptionDescription
--format <format>Optional. Output format: table (default), json, or wide
--filter <status>Optional. Filter by status: active, inactive, all

Examples

Default List View

xpander agent list

Response:

ID          NAME              STATUS    TOOLS    INTERFACES
agent_123   Support Agent     Active    3        Slack, Web
agent_456   Analytics Bot     Active    5        Teams
agent_789   Data Processor    Inactive  2        None

JSON Format

xpander agent list --format json

Response:

{
  "agents": [
    {
      "id": "agent_123",
      "name": "Support Agent",
      "status": "active",
      "tools": ["notion", "slack", "calendar"],
      "interfaces": ["slack", "web"],
      "last_active": "2024-02-19T13:45:23Z"
    },
    // ... more agents
  ]
}

Filter Active Agents

xpander agent list --filter active

Notes

  • The list is sorted by last activity time by default
  • The wide format includes additional details like creation date and last activity
  • Use xpander agent details <agent_id> for more information about a specific agent