> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/deistviya/obrabotka-failov.md).

# Обработка файлов

Данный функционал позволяет извлечь текст из файла, который прислал клиент в диалоге.

## Для чего это нужно?

* Клиент может прислать файлы в форматах docx, pdf, rtf, txt или любой другой формат.
* Бот сможет обработать файл, либо передать результат из файла в другие шаги действия.

## Создание действия для извлечения текста из файла

{% stepper %}
{% step %}

### Перейдите в раздел "Действия" и нажмите кнопку "Добавить"

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FNAhkMD28MLA0Wxlma6CO%2Fimage.png?alt=media&amp;token=cdcdcdf0-cad6-475f-a968-7d2279f1684a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Выбираем тип шага - Извлечь текст из файла

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F7mTyUloIdkYyp2XWBfTl%2Fimage.png?alt=media&amp;token=b0e99abc-0c0a-4339-9c20-f0f1331ad398" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Попадаем в Настройки действия

{% hint style="success" %}
В настройках действия уже установлены все необходимые параметры и после сохранения, функционал извлечения текста из файла готов к использованию.
{% endhint %}

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FIoz5qaTReU4LANVaB9VU%2Fimage.png?alt=media&amp;token=0ba0e8a8-7069-49b1-b0a8-9c239ba2c1b0" alt=""><figcaption></figcaption></figure>

| **Название действия**                       | Название для отображения, по которому Вы легко сможете определить нужное действие в общем списке                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Аргумент, в котором будет передан файл**  | В этом поле предустановлен аргумент {file}, который назначен в настройках Переменные действия. При назначении своего аргумента, устанавливаем тип - Документ.                                                                                                                                                                                                                                                                                                                 |
| **Режим экспорта**                          | Формат разметки текста полученного из файла - Markdown или HTML                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Поместить полученный текст в переменную** | Назначается переменная для передачи полученного текста в другие шаги.                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Режим чтения сканированного текста**      | <p>Выбирается режим распознавания текста представленного в файлах на изображениях или сканированного текста:<br>- Не использовать распознавание текста.<br>- Использовать распознавание, если файл - PDF и содержит хотя бы одну картинку.<br>- Всегда распознавать текст на изображениях.<br></p><p>Если в действие прислали скан в формате PDF (не текстом) или DOCX с картинками, то данный режим сможет прочитать эти файлы как текст. Цена - 0.5 рублей за страницу.</p> |
| {% endstep %}                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

{% step %}

### Условия срабатывания:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FOxIrJXzX725zlRI4JMy6%2Fimage.png?alt=media&amp;token=de59d625-6ebf-47bb-b5b8-36bf32b4fe73" alt=""><figcaption></figcaption></figure>

Здесь можем изменить:

* Вызов функции **LLM-моделью** или [Вызов по триггеру](/ru/deistviya/vyzov-deistvii-po-triggeru.md).
* **Название функции** - Название функции дает боту понимание, в какой момент момент вызвать эту функцию (действие). Для того, чтобы автоматически сгенерировать **Название функции**, заполните поле **Название действия** и нажмите **кнопку** автоматической генерации справа от поля с названием функции.
* **Описание функции** - Описывается, как работать с этой функцией (действием) и в какой момент ее лучше вызывать.
  {% endstep %}

{% step %}

### Переменные действия

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fob2P0tkK0U1sAAPXrJgm%2Fimage.png?alt=media&amp;token=27f86dab-cb01-467a-a999-ecf2dc113864" alt=""><figcaption></figcaption></figure>

* **Аргумент** - так как аргументом для функции у нас является любой документ, то в поле Аргумент установлен **`file` .**
* **Описание аргумента&#x20;*****-*** это поле необязательно и служит для описания, чтобы бот лучше понимал зачем аргумент нужен и что туда передавать.
* **Тип** - так как данный шаг поддерживает только аргументы-файлы выбран **"Документ".**
  {% endstep %}
  {% endstepper %}


---

# 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 following URL with the `ask` and `goal` query parameters:

```
GET https://docs.suvvy.ai/ru/deistviya/obrabotka-failov.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.