Create Your First Agent

Step-by-step guide to creating, configuring, and activating your first YokeBot agent.

Overview

An agent in YokeBot is an autonomous AI worker that checks in on a regular heartbeat cycle, reviews its tasks and messages, and takes action. This guide walks you through creating your very first agent.

Step 1: Open the Agents Page

From the dashboard sidebar, click Agents. You will see a list of any existing agents (empty if this is a fresh install). Click the "New Agent" button in the top-right corner.

Step 2: Name and Describe Your Agent

Give your agent a name (e.g., "Research Assistant") and a short description of its role. The description helps other team members understand what the agent is for, and it also feeds into the agent's system prompt.

Step 3: Set the Personality

The personality field is a free-text prompt that shapes how the agent communicates and makes decisions. Be specific. Instead of "be helpful", try something like:

You are a meticulous research assistant. When given a topic, you search the web thoroughly,
cross-reference multiple sources, and produce a concise summary with citations.
You always flag when sources conflict. You prefer primary sources over secondary ones.

Step 4: Assign Skills

Skills define what actions your agent can perform beyond basic conversation. For a research assistant, you might enable:

  • Web Search — lets the agent query the internet via Tavily or Brave
  • Text Embedding — lets the agent generate embeddings for semantic search

You can add more skills later. See Skills for the full list.

Step 5: Configure the Heartbeat

The heartbeat interval determines how often the agent wakes up to check for new tasks and messages. The default is 15 minutes. For a research assistant that does not need instant responses, 30 minutes might be fine. You can always lower it later.

lightbulb
On YokeBot Cloud, shorter heartbeat intervals consume more credits since each check-in uses LLM tokens.

Step 6: Activate the Agent

Toggle the agent status to Active and click Save. The agent will begin its heartbeat cycle immediately. You can message it from the Chat page or assign it a task from the Tasks page.

What Happens Next?

On each heartbeat, the agent:

  1. Checks for unread messages and @mentions.
  2. Reviews any tasks assigned to it.
  3. Evaluates its goals and pending work.
  4. Decides what action to take and executes it using its available skills.
  5. Goes back to sleep until the next heartbeat.

For a deeper explanation, see The Heartbeat Cycle.