> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relixir.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Setup

> Create your first AI agent to discover topics and generate content

## Onboarding Steps

1. Create Agent(s) based on your goals (Required)
2. Update Agent(s) with additional guidelines (Optional)

***

## Overview

**Agents are how Relixir decides what content to create and refresh to hit your SEO/GEO goals.**

* Each agent is tied to a goal you have — ranking for specific keywords or beating a specific competitor
* Agents are triggered every week by default and propose the most impactful actions to take
* Agents take progress snapshots on a weekly cadence to track improvement for the defined goal

Creating new blog content that is SEO/GEO optimized and refreshing your old content are the primary actions you can take to optimize your visibility on AI Search and Google. Our agents cover both.

***

## Video Walkthrough

<Info>
  Video walkthrough coming soon. In the meantime, follow the step-by-step guide below.
</Info>

***

## Required Steps

### Step 1: Go to the Agents Page

Navigate to:

```
https://app.relixir.ai/dashboard/agents
```

### Step 2: Create a New Agent

Click **+ New Agent** to trigger the agent creation pop-up.

### Agent Creation Form

| Field                 | Description                                                       |
| --------------------- | ----------------------------------------------------------------- |
| **Name**              | A descriptive name for the agent (e.g., "Competitor - Acme Corp") |
| **Goal Type**         | Choose between Keyword-focused or Competitor-focused              |
| **Target Keywords**   | (If keyword-focused) The keywords you want to rank for            |
| **Target Competitor** | (If competitor-focused) The competitor you want to outrank        |
| **Topic Count**       | How many topics to propose per week                               |
| **Auto-Approve**      | Whether to auto-generate blogs from proposed topics               |

### Step 3: Submit the Form

Fill in the form based on your goals and press **Create Agent**.

The agent will show up on the agent list on the Agents page. Expand it to view more details.

***

## What You'll See in an Expanded Agent

When you expand an agent, you'll see:

<CardGroup cols={1}>
  <Card title="Top 5 Actions" icon="bolt">
    Actions proposed by that agent you can act on right away:

    * Deploy blog to CMS
    * Approve proposed topic
    * Review content refresh proposal
  </Card>

  <Card title="Goal Performance Tracking" icon="chart-line">
    KPI metrics tied specifically to that Agent's goals:

    * Mention rate for keywords the agent is targeting
    * Google traffic (impressions) driven from the agent's actions
  </Card>

  <Card title="Custom Action Buttons" icon="play">
    Trigger actions on-demand:

    * **Trigger Topics** — Generate new topic proposals
    * **Create Blog** — Generate a blog from a topic
    * **Refresh Content** — Propose content refreshes
  </Card>
</CardGroup>

<Info>
  Each action takes time to execute — anywhere from 5-20 minutes. You will receive an email once it's completed.
</Info>

***

## Optional Steps

### Edit Agent Settings

1. Click on the vertical ellipsis (⋮) in an agent's row
2. Select **Edit Agent** to open the editing form

### Additional Settings

When editing, you can configure:

| Setting              | Description                                                                                     |
| -------------------- | ----------------------------------------------------------------------------------------------- |
| **Agent Guidelines** | Specific guidelines for this agent around topics, content, or sources to use (natural language) |
| **Blog Types**       | Narrow to specific content types (by default, all types are proposed)                           |
| **Pause Agent**      | Temporarily pause weekly snapshots and actions without deleting                                 |

***

## Agent Types

### Keyword-Focused Agents

Target specific keywords you want to improve rankings for:

* Low-performing but high-intent keywords (your "low-hanging fruit")
* Keywords where competitors are winning
* Keywords for new products or features

### Competitor-Focused Agents

Target specific competitors you want to outrank:

* Key competitors you're losing deals to
* Competitors with strong AI search presence
* Emerging competitors in your space

***

## Best Practices

<Steps>
  <Step title="Start with 3-4 Agents">
    Most teams start with 3-4 active agents, each focused on a different goal
  </Step>

  <Step title="Let Agents Run 1-2 Months">
    Give agents time to produce content and show results before adjusting
  </Step>

  <Step title="Review Weekly">
    Check agent proposals weekly and deploy content consistently
  </Step>

  <Step title="Rotate Based on ROI">
    After 2-3 months of strong performance, reduce topic count and spin up new agents for new initiatives
  </Step>
</Steps>

***

## Troubleshooting

<Accordion title="Agent isn't proposing topics">
  * Check that the agent is not paused
  * Ensure the agent has a valid goal (keywords or competitor)
  * Wait for the weekly run cycle to complete
</Accordion>

<Accordion title="Topics seem off-brand">
  * Review and update your Brand Guidelines
  * Add specific guidelines to the agent's settings
  * Provide feedback by rejecting topics with a reason
</Accordion>

<Accordion title="How do I delete an agent?">
  Click the vertical ellipsis (⋮) on the agent row and select **Delete Agent**. This cannot be undone.
</Accordion>