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

# What is Context?

> Learn how context helps Ana understand your organization and provide more relevant, accurate responses

## Understanding Context

When you send a message to Ana, that message is called your **prompt**. But Ana doesn't just read your prompt—she reads a bunch of other information relevant to your data and organization. That additional information is called **context**.

<Note>
  **Think of it this way:** Your prompt is what you ask. Context is everything Ana knows about your organization, data, and preferences that helps her answer better.
</Note>

Context is the information you don't need to include in every single message, but that shapes Ana's understanding and behavior. It's the background knowledge that makes Ana's responses more relevant, accurate, and aligned with your organization's needs.

## Why Context Matters

Without context, you'd need to explain your business rules, data structure, and preferences in every conversation. Context allows you to:

* **Set it once, use it everywhere**: Define organizational knowledge that applies across all conversations
* **Customize Ana's behavior**: Shape how Ana responds based on roles, data sources, or your entire organization
* **Maintain consistency**: Ensure everyone in your organization gets responses aligned with your standards
* **Save time**: Avoid repeating the same information in every chat

## Types of Context

TextQL supports multiple types of context content:

<CardGroup cols={2}>
  <Card title="Plain Text & Markdown" icon="file-lines">
    Write context directly in the editor using plain text or markdown formatting for structure and clarity.
  </Card>

  <Card title="PDF Documents" icon="file-pdf">
    Upload PDF files containing documentation, reports, or reference materials that Ana should understand.
  </Card>

  <Card title="PowerPoint Presentations" icon="file-powerpoint">
    Share slide decks with business context, processes, or organizational information.
  </Card>

  <Card title="CSV Files" icon="file-csv">
    Provide reference data, lookup tables, or example datasets that inform Ana's analysis.
  </Card>
</CardGroup>

## How Ana Uses Context

When you chat with Ana, she automatically incorporates relevant context based on:

1. **Your organization's context**: Applies to everyone in your organization
2. **Your role**: Specific context for users with your assigned role
3. **Your active connector**: Context specific to the data source you're querying
4. **Role + Connector combination**: Highly targeted context for specific role-connector pairs

Ana seamlessly weaves this context into her understanding, so you get responses that feel personalized and informed without having to explain everything each time.

<Frame caption="The Context Library showing various context documents">
  <img src="https://mintcdn.com/textql/3ytic9CFBeCFPnQA/images/guides/context/context-library.png?fit=max&auto=format&n=3ytic9CFBeCFPnQA&q=85&s=9ac3aec36c6ca061ff91b98781a75f3d" alt="Context Library Interface" width="1640" height="971" data-path="images/guides/context/context-library.png" />
</Frame>

## Context vs. Other Features

TextQL offers several ways to customize Ana's behavior. Here's when to use each:

| Feature            | Best For                                           | Example Use Case                                                    |
| ------------------ | -------------------------------------------------- | ------------------------------------------------------------------- |
| **Context**        | Business knowledge, processes, organizational info | "Our fiscal year starts in July" or "Always format currency in EUR" |
| **Ontology**       | Standardized metrics and business logic            | Defining "Total Revenue" calculation that everyone uses             |
| **Datasets**       | Actual data files for analysis                     | Uploading a CSV of sales data to analyze                            |
| **System Prompts** | Advanced customization of Ana's personality        | Changing Ana's communication style organization-wide                |

<Tip>
  **Getting Started:** Most organizations start with organization-level context to establish basic business knowledge, then add role-specific context as needs arise.
</Tip>

## What's Next?

Ready to create your first context document? Learn how to use the context editor:

<Card title="Using the Context Editor" icon="pen-to-square" href="/core/guides/context/context-editor">
  Learn how to create, edit, and manage context documents in TextQL's native editor
</Card>

Or explore how context scoping works:

<Card title="Context Scoping" icon="layer-group" href="/core/guides/context/context-scoping">
  Understand how to apply context at different levels: organization, role, and connector
</Card>

## Related Features

<CardGroup cols={2}>
  <Card title="GitHub Integration for Context" icon="github" href="/core/guides/context/github-integration">
    Connect Ana to a GitHub repository for version-controlled, reviewable context management
  </Card>

  <Card title="System Prompt Modification" icon="terminal" href="/core/customization/prompting">
    Advanced customization of Ana's behavior through system prompt configuration
  </Card>
</CardGroup>
