> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/en/administration-and-configuration/artifacts/connectors/file-reader.md).

# File Reader

File Connectors allow you to structure and manage document sets that will serve as a knowledge base (RAG source) so that the AI Agent can respond contextually and accurately to user requests.

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FGEDeErvKBSnniI28yyfy%2Fimage.png?alt=media&amp;token=825c7335-93fb-4092-915e-d2ad557bd501" alt=""><figcaption></figcaption></figure>

### 1. Workflow Overview

The process to grant an Agent access to documents follows three steps:

1. **Upload:** Add files in **Artifacts > Files**.
2. **Connector:** Create the Connector to group the relevant files.
3. **Relationship:** Associate this Connector with the specific AI Agent.

### 2. Step by Step: Creating the File Connector

The Connector is created in the Administration Portal.

#### 2.1 Accessing the Connectors Area

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FGgSY3gwfNGmIwrov3n4A%2Fimage.png?alt=media&amp;token=cd780311-87a2-4b87-be96-64ee839ecf26" alt=""><figcaption></figcaption></figure>

1. In the Administration Portal (**Artifacts**), navigate to **Connectors**.
2. Click **"Add Connector"** or the create button (usually a "+" icon).
3. Select the connector type: **"File Connector"**.

#### 2.2 Configuring the Connector

Fill in the required fields to name and select the documents that will be part of this set.

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FOY4aURE6GNuZOlrV0PQ8%2Fimage.png?alt=media&amp;token=497cce16-fccc-4e29-b434-210d2acb0292" alt=""><figcaption></figcaption></figure>

* **Connector Name:** Enter a clear and descriptive name that identifies the file set (Ex: "HR Internal Policies", "Product X Documentation").
* **Project:** Select a project for your connector.

#### 2.3 Selecting Files

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FYlMoBBMIjBgCxktkFk4C%2Fimage.png?alt=media&amp;token=095cbebf-87a6-4bdc-aef7-38166e888107" alt=""><figcaption></figcaption></figure>

In the file selection section, you will find a list of all folders and documents previously uploaded in **Artifacts > Files**.

1. Locate and select the desired files that should compose this Connector. You can filter by folder or use the search bar to find specific documents.

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FA4rZVaVvFVuimvwhcRid%2Fimage.png?alt=media&amp;token=fe3c95a4-bbbe-4c53-a204-2d39e0c03947" alt=""><figcaption></figcaption></figure>

2. All selected files will be grouped together.

#### 2.4 Finalization

1. Review the settings and selected files.

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FTGnBvkinHT2r4j9yYRHS%2Fimage.png?alt=media&amp;token=51b9b81b-55c1-4841-ad40-ef2970876f27" alt=""><figcaption></figcaption></figure>

2. Click **"Save"** to complete the creation of the File Connector.

{% hint style="info" %}
**Note:**&#x20;

Creating the Connector does not automatically grant permission to the Agent. The Agent must still be explicitly associated with this Connector.
{% endhint %}

### 3. Final Step: Linking the Connector to the Agent

This is the crucial governance step, where you define which Agents can access the new document set.

1. Go to **Artifacts > Agents** in the Administration Portal.

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2F7YJtHUYy45zV4jIP9BJ3%2Fimage.png?alt=media&amp;token=de0e1ac9-77b9-4d35-a32a-fc7d814d2a4a" alt=""><figcaption></figcaption></figure>

2. Find or create the desired AI Agent and click the relationships icon.

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2F1rwaiwewWEBM5fJSVFtc%2Fimage.png?alt=media&amp;token=4304013b-3ebc-475e-87ea-2103f7ef3328" alt=""><figcaption></figcaption></figure>

3. Select **Connectors**.
4. In the list of available Connectors, locate the File Connector you just created (Ex: "HR Internal Policies").

<figure><img src="https://2766970846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJWhplbeIb2veyNAuiGia%2Fuploads%2FO1ICQ9hX7V0Xv2BZBDRr%2Fimage.png?alt=media&amp;token=7236f8ae-7876-4f79-b686-427d21cfc799" alt=""><figcaption></figcaption></figure>

5. Add or select the Connector to associate it with the Agent.
6. Click **"Save"** to apply the changes to the Agent configuration.

{% hint style="info" %}
It is important to adjust the AI Agent’s instructions so that it is aware that files are available for consultation and uses them as the basis for its responses.
{% endhint %}

#### ✅ Expected Result

Only after this final step, when a user interacts with the Agent, will the AI model have permission to retrieve information and generate responses using exclusively the files contained in this Connector and any other related Connectors.