> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/setting-up-agent/dokumenty.md).

# Документы

<a href="https://app.nextbot.ru/option#document-processing" class="button secondary">Перейти к блоку «Документы»</a>

<figure><img src="/files/69eZucTwZEAO22cEid6p" alt=""><figcaption></figcaption></figure>

Блок "документы" позволяет настраивать работу и обработку документов ИИ-агентом. **На данный момент поддерживается только PDF**.

Если вы хотите, чтобы ИИ-агент обрабатывал PDF-файлы и отвечал на них, выберите опцию "**Распознавать документ**".\
\
Включите "**Отвечать стандартным сообщением**" и заполните стандартное сообщение, чтобы ИИ-агент не обрабатывал документы и отправлял заготовленный текст пользователю — например, "извините, я не не могу скачать ваш PDF-файл. Пожалуйста, напишите текстом".\
\
**Отправлять документы в мессенджер из ссылок в сообщении (в Telegram, WhatsApp и VK)** — если эта опция включена, ИИ-агент будет самостоятельно отправлять документы в мессенджер по ссылкам на файлы, если они присутствуют в сообщении (учтите это в промпте ИИ-агента).

Агент может отправлять PDF в чат в виде документа **только если вы дали ему прямую ссылку на PDF-файл**, то есть такую, которая ведёт непосредственно на сам файл (например, `https://site.com/file.pdf`).\
Ссылки на сторонние хранилища вроде **Google Диска, Яндекс Диска, Dropbox и других** не подходят, так как они открывают веб-страницу, а не сам PDF-документ. В таких случаях агент **всё равно отправит ссылку**, но **файл не будет прикреплён к сообщению**.

Если вы хотите, чтобы документ корректно отображался как вложение, разместите его по прямой ссылке на своём сайте или другом источнике, где адрес оканчивается на `.pdf` и открывается стандартный просмотрщик PDF, а не страницу с предпросмотром или кнопкой скачивания.

**Удалять ссылки из сообщения ИИ-агента** — при активировании этой опции ссылки на документы будут удалены из сообщения (учтите это в промпте ИИ-агента).

{% hint style="info" %}
**Только для канала Вконтакте:**\
\
**Если вы уже использовали ключ доступа раньше, то чтобы ИИ мог отправлять вам PDF-файлы, нужно создать новый ключ доступа с правом на работу с документами. Ваш старый ключ для этого не подходит.**
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://doc.nextbot.ru/functional/setting-up-agent/dokumenty.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.