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

# Cookbooks

> Task-focused recipes for the AiQL tools and the ingestion pipeline

Each cookbook is a self-contained recipe you can copy and run. The tool recipes cover a single pipeline step; the ingestion recipe runs all four steps as one managed job.

## Tools

Run a single pipeline step on demand. Tool requests authenticate with a Bearer token and do not need a workspace.

<Columns cols={2}>
  <Card title="Convert" icon="file-import" href="/cookbooks/convert">
    Normalize a source document into clean text.
  </Card>

  <Card title="Split" icon="scissors" href="/cookbooks/split">
    Break converted text into smaller chunks.
  </Card>

  <Card title="Shape" icon="diagram-project" href="/cookbooks/shape">
    Infer the schema of your data.
  </Card>

  <Card title="Extract" icon="list-check" href="/cookbooks/extract">
    Pull specific fields and values out of the text.
  </Card>
</Columns>

## Pipeline

<Columns cols={2}>
  <Card title="Run a full ingestion" icon="arrow-down-to-line" href="/cookbooks/ingestion">
    Chain `convert → split → shape → extract` into one managed job and load the result into a workspace.
  </Card>

  <Card title="Query your data" icon="magnifying-glass" href="/cookbooks/query">
    Run natural-language queries over the data you have ingested into a workspace.
  </Card>
</Columns>

## Workspace

<Columns cols={2}>
  <Card title="Review source changes" icon="clipboard-check" href="/cookbooks/reviews">
    Propose source additions or removals and collect reviews before they take effect.
  </Card>

  <Card title="Connect a data source" icon="plug" href="/cookbooks/connections">
    Discover connectors, create a connection, and sync documents into a workspace.
  </Card>
</Columns>

## Embedding

<Columns cols={2}>
  <Card title="Embed React components" icon="react" href="/cookbooks/components">
    Embed Canvas, Dashboard, Chat, Knowledge Graph, Source Preview, and Presentation in your React app.
  </Card>
</Columns>

<Tip>
  Each recipe assumes your API key is in the `AIQL_API_KEY` environment variable. See [Authentication](/authentication) for details.
</Tip>