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

# Pipeline notes

export const maia_0 = undefined

export const maia = "Maia";

<Info>
  This feature is available to customers on specific editions. Visit the {maia_0} [Pricing](https://www.maia.ai/pricing) page to learn more about each edition.
</Info>

As a {maia} user, you can invoke [Maia, your agentic data team](/docs/guides/maia-ai-agents-overview) to annotate your data pipelines using notes. Notes contextualize each component in your pipeline using its metadata, making collaboration clearer and easier.

You can edit notes directly in {maia} using Markdown. Standard [Markdown](https://www.markdownguide.org/) formatting applies.

***

## Video example

<p style={{textAlign: "center"}}>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/Z0McyoyVUYI?si=7rRi7_tH6c1MH9E3&enablejsapi=1" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen />
</p>

***

## Maia notes: metadata and usage

The Maia-powered note feature uses a private large language model (LLM), hosted in Matillion's own secure AWS infrastructure.

* **No customer data is sent to the large language model.** AI notes are generated using the metadata of components in a pipeline in the form of Matillion's proprietary language, "DPL"—the Data Pipeline Language. For example, the parameters of a component are included in the DPL as metadata, but the contents of your tables and files are **not** included.
* The generation of AI notes is performed in a "zero-shot" fashion, meaning the large language model is taken "as-is" and has **not** been reinforced, fine-tuned, or otherwise modified with customer data.
* Data warehouse credits are **not** consumed as part of the usage of this model.
* Secrets are externalized in a vault and are **never** sent to an AI model.

***

## Create a note using Maia

### Create a Maia note for a single component in a pipeline:

1. Right-click a component and click **Add note using Maia**.
2. If you're happy with the generated note, click **Add**. To try again, click **Refine**.
   * Click **Elaborate** to add more detail to the note.
   * Click **Shorten** to reduce the size and detail of the note.
   * Click **Regenerate** to generate a fresh note.

### Create a Maia note for multiple components in a pipeline:

1. Hold the `SHIFT` key and use left-click and drag to draw a box around the components to include in the AI note.
2. Right-click anywhere on the canvas and click **Add note using Maia**.
3. If you're happy with the generated note, click **Add**. To try again, click **Refine**.
   * Click **Elaborate** to add more detail to the note.
   * Click **Shorten** to reduce the size and detail of the note.
   * Click **Regenerate** to generate a fresh note.

***

## Edit a note

* Use the hand cursor to move a note via left-click and drag.
* Use the resize cursor to adjust the height and width of a note.
* Once a note has been added, click the contents of the note and the raw Markdown will be exposed and can be edited. Standard [Markdown](https://www.markdownguide.org/) formatting applies.
* Click the info button ⓘ above the note to visit [https://commonmark.org/help/](https://commonmark.org/help/) to learn more about Markdown.
* Click the rounded-square button to change the color of the note.
* Click the trashcan button above the note to **delete** the note.