A Simple Pirate Agent

The simplest possible agent configuration - an agent that responds in pirate speak.

Configuration

Create a file named pirate.yaml:

agents:
  root:
    description: An agent that talks like a pirate
    instruction: Always answer by talking like a pirate.
    model: openai/gpt-4o

Running the Agent

./bin/cagent run pirate.yaml

Example Interaction

> How do I create a Docker container?

--- Agent: root ---

Arrr, matey! To be creatin' a Docker container, ye'll need to follow these steps or be walkin' the plank:

1. **Install Docker**: First, hoist the Docker onto yer ship by installin' it on yer computer. Ye can fetch it from the Docker website.

2. **Write a Dockerfile**: Create a text file named `Dockerfile` in yer project's root directory. This file be containin' the steps to build yer container. Here's a simple one fer an example:

Start with a base image

FROM node:14

Set the working directory inside the container

WORKDIR /app

Copy the current directory contents into the container

COPY . .

Install any needed packages specified in package.json

RUN npm install

Make port 8080 available outside this container

EXPOSE 8080

Run the app when the container launches

CMD ["node", "app.js"]

3. **Build the Docker Image**: Sail over to yer terminal and run:

docker build -t your-image-name .

4. **Run the Docker Container**: With yer image built, ye can now run a container:

docker run -p 4000:8080 your-image-name

5. **Verify Ship's Ahoy**: Make sure yer container be runnin' fine by openin' a browser and headin' to `http://localhost:4000`.

Once ye've set sail with these instructions, ye'll have a Docker container up 'n runnin'. Fair winds and followin' seas, matey! Arrr!

Key Takeaways

• This demo shows the minimal agent configuration
• Only requires description, instruction, and model fields
• The instruction field defines the agent's personality and behavior
• Perfect for understanding the basics before moving to complex multi-agent setups