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

# Context Extractor

Context Extraction is a feature within WisdomAI's Adaptive Context Engine (wACE) that helps you build your Domain's context by using existing documentation. By uploading files like dbt YAML, internal docs, PDFs, or query logs, the Context Extraction tool proposes reviewable suggestions tailored to your data. You stay in control by accepting, rejecting, or editing suggestions before anything is published.

This guide will walk you through the steps to upload your files, extract metadata, and review the resulting suggestions.

## How it works

The process follows three stages to ensure all metadata is verified before it is added to your Domain.

<Steps>
  <Step icon="upload" title="Upload">
    Upload files directly from your **Domain** page. You can optionally provide a short prompt to steer what the system should focus on during the context extraction.
  </Step>

  <Step icon="wand-magic-sparkles" title="Extract">
    WisdomAI analyzes the content and proposes structured items like descriptions, metrics, joins, and business context. When possible, WisdomAI validates these suggestions, for example, by utilizing a test SQL execution.
  </Step>

  <Step icon="check-double" title="Review and Publish">
    Review all proposed changes in the **Suggestions** experience. Compare the suggestion side-by-side with the source file to ensure accuracy. You can choose to **Accept**, **Reject**, or **Edit** any item before publishing it to your knowledge base.
  </Step>
</Steps>

<video src="https://mintcdn.com/wisdomai/cA9ZfVEI_t0xDLQR/videos/context-extractor-video.mp4?fit=max&auto=format&n=cA9ZfVEI_t0xDLQR&q=85&s=43430e8e2b9af55cc3db0ba4f5355f09" controls={true} data-path="videos/context-extractor-video.mp4" />

<Note>
  This feature reduces manual entry and helps standardize definitions across teams while keeping you in control through a review-first workflow. It also improves trust with source attribution by showing exactly which part of your documentation generated a suggestion.
</Note>

## Extracted metadata types

Context Extraction identifies the following categories of information:

| Item Type        | Description                                       |
| :--------------- | :------------------------------------------------ |
| Descriptions     | Table and column definitions.                     |
| Metrics          | Metric definitions and associated SQL.            |
| Joins            | Relationships and join logic between tables.      |
| Business Context | Rules, definitions, conventions, and SQL hints.   |
| Reviewed Queries | Example question-to-SQL pairs for model training. |

## Supported file types

You can use various files to provide context, including:

* **YAML Files:** Such as dbt-style configurations.
* **LookML:** Looker modeling files.
* **Unstructured Documents:** PDFs and text files.
* **Query Logs:** Historical SQL records.

## Target users

The context extractor feature is available to:

* **Data Admins** who manage and curate trusted domain knowledge (descriptions, metrics, joins, and definitions).
* **Explorers** who rely on accurate context to ask better questions and interpret results with confidence.

## FAQs

<AccordionGroup>
  <Accordion title="Does anything get published automatically?">
    No. Extracted items remain as suggestions until an admin clicks **Accept** in the Suggestions experience.
  </Accordion>

  <Accordion title="Where do I review suggestions?">
    Suggestions are located in the **Knowledge** tab of your Domain. Each entry shows the specific source content used for the extraction.
  </Accordion>

  <Accordion title="Can I guide the extraction?">
    Yes. During the upload step, you can use the prompt field to tell Wisdom exactly what metadata to look for.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card icon="sitemap" href="/setting-up-wisdom-ai/advanced-data-modeling-creating-context" title="Advanced Data Modeling">
    Learn how to manually create relationships and context.
  </Card>

  <Card icon="layer-group" href="/setting-up-wisdom-ai/manage-domains/understand-domains" title="Understand Domains">
    Explore how to organize your data logic using Domains.
  </Card>
</CardGroup>