# Documents

The "Documents" tool allows you to upload your own files to the Sherpa AI Server document storage and organize them into folders. This document storage features a multi-level folder structure, where each folder can have an unlimited number of attachments (both subfolders and files).

<table data-header-hidden><thead><tr><th width="60"></th><th width="217"></th><th></th></tr></thead><tbody><tr><td><strong>No.</strong></td><td><strong>Interface Element</strong></td><td><strong>Description</strong></td></tr><tr><td>1.</td><td>"Create Folder" button</td><td>Allows you to create new folders in the document storage.</td></tr><tr><td>2.</td><td>"Upload Files" button</td><td>Allows you to upload your own files to the document storage.</td></tr><tr><td>3.</td><td>"Download Files" button</td><td>Allows you to download one or more files from the document storage to the User's computer. Select one or more files by checking the boxes in the rows with the desired files and click this button. When downloading multiple files, they are packaged into a zip archive.</td></tr><tr><td>4.</td><td>"Delete Selected" button</td><td>Allows you to delete selected folders from the document storage. You can also delete individual folders by clicking the <img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%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=""> button in the row of the selected folder. When deleting a folder, a confirmation window appears.</td></tr><tr><td>5.</td><td>"Refresh" button</td><td>Forces a refresh of the "Documents" table.</td></tr><tr><td>6.</td><td>"Name" column</td><td>The name of the folder. The name can be edited directly in the table by double-clicking on it with the left mouse button.</td></tr><tr><td>7.</td><td>"Description" column</td><td>The description of the folder.</td></tr><tr><td>8.</td><td>"Created" column</td><td>The date and time the folder was created.</td></tr><tr><td>9.</td><td>"Modified" column</td><td>The date and time of the last modification of the folder.</td></tr><tr><td>10.</td><td>"Size" column</td><td>The size of the folder.</td></tr><tr><td>11.</td><td>"Status" column</td><td><p>Indicates the readiness of the file for processing. Possible values:</p><ul><li>Pending;</li><li>Processing;</li><li>Ready;</li><li>Error Index.</li></ul></td></tr><tr><td>12.</td><td>"Access Folder" column</td><td>Indicates the availability of folders for processing in dialogs with assistants without the need to check the settings of each assistant.</td></tr></tbody></table>

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%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>

The functionality of the "Documents" table allows you to perform the same actions as the functionality of the [“Chat History”](https://docs.sherparpa.ru/en/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/istoriya-chatov) table.

## Create Folder

To create a new folder in the "Documents" table, click the "Create Folder" button and fill out the form that appears.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%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>

* **Name \***

A required text field for entering the folder name.

* **Folder Analyzer**

A dropdown list of semantic analyzers for automatic processing of files in the folder.

* **Description**

A text field for describing the contents of the folder.

* **Access Folders**

Select a directory for processing folders and files in dialogs with assistants without the need to check the settings of each assistant.

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

## Edit Folder

To view and edit the properties of a specific folder, select it from the list and click the button ![](https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%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). This will open a form with the folder settings, where you can make the necessary changes. In addition to the fields filled out when creating the folder, the form will display the GUID (unique identifier assigned to the folder after its creation). This field cannot be edited.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%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>

## Upload Files

To upload one or more files to a specific folder, check the box in the row of the selected folder, then click the "Upload Files" button.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%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>

In the window that opens, select the desired files and click the "Open" button.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%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>

During the file upload, a window will appear showing the progress of each file being uploaded.

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

After all selected files have been uploaded, click "OK".

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

During processing, such a file will have the status "Processing", then the data from the processed file will be added to the storage, after which the status will change to "Ready". If an incorrect file (for example, one without a text layer) was uploaded, the status will display "Error Index".


---

# 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/en/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.
