> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/nastroiki/obshie/nastroiki-ai.md).

# Настройки AI

Раздел «Настройки AI» используется для подключения и управления AI-функциями системы.

Путь в панели управления: **«Настройки» — «Общие настройки» — «Дополнительно» — «AI»**

<figure><img src="/files/pcG6DpWSnz4ziv0tuUUe" alt=""><figcaption></figcaption></figure>

Раздел находится в статусе Beta. Это значит, что функции уже работают, но в будущих версиях могут расширяться.

## Для чего нужен раздел

Сейчас AI используется в двух основных местах:

<table><thead><tr><th width="269.83984375">Функция</th><th>Для чего нужна</th></tr></thead><tbody><tr><td>AI в онлайн-чате</td><td>Помогает отвечать клиенту в чате заявки</td></tr><tr><td>Автоперевод в редакторах</td><td>Переводит мультиязычные поля в админке</td></tr></tbody></table>

AI не является самостоятельным оператором и не выполняет действия в заявках. Он помогает с текстами, переводами и первичными ответами клиенту.

***

## Ключ подключения AI

Поле «Ключ подключения AI» используется для подключения к AI-провайдеру.

Без ключа AI-функции работать не будут.

Важно:

* ключ хранится на стороне сервера;
* обычные пользователи сайта его не видят;
* ключ нужно хранить безопасно;
* не передавайте ключ третьим лицам;
* после добавления или изменения ключа нажмите «Сохранить».

Рекомендуется использовать ключ с минимально необходимыми правами доступа.

***

## Включить AI в онлайн-чате

Настройка «Включить AI в онлайн-чате» разрешает AI-помощнику отвечать клиенту в чате заявки.

AI может отвечать, если выполнены условия:

* добавлен ключ подключения AI;
* включена настройка «Включить AI в онлайн-чате»;
* включён онлайн-чат для заявок;
* клиент написал текстовое сообщение;
* заявка ещё не передана оператору;
* оператор не ответил клиенту раньше AI после его сообщения.

AI отвечает только на сообщения клиента. На сообщения оператора он не отвечает.

***

## Что может делать AI в чате

AI-помощник может подсказать клиенту:

* какой сейчас статус заявки;
* что делать дальше;
* почему заявка ожидает обработки;
* что означает этап оплаты;
* когда нужно ждать оператора;
* какие данные видны по заявке на основе доступной информации.

AI не выполняет финансовые и административные действия.

Он не может:

* менять статус заявки;
* подтверждать оплату;
* выполнять выплату;
* пересчитывать заявку;
* отменять заявку;
* принимать решения за оператора;
* проверять банк, кошелёк или мерчант вручную.

***

## Когда AI передаёт чат оператору

AI прекращает отвечать и передаёт диалог оператору, если вопрос требует ручной проверки.

Например:

* клиент просит оператора или живого человека;
* клиент просит отмену или возврат;
* есть жалоба, спор или претензия;
* вопрос связан с AML, блокировкой или риском;
* клиент ошибся суммой, сетью или реквизитами;
* клиент пишет, что оплатил, но это нельзя подтвердить безопасно;
* нужен доступ к банку, мерчанту, кошельку или ручной проверке;
* оператор уже ответил клиенту после его сообщения.

В таком случае клиент может увидеть сообщение:

Передаю диалог оператору, он проверит детали вручную.

После передачи оператору AI больше не вмешивается в этот чат.

***

## Включить автоперевод в редакторах

Настройка «Включить автоперевод в редакторах» добавляет кнопку автоперевода в мультиязычные поля админки.

Как работает:

1. Администратор заполняет текст на одном языке.
2. Нажимает кнопку автоперевода.
3. AI переводит текст на остальные активные языки.
4. Переводы автоматически подставляются в нужные языковые поля.

Если исходный текст пустой, система покажет ошибку. Сначала нужно заполнить основной язык.

***

## Всегда перезаписывать переводы

Настройка «Всегда перезаписывать переводы» определяет, что делать с уже заполненными переводами при повторном автопереводе.

<table><thead><tr><th width="206.16796875">Состояние</th><th>Как работает</th></tr></thead><tbody><tr><td>Включено</td><td>Старые переводы заменяются новыми</td></tr><tr><td>Выключено</td><td>Перевод добавляется только в пустые поля</td></tr></tbody></table>

Если вы часто редактируете исходный текст и хотите полностью обновлять все языки — включите эту настройку.

Если часть переводов редактируется вручную — лучше выключить, чтобы AI не перезаписал ручные правки.

***

## Что AI сохраняет при переводе

При автопереводе система старается сохранить структуру текста:

* HTML-разметку;
* переносы строк;
* ссылки;
* списки;
* служебные теги;
* переменные;
* плейсхолдеры;
* коды валют;
* числа;
* технические значения.

Например, такие значения не должны переводиться или изменяться:

`[city]`, `[country]`, `[direction_name]`, `{amount}`, `{{name}}`, `%s`.

***

## Что пока нельзя настроить

В текущем разделе нельзя отдельно выбрать:

* конкретную модель AI;
* отдельного AI-провайдера из списка;
* лимиты запросов;
* стоимость запросов;
* индивидуальные правила ответа AI в чате;
* отдельные промпты для переводчика;
* отдельные промпты для чат-помощника.

Сейчас администратор управляет ключом подключения и включает или выключает доступные AI-функции.

***

## Рекомендуемый порядок настройки

1. Откройте **«Настройки» — «Общие настройки» — «Дополнительно» — «AI»**
2. Введите ключ подключения AI.
3. Включите «Автоперевод в редакторах», если нужны автоматические переводы.
4. Выберите, нужно ли всегда перезаписывать переводы.
5. Если нужен AI-помощник в заявках, включите «AI в онлайн-чате».
6. Проверьте, что онлайн-чат для заявок тоже включён.
7. Нажмите «Сохранить».
8. Протестируйте автоперевод в любом мультиязычном поле.
9. Протестируйте AI-чат на тестовой заявке.

***

## Коротко

Настройки AI позволяют подключить AI-провайдера, включить AI-помощника в онлайн-чате и использовать автоперевод мультиязычных полей.

AI помогает ускорить работу операторов и администраторов, но не заменяет оператора: он не меняет статусы, не подтверждает оплату и не выполняет выплаты.


---

# 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://docs.iexexchanger.com/guide/nastroiki/obshie/nastroiki-ai.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.
