# Leitor de Arquivos

Os Conectores de Arquivos permitem estruturar e gerenciar os conjuntos de documentos que servirão como base de conhecimento (fonte RAG) para que o Agente de IA responda de forma contextual e precisa às solicitações dos usuários.

<figure><img src="/files/T1YtMwmCv0kwTNjmOavW" alt=""><figcaption></figcaption></figure>

### 1. Visão Geral do Fluxo

O processo para liberar o acesso a documentos por um Agente segue três etapas:

1. Upload: Adicionar os arquivos na área de Artefatos > Arquivos.
2. Conector: Criar o Conector para agrupar os arquivos relevantes.
3. Relacionamento: Associar esse Conector ao Agente de IA específico.

### 2. Passo a Passo: Criação do Conector de Arquivos

A criação do Conector ocorre no Portal de Administração.

#### 2.1 Acessando a Área de Conectores

<figure><img src="/files/iMhTtCRn4P5TEJLIt2Wx" alt=""><figcaption></figcaption></figure>

1. No Portal de Administração (Artefatos), navegue até a opção Conectores.
2. Clique em "Adicionar Conector" ou no botão de criação (geralmente um ícone "+").
3. Selecione o tipo de conector: "Conector de Arquivos".

#### 2.2 Configurando o Conector

Preencha os campos obrigatórios para nomear e selecionar os documentos que farão parte deste conjunto.

<figure><img src="/files/mmEtvY9tMBU1S9KPAaho" alt=""><figcaption></figcaption></figure>

* Nome do Conector: Insira um nome claro e descritivo que identifique o conjunto de arquivos (Ex: "Regras Internas RH", "Documentação do Produto X").
* Projeto: Selecione um projeto para o seu conector.

#### 2.3 Seleção dos Arquivos

<figure><img src="/files/9xHRpiI5prwuq20Jrcnx" alt=""><figcaption></figcaption></figure>

Na seção de seleção de arquivos, você encontrará uma lista de todas pastas e documentos que foram previamente carregados na área Artefatos > Arquivos.

1. Localize e selecione os arquivos desejados que devem compor este Conector. Você pode filtrar por pasta ou usar a barra de pesquisa para encontrar documentos específicos.

<figure><img src="/files/JZIb9sfD6mBQ09mPkCXr" alt=""><figcaption></figcaption></figure>

2. Todos os arquivos selecionados serão agrupados.

#### 2.4 Finalização

1. Revise as configurações e os arquivos selecionados.

<figure><img src="/files/31URmX5ChKBfc2fKhOac" alt=""><figcaption></figcaption></figure>

2. Clique em "Salvar" para finalizar a criação do Conector de Arquivos.

> <mark style="color:$warning;">Nota: A criação do Conector não concede automaticamente permissão ao Agente. O Agente ainda precisa ser explicitamente associado a este Conector.</mark>

### 3. Passo Final: Relacionando o Conector ao Agente

Esta é a etapa crucial de governança, onde você define quais agentes podem acessar o novo conjunto de documentos.

1. Acesse a seção de Artefatos > Agentes no Portal de Administração.

<figure><img src="/files/Xk23KuDKJOyWvhDz9cTc" alt=""><figcaption></figcaption></figure>

2. Encontre ou crie o Agente de IA desejado e clique no icone de relacionamentos.

<figure><img src="/files/pWDYj5gwUh8Y0xLu1F9d" alt=""><figcaption></figcaption></figure>

3. Selecione Conectores.
4. Na lista de Conectores disponíveis, localize o Conector de Arquivos que você acabou de criar (Ex: "Regras Internas RH").

<figure><img src="/files/ivuYjPpFoEFvygnlzPdO" alt=""><figcaption></figcaption></figure>

5. Adicione ou selecione o Conector para associá-lo ao Agente.
6. Clique em "Salvar" para aplicar as alterações na configuração do Agente.

{% hint style="info" %} <mark style="color:$danger;">É importante ajustar as instruções do agente de IA para que ele saiba que existem arquivos disponíveis para consulta e os utilize como base durante as respostas.</mark>
{% endhint %}

#### ✅ Resultado Esperado

Somente após esta etapa final, quando um usuário interagir com o Agente, o modelo de IA terá permissão para buscar informações e gerar respostas utilizando exclusivamente os arquivos contidos neste Conector e em quaisquer outros Conectores relacionados.


---

# Agent Instructions: 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:

```
GET https://docs.poweromni.ai/administracao-e-configuracao/artefatos/conectores/leitor-de-arquivos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.