> 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/nachalo-raboty/rabota-s-ai.md).

# Работа с AI

Опубликованную документацию iEXExchanger можно подключить к внешнему AI-ассистенту. Это помогает находить настройки, собирать сведения из нескольких инструкций, проверять существующие материалы и подготавливать безопасный порядок диагностики.

Для постоянной работы подходят MCP и `SKILL.md`. Если AI-клиент не поддерживает MCP, используйте Markdown-версии страниц, индекс `llms.txt` или полный снимок документации.

{% hint style="info" %}
Эта страница относится к внешним AI-инструментам. Она не описывает встроенные AI-функции iEXExchanger и не предоставляет доступ к административной панели, серверу, базе данных или данным обменного пункта.
{% endhint %}

## Подключение документации

Выберите источник с учётом возможностей AI-клиента и объёма задачи.

### MCP

MCP позволяет совместимому AI-клиенту искать инструкции, открывать полное содержимое страниц и прикладывать ссылки на использованные материалы.

{% content-ref url="/pages/bCnuD0cboWHUB1cSH6an" %}
[MCP](https://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/mcp.md)
{% endcontent-ref %}

Адрес MCP-сервера:

```
https://docs.iexexchanger.com/~gitbook/mcp
```

Если открыть этот адрес в обычном браузере, может появиться ошибка `405 Method Not Allowed`. Адрес предназначен для MCP-запросов, поэтому такая ошибка не означает, что опубликованная документация недоступна.

### AI-ассистенты и SKILL.md

`SKILL.md` содержит постоянные правила работы с документацией iEXExchanger. Навык объясняет AI-ассистенту, когда обращаться к документации, как проверять найденные сведения, сохранять точные названия и не добавлять неподтверждённую информацию.

{% content-ref url="/pages/PfCGzbrNawYBa4Wxpz92" %}
[AI-ассистенты и SKILL](https://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/ai-assistenty-i-skill.md)
{% endcontent-ref %}

{% hint style="warning" %}
`SKILL.md` не содержит саму документацию и не подключает её автоматически. Для чтения страниц AI-ассистенту дополнительно нужен MCP, доступ к опубликованному сайту или переданные Markdown-файлы.
{% endhint %}

### Markdown-версии страниц

Markdown-версия содержит текст страницы без оформления сайта. Чтобы открыть её, добавьте `.md` в конец адреса опубликованной страницы.

```
https://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/mcp.md
```

Если точный адрес страницы неизвестен, используйте индекс:

```
https://docs.iexexchanger.com/llms.txt
```

`llms.txt` содержит названия опубликованных страниц и ссылки на их Markdown-версии.

### Полный снимок документации

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

Для текущей структуры документации доступны следующие части:

```
https://docs.iexexchanger.com/llms-full.txt
https://docs.iexexchanger.com/llms-full.txt/2
https://docs.iexexchanger.com/llms-full.txt/3
https://docs.iexexchanger.com/llms-full.txt/4
https://docs.iexexchanger.com/llms-full.txt/5
https://docs.iexexchanger.com/llms-full.txt/6
https://docs.iexexchanger.com/llms-full.txt/7
```

Все перечисленные части вместе образуют полный снимок опубликованной документации. Для одного вопроса достаточно `llms.txt` и нескольких связанных страниц.

{% hint style="warning" %}
Скрытие страницы из оглавления не делает её конфиденциальной. Такая страница может оставаться доступной через MCP и `llms-full.txt`.

Не размещайте в документации пароли, токены, приватные ключи и рабочие конфигурации с секретными значениями.
{% endhint %}

## Выбор и проверка подключения

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

### Какой способ выбрать

| Задача                            | Источник                     | Результат                                           |
| --------------------------------- | ---------------------------- | --------------------------------------------------- |
| Изучить одну найденную инструкцию | Markdown-версия страницы     | AI получает полное содержимое выбранной страницы    |
| Искать по всей документации       | MCP                          | AI самостоятельно находит и открывает материалы     |
| Постоянно работать с iEXExchanger | MCP и `SKILL.md`             | AI получает документацию и правила работы с ней     |
| Работать без MCP                  | `llms.txt` и нужные страницы | Пользователь передаёт материалы вручную             |
| Создать локальную базу знаний     | Все части `llms-full.txt`    | AI получает полный снимок опубликованных материалов |

### Быстрый запуск

1. Выберите подходящий источник.
2. Подключите MCP или передайте AI-клиенту нужные Markdown-файлы.
3. Установите `SKILL.md`, если клиент поддерживает навыки.
4. Начните новый диалог.
5. Укажите задачу и необходимый контекст.
6. Отправьте проверочный запрос.
7. Проверьте сведения и ссылки в ответе.

### Проверочный запрос

Используйте этот запрос после подключения документации:

{% prompt description="Проверка подключения документации" icon="sparkles" %}

```markdown
Используй документацию iEXExchanger как основной источник.

Найди инструкцию по созданию валюты.

Укажи:

1. Что нужно подготовить до создания.
2. Точный путь в панели управления.
3. Основные действия.
4. Как проверить результат.
5. Прямые ссылки на использованные страницы.

Не отвечай по памяти и не добавляй сведения, которых нет в документации.
```

{% endprompt %}

### Признаки правильного подключения

Подключение работает корректно, если AI:

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

## Подготовка запроса

AI видит только опубликованные материалы и сведения, переданные пользователем. Точный контекст помогает получить ответ, относящийся к нужной версии, операции и части iEXExchanger.

### Что можно поручить AI

AI может использовать опубликованную документацию, чтобы:

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

### Как передать контекст

Состав данных зависит от задачи. Не передавайте сведения, которые не нужны для ответа.

#### Вопрос по административной панели

Укажите:

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

#### Серверная проблема

Назовите одну выполняемую операцию:

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

Также укажите:

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

Если проблема возникла при установке или обновлении, укажите используемый инструмент: Installer, Updater или Update Agent.

Проблема также может относиться к Frontend, Backend, Nginx, HTTPS, PHP-FPM, PostgreSQL, Redis, PM2, Horizon, Reverb, Pulse, планировщику задач или резервному копированию.

#### Вопрос по направлению обмена или курсу

Укажите:

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

Не передавайте данные реального клиента или реальной заявки. Используйте безопасные тестовые значения и заранее очищенные фрагменты журналов.

### Ограничения

<details>

<summary>Что AI не может определить самостоятельно</summary>

Без результатов проверки AI не знает:

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

</details>

<details>

<summary>К чему документация не предоставляет доступ</summary>

MCP и Markdown-файлы не предоставляют доступ к:

* административной панели;
* SSH, файлам и службам сервера;
* базе данных и рабочему файлу `.env`;
* заявкам и данным клиентов;
* резервам и реквизитам;
* API-ключам и ключу лицензии;
* персональным данным.

Через документацию нельзя изменить настройку, обработать заявку, выполнить команду на сервере, изменить резерв, установить обновление, запустить откат или получить закрытые данные.

</details>

***

## Проверка ответа

Не применяйте инструкцию, пока не проверены её источники, применимость и последствия.

### Источники

Проверьте:

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

### Применимость

Убедитесь, что:

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

### Проверка перед изменением

До выполнения действий убедитесь, что:

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

Дополнительные правила и рабочие запросы находятся на странице «Оптимизация работы с AI».

### Актуальность документации

MCP, Markdown-версии страниц, `llms.txt` и `llms-full.txt` используют текущую опубликованную версию документации. Изменения, которые ещё не опубликованы, через эти источники недоступны.

Файлы, загруженные в AI-проект вручную, не обновляются вместе с документацией.

После публикации изменений:

1. Повторно загрузите `llms.txt`.
2. Замените сохранённые Markdown-страницы.
3. Замените используемые части `llms-full.txt`.
4. Удалите устаревшие копии из AI-проекта.
5. Начните новый диалог.
6. Повторите проверочный запрос.

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

## Безопасность

Перед отправкой запроса проверьте текст, прикреплённые файлы, снимки экрана, журналы и вывод терминала.

### Доступы и ключи

Не передавайте AI:

* пароли;
* содержимое рабочего `.env`;
* seed-фразы;
* приватные ключи;
* SSH-ключи;
* API-токены;
* ключи и пароли мерчантов;
* пароли базы данных;
* данные SMTP.

### Данные клиентов и операций

Не передавайте AI:

* реальные платёжные реквизиты;
* документы клиентов;
* персональные данные;
* данные реальных заявок;
* резервы и другую закрытую финансовую информацию.

### Технические материалы

Перед отправкой удалите из материалов:

* токены из журналов;
* заголовки авторизации;
* внутренние адреса, которые не требуются для диагностики;
* секретные значения из конфигурационных файлов.

### Как скрыть значения

Заменяйте секретные данные понятными шаблонами:

```dotenv
APP_KEY=<скрыто>
DB_DATABASE=<имя_базы>
DB_USERNAME=<пользователь_базы>
DB_PASSWORD=<скрыто>
API_TOKEN=<скрыто>
```

Для доменов используйте:

```
https://ваш_домен
https://app.ваш_домен
```

{% hint style="danger" %}
Не разрешайте AI удалять файлы, восстанавливать базу данных или изменять SSH, межсетевой экран, Nginx, PostgreSQL и системные службы без проверки человеком, понимания последствий и актуальной резервной копии.
{% endhint %}
