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

# Searchable Agent

> Get instant SEO and AEO recommendations from your AI-powered copilot

## Overview

Your AI Copilot Agent is an intelligent assistant that understands your website, business context, and SEO goals. It provides personalized recommendations and can take actions across your entire Searchable workspace.

<Info>
  The AI Copilot is available on all plans, with advanced actions unlocking on **Professional**, **Agency**, and **Custom** tiers.
</Info>

## What Your AI Copilot Can Do

<CardGroup cols={2}>
  <Card title="Analyze Performance" icon="chart-line">
    Review your visibility scores, prompt performance, and competitive position
  </Card>

  <Card title="Recommend Actions" icon="lightbulb">
    Get prioritized, context-aware recommendations based on your data
  </Card>

  <Card title="Answer Questions" icon="messages-question">
    Ask anything about your SEO, audit results, or AI visibility
  </Card>

  <Card title="Execute Tasks" icon="wand-magic-sparkles">
    Create prompts, generate content, analyze competitors, and more
  </Card>
</CardGroup>

## How to Access

Your AI Copilot is available throughout Searchable:

**From the Dashboard:**

* Click the **AI Assistant** icon in the top-right corner
* Available on any page within your workspace
* Maintains context of your current view

**From Specific Pages:**

* **Pages Tab**: Right-click any page → "Ask AI" for page-specific recommendations
* **Issues Tab**: Click any issue → "Get AI Help" for fix guidance
* **Prompts Tab**: Select prompts → "Optimize with AI" for improvement suggestions

<Tip>
  The AI Copilot learns from your knowledge base (created in Step 1 of the onboarding checklist), so train it well for better recommendations!
</Tip>

## Core Capabilities

### 1. Website Analysis

Ask your copilot to analyze any aspect of your site:

**Example questions:**

* "What are my biggest SEO issues right now?"
* "Why is my technical score low?"
* "Which pages should I optimize first?"
* "How do I improve my Core Web Vitals?"

**What it does:**

* Reviews your latest audit data
* Identifies patterns across issues
* Prioritizes by impact and effort
* Provides step-by-step fix instructions

### 2. Visibility & Competitive Intelligence

Get insights into your AI visibility and competitors:

**Example questions:**

* "How am I performing against competitors?"
* "Which prompts are getting the most mentions?"
* "Why isn't \[competitor] being cited for \[topic]?"
* "What content gaps exist in my category?"

**What it does:**

* Analyzes visibility reports across 4 AI platforms
* Compares your performance to competitors
* Identifies opportunity topics
* Recommends content strategy

### 3. Prompt Optimization

Improve your AI visibility tracking:

**Example questions:**

* "Can you analyze my prompt performance?"
* "Generate 10 new prompts for \[topic]"
* "Why aren't my prompts getting mentions?"
* "Optimize this prompt: \[your prompt]"

**What it does:**

* Reviews prompt mention rates
* Generates industry-specific prompts
* Suggests improvements to existing prompts
* Identifies zero-mention opportunities

### 4. Content Strategy

Plan and create optimized content:

**Example questions:**

* "What content should I create next?"
* "Generate a blog post about \[topic]"
* "How do I optimize my existing article on \[topic]?"
* "What keywords should I target?"

**What it does:**

* Identifies content gaps
* Generates AI-optimized articles
* Provides SEO and AEO recommendations
* Suggests internal linking opportunities

### 5. Integration Assistance

Get help with connected platforms:

**Example questions:**

* "Show me my Google Search Console data"
* "What keywords am I ranking for?"
* "Analyze my GA4 traffic from AI platforms"

**What it does:**

* Retrieves data from connected integrations
* Correlates metrics across platforms
* Provides unified insights
* Assists with publishing workflows

### 6. Technical SEO Guidance

Understand and fix technical issues:

**Example questions:**

* "Explain this issue: \[paste issue title]"
* "How do I implement structured data?"
* "What's causing my slow page speed?"
* "Walk me through fixing 404 errors"

**What it does:**

* Explains technical concepts clearly
* Provides code examples and instructions
* Estimates impact of fixes
* Offers best practices

## Advanced Features

### Context Awareness

Your AI Copilot understands:

* **Your current page**: Automatically knows where you are in the app
* **Your project**: Aware of your domain, industry, and goals
* **Your data**: Has access to all your metrics and history
* **Your knowledge base**: Trained on your brand information

### Multi-Turn Conversations

Build on previous questions:

```text theme={null}
You: "What are my critical issues?"
Copilot: [Lists 5 critical issues]

You: "Explain the first one in detail"
Copilot: [Detailed explanation with fix steps]

You: "Generate the code for that fix"
Copilot: [Provides implementation code]
```

### Available Actions

The copilot can execute tasks on your behalf:

* Create new prompts
* Generate content outlines and articles
* Run SERP analysis
* Fetch competitor data
* Analyze keyword opportunities
* Export reports

