> 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/project-knowledge-base-of-aqua-intelligence.md).
# Project Knowledge Base of aqua Intelligence
The project knowledge base lets project administrators upload files that are used exclusively **within** a **specific project**.
aqua Intelligence uses these files only when generating content or answering questions **inside** that **project** — keeping responses relevant and specific to that project's domain, terminology, and processes of each project — without affecting others**.**
### What aqua Intelligence can do with project knowledge base files
Files uploaded at the project level are only used by aqua Intelligence when:
* A user asks a question in the **aqua Intelligence Chat** within that project
* A user generates **requirements**, **test cases**, or **test data** inside that specific project
This keeps responses relevant and localized to the project’s specific domain.
#### **How to upload**
1. Navigate to **Integrations → aqua Intelligence**
2. Under **aqua Intelligence knowledge base**, click **Upload file** and select the target project
3. Upload and click **Add and Process**
Processing runs in the background. Processing status is shown directly in the interface — you will see whether a file is Processing, Ready, or has an Error.
#### **Supported file formats**
* PDF, DOCX, XLSX, Markdown, and TXT
#### **Reusing files across projects**
If the same file is relevant to multiple projects, you can reuse it without re-uploading.
To reuse a file:
1. Open the three-dot menu next to the file
2. Select **Share file**
3. Choose the projects you want to attach it to
When a file is shared across projects:
* Deleting it from one project **removes** it **only** from that project
* The file remains **active** in **all other projects** where it is in use
* To remove it completely, delete it from **every project** it is linked to
#### **Managing your files**
* Regularly review and update files to ensure aqua Intelligence is working from current, accurate material
For guidance on preparing files for best results, see [Best practices for the Knowledge Base in aqua](/documentation/aqua-intelligence/knowledge-base-with-aqua-intelligence/best-practices-for-the-knowledge-base-in-aqua.md)
---
# 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/project-knowledge-base-of-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.