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

# Kadoa Assistant

> Change and debug your workflows by chatting in natural language

The **Kadoa Assistant** builds your workflows and keeps maintaining them. Once a workflow exists, open the chat any time to change how it works or debug a run that came out wrong. For the first build see [Getting Started](/docs/ui/getting-started); for writing the extraction prompt see [Prompts](/docs/workflows/prompts).

## Open the Assistant

On a workflow built with the Assistant, open it and click **AI assistant**. The chat opens with the workflow in context, so you can get straight to the problem.

Each workflow has one Assistant chat. If a teammate already opened it, you join the same conversation.

## Debug with the Assistant

Debugging is a conversation. Describe what is wrong, and the Assistant investigates, makes the change, and reruns a sample so you can confirm the fix before anything goes live.

<Steps>
  <Step title="Describe the problem">
    Say what is wrong and what you expected, for example *"The salary field is empty on most rows, but the postings show a salary near the title."*
  </Step>

  <Step title="Let it investigate and change">
    The Assistant looks into the workflow, adjusts the extraction, schema, navigation, or transformation, and reruns a sample preview. It tells you what it changed as it works.

    <img noZoom src="https://mintcdn.com/kadoa/vSlRUAnAzL74Ur7q/images/assistant/build.png?fit=max&auto=format&n=vSlRUAnAzL74Ur7q&q=85&s=2c70780a6928c74f51da263c79b2dbe8" alt="The Kadoa Assistant working through its plan and narrating each step" width="3446" height="2056" data-path="images/assistant/build.png" />
  </Step>

  <Step title="Review the sample">
    Check the updated rows.

    <img noZoom src="https://mintcdn.com/kadoa/vSlRUAnAzL74Ur7q/images/assistant/sample.png?fit=max&auto=format&n=vSlRUAnAzL74Ur7q&q=85&s=cd7bea5d82d61e7c2369835cc8f0bb0d" alt="The review state: a table of sample rows with Approve, Rerun, and Report problem actions, and a note that no quota is used until you approve" width="3472" height="2066" data-path="images/assistant/sample.png" />
  </Step>

  <Step title="Approve or keep refining">
    If the sample looks right, approve to apply the change. If not, reply with what is still off and the Assistant reruns. Repeat as many times as you need.
  </Step>
</Steps>

The Assistant can investigate and fix issues across the whole workflow:

| If you see...                                           | Ask the Assistant to...                                                                                                                        |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| A field that is empty or wrong                          | Find the value on the page and extract it correctly                                                                                            |
| Rows missing or pagination stopping early               | Keep paginating until there are no more results                                                                                                |
| A run that looks stale or returned too little           | Look into why and fix it                                                                                                                       |
| Output in the wrong format                              | Normalize a field, for example dates to `YYYY-MM-DD`                                                                                           |
| A source that started returning blocked or empty pages  | Investigate the access issue and adapt                                                                                                         |
| The wrong fields, schedule, alerts, or monitored fields | Change the schema, [schedule](/docs/ui/workflows/scheduling), [notifications](/docs/ui/notifications), or [monitoring](/docs/change-detection) |

For automatic checks on every run instead of spot-fixing, add [Data Quality](/docs/ui/data-quality) rules.

## What to say

Brief the Assistant like a colleague: lead with the symptom and the result you expect, and name the field, the page, and what the correct value should look like. The same advice as [writing a good prompt](/docs/workflows/prompts) applies.

| Vague                 | Specific                                                                                                                |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| "The data is broken." | "Since yesterday the `price` field is null on every row. The source still shows a price on each product page."          |
| "Get more data."      | "Open each fund profile and extract name, strategy, AUM, and inception date. Continue until there are no more results." |
| "Fix the dates."      | "`published_date` comes back as free text like 'June 3, 2026'. Normalize it to YYYY-MM-DD."                             |

<Tip>
  Type `@` in the chat to reference a saved [variable](/docs/workflows/variables) or [template](/docs/ui/templates), for example a login value or a known source pattern.
</Tip>

## When the Assistant can't fix it

The Assistant tells you and automatically hands the issue to [Kadoa support](/docs/support-center). For how failed runs are classified and auto-recovered, see [Error Handling](/docs/workflows/error-handling).

## Next steps

<CardGroup cols={2}>
  <Card title="Prompts" icon="message" href="/docs/workflows/prompts">
    Write prompts that get the best results
  </Card>

  <Card title="Human-in-the-Loop" icon="user-check" href="/docs/ui/workflows/human-in-the-loop">
    Review and approve data before it goes live
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/docs/workflows/error-handling">
    Understand failures and recovery
  </Card>

  <Card title="Data Quality" icon="check-double" href="/docs/ui/data-quality">
    Validate every run with per-field rules
  </Card>
</CardGroup>