> For the complete documentation index, see [llms.txt](https://docs.aqua-cloud.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aqua-cloud.io/documentation/aqua-intelligence/knowledge-base-with-aqua-intelligence.md).
# Knowledge Base with aqua Intelligence
The knowledge base lets you upload your own documents so aqua Intelligence generates outputs tailored to your product, terminology, and domain — instead of relying on general AI knowledge alone.
### What is the knowledge base?
aqua Intelligence is smart — but it doesn’t know your internal terminology, standards, specifics or what your team agreed last quarter. When you upload files to the knowledge base, it uses those documents as an additional source of context when generating requirements, test cases, test data, and chat responses.
This is called **grounding** — you are giving aqua Intelligence a foundation of your own material to work from.
{% hint style="info" %}
The more relevant your uploaded files, the more accurate and tailored the outputs become.
{% endhint %}
### What can AI do with grounded knowledge?
For example, aqua Intelligence can:
* Write **requirements** and **test cases** that match your industry standards, internal processes, or product specifics
* Use your project terminology and phrasing instead of generic wording
* Answer questions in **aqua Intelligence chat** using your uploaded **documents** as a **source of truth**
Whether you work in medical, finance, insurance, or tech — AI will reflect *your world*, not someone else’s.
### **How it works?**
You can upload documents and reference material at two levels:
* **Global knowledge base** — files are available across all projects in your workspace [Global Knowledge Base of aqua Intelligence](/documentation/aqua-intelligence/knowledge-base-with-aqua-intelligence/global-knowledge-base-of-aqua-intelligence.md)
* **Project knowledge base** — files are scoped to a specific project only [Project Knowledge Base of aqua Intelligence](/documentation/aqua-intelligence/knowledge-base-with-aqua-intelligence/project-knowledge-base-of-aqua-intelligence.md)
This allows you to give aqua Intelligence the right context depending on your use case and project.
You stay in full control — AI never scans your project data automatically. It only uses what you’ve explicitly uploaded in the **AI knowledge base** section.
### **Is it secure?**
Yes. Files are only used for generating responses during your session. They are:
* Not used for AI model training
* Not accessed unless uploaded
* Respect your project permissions and visibility
You can remove or replace files anytime.
{% hint style="info" %}
**File support and future plans**
Currently, you can upload documents in:
* PDF, DOCX, XLSX, Markdown, and TXT
We're also exploring the possibility of **company-defined templates**, which would allow aqua Intelligence to generate requirements and test cases in a format that follows your internal standards and formatting.
{% endhint %}
### Access and trial periods
We want every team to be able to explore the knowledge base and see the value it brings.
* **Public cloud users**\
the knowledge base is free to use during beta. You can integrate it into your daily work at no extra cost for now. Pricing will be announced well in advance.
* **Private cloud users**\
a **one-month trial** is available upon request. Private cloud knowledge base requires dedicated infrastructure and data isolation, which carry additional costs. For a tailored offer, contact your Customer Success manager.
### How to get access
If you’d like to use knoweldge base, simply:
* Reach out to our **Customer Success team**, or
* Fill out our [**request form**](https://tally.so/r/mYvXB6)
Once approved, you can start uploading files and using the knowledge base right away.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.aqua-cloud.io/documentation/aqua-intelligence/knowledge-base-with-aqua-intelligence.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.