<CardGroup cols={2}>
  <Card title="Read-Only Actions" icon="eye">
    Analyze data, answer questions, provide recommendations
  </Card>

  <Card title="Write Actions" icon="edit">
    Create prompts, generate content, optimize pages (with confirmation)
  </Card>
</CardGroup>

## Copilot Tiers by Plan

| Capability                   | Starter (\$100) | Professional (\$300) | Agency (\$750) | Custom |
| ---------------------------- | --------------- | -------------------- | -------------- | ------ |
| **Basic Analysis**           | ✓               | ✓                    | ✓              | ✓      |
| **Prompt Generation**        | ✓               | ✓                    | ✓              | ✓      |
| **Content Creation**         | ✓               | ✓                    | ✓              | ✓      |
| **Integration Data**         | —               | ✓                    | ✓              | ✓      |
| **Competitor Analysis**      | —               | ✓                    | ✓              | ✓      |
| **Advanced Analytics**       | —               | ✓                    | ✓              | ✓      |
| **Batch Actions**            | —               | Limited              | ✓              | ✓      |
| **Custom Tools & Workflows** | —               | —                    | Limited        | ✓      |

## Best Practices

<Check>Start conversations with specific questions, not vague requests</Check>
<Check>Reference specific pages, prompts, or issues for targeted help</Check>
<Check>Review AI-generated content before publishing</Check>
<Check>Use copilot for second opinions on strategies</Check>
<Check>Build multi-turn conversations for complex topics</Check>

<Warning>
  The AI Copilot provides recommendations based on your data and industry best practices. Always verify critical changes before implementing, especially technical modifications.
</Warning>

## Example Workflows

### Morning SEO Check

```text theme={null}
You: "What changed overnight? Any critical issues?"

Copilot: Analyzes latest data and highlights:
- New critical issues (if any)
- Significant score changes
- Visibility improvements or drops
- Recommended immediate actions
```

### Content Planning Session

```text theme={null}
You: "I need content ideas for next month"

Copilot: 
1. Analyzes your zero-mention prompts
2. Identifies top opportunities
3. Suggests 5-10 article topics
4. Provides target keywords and structure

You: "Create an outline for the first topic"

Copilot: Generates comprehensive outline with:
- SEO-optimized headlines
- Section structure
- Internal linking suggestions
- Target word count
```

### Issue Resolution

```text theme={null}
You: "How do I fix my Core Web Vitals?"

Copilot:
1. Reviews your specific CWV metrics
2. Identifies root causes
3. Prioritizes fixes by impact
4. Provides code examples
5. Estimates score improvement

You: "Implement the first fix"

Copilot: Provides step-by-step implementation guide
```

## Privacy & Data

**What the copilot knows:**

* Your project data (scores, issues, prompts, content)
* Your knowledge base (brand info you provided)
* Your connected integration data
* Industry benchmarks and best practices

**What stays private:**

* All conversations are private to your account
* No data shared with external AI models beyond necessary processing
* Training data stays within Searchable
* You own all generated content and insights

## Conversation Management

**Chat History:**

* All conversations are saved automatically
* Access past conversations from the sidebar
* Search through conversation history
* Delete conversations anytime

**New Conversation:**

* Click "New Chat" to start fresh context
* Previous conversations remain accessible
* Each chat maintains its own context

## Limitations

The AI Copilot is powerful but has boundaries:

<Warning>
  **What it won't do:**

  * Make changes without your confirmation for write operations
  * Access websites outside your verified properties
  * Share your data with third parties
  * Guarantee specific ranking improvements (provides best practices only)
</Warning>

## Tips for Best Results

### Be Specific

**Instead of:** "Help with SEO"\
**Try:** "Why is my technical score 62 and how can I get it to 80?"

### Provide Context

**Instead of:** "Fix this issue"\
**Try:** "Explain this issue '\[paste issue title]' and show me how to fix it on a WordPress site"

### Build on Responses

**Multi-turn approach:**

1. Ask for analysis first
2. Request detailed explanation
3. Get implementation steps
4. Ask for code examples
5. Request expected impact

### Use for Planning

**Strategic questions:**

* "Create a 30-day plan to improve AI visibility"
* "What should I focus on this week?"
* "Prioritize my issues by ROI"
* "Build a content calendar for Q1"

## Getting Help

If the copilot doesn't have enough context:

* Ensure you've completed the knowledge base setup
* Verify your project is properly configured
* Check that integrations are connected (for integration data)
* Try rephrasing your question more specifically

## Next Steps

<CardGroup cols={2}>
  <Card title="Train Your Agent" icon="brain" href="https://app.searchable.com/knowledge-base">
    Update knowledge base for better recommendations
  </Card>

  <Card title="Content Generation" icon="wand-magic-sparkles" href="/using-searchable/content-generation">
    Use copilot to create optimized content
  </Card>

  <Card title="Working with Prompts" icon="messages-question" href="/using-searchable/working-with-prompts">
    Optimize prompts with AI assistance
  </Card>

  <Card title="Site Audits" icon="magnifying-glass" href="/using-searchable/site-audits">
    Get AI help fixing audit issues
  </Card>
</CardGroup>