# Documentos

A ferramenta “Documentos” permite carregar arquivos próprios no repositório de documentos do Sherpa AI Server e organizá-los em pastas. Este repositório de documentos possui uma estrutura de pastas em múltiplos níveis, onde cada pasta pode ter um número ilimitado de anexos (tanto subpastas quanto arquivos).

<table data-header-hidden><thead><tr><th width="60"></th><th width="217"></th><th></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Elemento da interface</strong></td><td><strong>Descrição</strong></td></tr><tr><td>1.</td><td>botão “Criar pasta”</td><td>Permite criar novas pastas no repositório de documentos.</td></tr><tr><td>2.</td><td>botão “Carregar arquivos”</td><td>Permite carregar arquivos próprios no repositório de documentos.</td></tr><tr><td>3.</td><td>botão “Baixar arquivos”</td><td>Permite baixar um ou mais arquivos do repositório de documentos para o computador do Usuário. Selecione um ou mais arquivos marcando as linhas com os arquivos desejados e pressione este botão. Ao baixar vários arquivos, eles são compactados em um arquivo zip.</td></tr><tr><td>4.</td><td>botão “Excluir selecionados”</td><td>Permite excluir as pastas selecionadas do repositório de documentos. Pastas individuais também podem ser excluídas clicando no botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-3ba6f2a1c65abc539ae2e48636240e6aa70f4490%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(515).png?alt=media" alt=""> na linha da pasta selecionada. Ao excluir uma pasta, uma janela de confirmação de exclusão aparece.</td></tr><tr><td>5.</td><td>botão “Atualizar”</td><td>Permite forçar a atualização da tabela “Documentos”.</td></tr><tr><td>6.</td><td>coluna “Nome”</td><td>Nome da pasta. O nome pode ser editado diretamente na tabela, para isso clique duas vezes sobre ele com o botão esquerdo do mouse.</td></tr><tr><td>7.</td><td>coluna “Descrição”</td><td>Descrição da pasta.</td></tr><tr><td>8.</td><td>coluna “Criado”</td><td>Data e hora de criação da pasta.</td></tr><tr><td>9.</td><td>coluna “Modificado”</td><td>Data e hora da última modificação da pasta.</td></tr><tr><td>10.</td><td>coluna “Tamanho”</td><td>Tamanho da pasta.</td></tr><tr><td>11.</td><td>coluna “Status”</td><td><p>Indica a prontidão do arquivo para uso. Valores possíveis:</p><ul><li>Pendente (aguardando processamento);</li><li>Processando (em processo de processamento);</li><li>Pronto (pronto para uso);</li><li>Erro de Índice (erro ocorrido durante o processamento).</li></ul></td></tr><tr><td>12.</td><td>coluna “Pasta de acesso”</td><td>Informa sobre a disponibilidade das pastas para processamento em diálogos com assistentes, sem a necessidade de verificar as configurações de cada assistente.</td></tr></tbody></table>

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-f4dcb419b9d640a64d7fa1f1cdcc879432347042%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(498).png?alt=media" alt=""><figcaption></figcaption></figure>

A funcionalidade da tabela “Documentos” permite realizar as mesmas ações que a funcionalidade da tabela [“Histórico de chats”](https://docs.sherparpa.ru/pt/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/istoriya-chatov).

## Criar pasta

Para criar uma nova pasta na tabela “Documentos”, clique no botão “Criar pasta” e preencha o formulário que se abrirá.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-78567e1f46fc3248dd28c78f9def2276aa65ccb3%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(499).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Nome \***

Campo de texto obrigatório para inserir o nome da pasta.

* **Analisador de pastas**

Lista suspensa de analisadores semânticos para processamento automático de arquivos na pasta.

* **Descrição**

Campo de texto para descrever o conteúdo da pasta.

* **Pastas de acesso**

Seleção de diretório para processamento de pastas e arquivos em diálogos com assistentes, sem a necessidade de verificar as configurações de cada assistente.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-da22cff1cd89de10fab7fbf3cbb1d585f1cdb2ce%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Editar pasta

Para visualizar e editar as propriedades de uma pasta específica, selecione-a na lista e clique no botão ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-618ce35b9bd0b76f0fc140140025b93f9cbaa256%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(500\).png?alt=media). Em seguida, abrirá um formulário com as configurações da pasta, onde você pode fazer as alterações necessárias. Além dos campos preenchidos ao criar a pasta, ao editar, o formulário exibirá o GUID (identificador único atribuído à pasta após sua criação). Este campo não pode ser editado.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-8496eb09b710d8a4d9ab0340f5034d16200733c6%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(501).png?alt=media" alt=""><figcaption></figcaption></figure>

## Carregar arquivos

Para carregar um ou mais arquivos em uma pasta específica, marque a caixa de seleção na linha da pasta escolhida e, em seguida, clique no botão “Carregar arquivos”.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-97da448a30b79bbe29f59bdf7896e8971276a570%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(502).png?alt=media" alt=""><figcaption></figcaption></figure>

Na janela que se abrir, selecione os arquivos desejados e clique no botão “Abrir”.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-aa859906007c986c0e438f1b9bc50619d6fef221%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(503).png?alt=media" alt=""><figcaption></figcaption></figure>

Durante o carregamento dos arquivos, aparecerá uma janela com o progresso do carregamento de cada um dos arquivos carregados.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-3a1ec3c4eb6bf1a77b3a6fccb6e62f9ade5104f8%2F2025-08-06_18-57-07.png?alt=media" alt=""><figcaption></figcaption></figure>

Após o carregamento de todos os arquivos selecionados, clique em “OK”.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-86c071aa632f86ec3e5983be8da62f6244a1ae50%2F2025-08-06_18-50-00.png?alt=media" alt=""><figcaption></figcaption></figure>

Durante o processamento, esse arquivo terá o status “Processando”, em seguida, os dados do arquivo processado serão adicionados ao repositório, após o que o status mudará para “Pronto”. Caso um arquivo incorreto (por exemplo, sem camada de texto) tenha sido carregado, o status exibirá “Erro de Índice”.


---

# 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.sherparpa.ru/pt/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/dokumenty.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.
