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

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

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

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

{% stepper %}
{% step %}

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

<figure><img src="/files/ZYbBvjMhf0TcfWwMksd4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

<figure><img src="/files/6NdUyl7eFwGkXlH1zWbv" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

<figure><img src="/files/q1IYLsWG0n1VQ1te7YzC" 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="/files/h27V7cb7hQzKFytRGMiN" alt=""><figcaption></figcaption></figure>

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

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

{% step %}

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

<figure><img src="/files/39C66Q03t3FkIAvdRYsL" alt=""><figcaption></figcaption></figure>

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


---

# 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.suvvy.ai/ru/deistviya/obrabotka-failov.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.