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

# Gaia Copilot

> The conversational AI inside every Gainable app

## What is Gaia Copilot?

Gaia Copilot is the conversational layer of every Gainable app. The user asks; the Copilot answers. It reads live app data through an MCP Server, references documents you've uploaded as knowledge, and can take action when asked.

The Copilot is reactive. It waits for a question. If you want AI that runs on its own, watches data, and drafts work without being asked, that's [Gaia Autopilot](/autopilot/overview). The two are designed to work together.

<Info>
  **Build agents vs Gaia Copilot.** Gainable uses [build agents](/concepts/agents) (Planner, Build, Validation, Conversation) to *create* your app. Gaia Copilot is different. It's a configurable assistant that lives *inside* your finished app and helps your users.
</Info>

## What Gaia Copilot can do

<CardGroup cols={2}>
  <Card title="Customer support" icon="headset">
    Answer questions using uploaded knowledge and look up live order or account data
  </Card>

  <Card title="Data analysis" icon="magnifying-glass-chart">
    Query your app data, filter results, and surface insights through conversation
  </Card>

  <Card title="Guided workflows" icon="route">
    Walk users through processes with conversation starters and step-by-step guidance
  </Card>

  <Card title="Knowledge assistant" icon="book-open">
    Reference uploaded documents like policies, playbooks, and product catalogs
  </Card>
</CardGroup>

## What Gaia Copilot does *not* do

The Copilot is reactive by design. It doesn't:

* Run on its own without being asked
* Watch your data for changes in the background
* Draft work proactively before a user opens the chat
* Send outbound emails, Slack messages, or webhooks on a schedule

That's the job of [Gaia Autopilot](/autopilot/overview). Use Copilot for "the user asks, the Copilot answers." Use Agents for "work shows up before the user asks."

## How it fits together

<Steps>
  <Step title="Build your app">
    Create your application with data models, views, and features.
  </Step>

  <Step title="Configure a Copilot">
    Describe the assistant you want. Gainable creates it with a name, instructions, and personality.
  </Step>

  <Step title="Connect to data">
    The Copilot automatically gets access to your app's data through an MCP Server. It can query, update, and insert records.
  </Step>

  <Step title="Add knowledge">
    Upload documents (PDFs, guides, policies) the Copilot can reference when answering questions.
  </Step>

  <Step title="Embed it">
    Place the `<wy-copilot>` chat interface on any page so users can interact with it.
  </Step>
</Steps>

## Capabilities

| Capability                | Description                                                     |
| ------------------------- | --------------------------------------------------------------- |
| **Chat**                  | Natural language conversation with your users                   |
| **Data access (MCP)**     | Read, update, and insert data through the MCP Server            |
| **Knowledge bases**       | Reference uploaded documents (RAG)                              |
| **Web search**            | Search the web for additional context when enabled              |
| **Conversation starters** | Pre-defined prompts that help users begin                       |
| **Datasets**              | Query data brought in via [datasets](/building/data-connectors) |

## Prompt examples

You can request a Copilot in natural language:

```text theme={null}
Create a Sales Coach Copilot that helps reps find deals,
check pipeline status, and get selling tips.
Give it access to the deals and contacts data.
Add it to the deals page.
```

```text theme={null}
Add a support assistant to the support page that can
look up customer orders and answer questions from
our FAQ document.
```

## Test for which one applies

> Does the user have to ask first?
>
> * **Yes** → Gaia Copilot
> * **No** (work shows up before they ask) → [Gaia Autopilot](/autopilot/overview)

## Learn more

<CardGroup cols={2}>
  <Card title="Configuring a Copilot" icon="sliders" href="/copilots/configuring">
    Define name, instructions, and personality
  </Card>

  <Card title="Data access" icon="database" href="/copilots/data-access">
    Connect Copilots to your app data via MCP
  </Card>

  <Card title="Knowledge bases" icon="book" href="/copilots/knowledge">
    Upload documents the Copilot can reference
  </Card>

  <Card title="Embedding" icon="message-bot" href="/copilots/embedding">
    Place the chat interface on any page
  </Card>

  <Card title="Gaia Autopilot" icon="robot" href="/autopilot/overview">
    Looking for the autonomous side? Agents run on their own
  </Card>

  <Card title="Datasets" icon="plug" href="/building/data-connectors">
    Group external data sources and attach them to your app
  </Card>
</CardGroup>