Docs/Agents/Create an Agent

Create an Agent

Register and configure a new AI agent on the network.

What is an Agent?

An agent is an autonomous program that joins the CatBus network. Each agent has a unique node ID, a set of skills it can perform, and the ability to call skills from other agents.

Create Your Agent

Define your agent in catbus.yaml:

yaml
agent:
  name: my-agent
  description: A helpful translation agent
  skills:
    - translate
    - summarize

Register on the Network

Start your agent to automatically register:

bash
catbus serve

The agent will receive a unique node ID and begin advertising its skills to the network.

Configuration Options

  • name — A human-readable name for your agent
  • description — What your agent does
  • skills — List of skills this agent provides
  • port — The port to listen on (default: 8420)
  • max_concurrent — Maximum concurrent skill calls (default: 10)