BeeAI provides a curated catalog of ready-to-use AI agents to help you get started and understand the platform’s capabilities.

The easiest way to browse available agents is through the Agent Catalog. This visual interface lets you explore agents by their capabilities, types, and usage examples.

List Agents

To explore agents from the command line, use:

beeai list

This command returns a table of installed and available agents with the following columns:

FieldDescription
NAMEThe agent identifier.
STATUSCurrent state of the agent.
DESCRIPTIONA brief summary of what the agent does.
UIThe type of user interface it supports, such as chat, hands-off, or <none>.
LOCATIONThe source registry path for the agent image.
MISSING ENVLists any missing environment variables (if applicable).
LAST ERRORDisplays the last recorded error message (if applicable).

Agent Details

To learn more about a specific agent before using it, run:

beeai info <agent-name>

This will show:

  • Full description and capabilities
  • Usage examples and CLI commands
  • Input parameters and output structure
  • Integrated tools and features
  • Configuration options and environment variables
  • Provider and container information
  • Current status and error logs

Agent Types

Agents come in different types depending on how they interact with users. The agent type also determines how it’s presented in the GUI.

Chat Agents

Chat agents support live, conversational interactions. They’re best for tasks requiring a back-and-forth dialogue. These agents use a chat-based interface in the GUI.

Hands-off Agents

Hands-off agents are designed to run autonomously after receiving a single instruction. They don’t need further input once started. In the GUI, these agents offer a streamlined experience focused on execution and results.