# 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FrJtgoDY3K8rblCwbr382%2Fimage.png?alt=media&#x26;token=7c8d5d84-a959-44ec-aa3f-2db046b5578e" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2Fn5CfEBBVKuEa955epjNu%2Fimage.png?alt=media&#x26;token=3ac593c5-12f8-4924-880c-6386a797bf62" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2Fq0uupejL6EssaZB85pKJ%2Fimage.png?alt=media&#x26;token=93952854-8ff8-436a-a181-058c8620ea85" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FUrQeuX1gurmOWMNinFB8%2Fimage.png?alt=media&#x26;token=c3b97f0d-e2c3-4611-a702-33b74aa4671f" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F1Yfa6zPXJtkHVTGEOben%2Fimage.png?alt=media&#x26;token=0b96edb9-2c78-4f04-ba4b-75eaa00922bc" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FPmp7AW3m57pFNqOQRULI%2Fimage.png?alt=media&#x26;token=18307c90-3b67-4e3c-8d24-36f932c6023a" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F3YNHuJo2Pi6nwHJAZ4eu%2Fimage.png?alt=media&#x26;token=9b157a24-149e-43ab-b3c9-bbdd116ebb54" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FmKzwdWbkow5A56UaJSQm%2Fimage.png?alt=media&#x26;token=3ec5ffeb-d14c-4d7e-ac2e-c056bdb2d768" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FKz9tep8RrMcCZeJ5iVCN%2Fimage.png?alt=media&#x26;token=249c408a-89b2-4b0b-b176-bed8909e4235" 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.