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

# Оптимизация работы с AI

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

Используйте эту страницу при установке, настройке, эксплуатации и диагностике iEXExchanger.

Точный и полезный ответ должен:

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

{% hint style="info" %}
Для регулярной работы подключите MCP документации и добавьте готовый навык со страницы «AI-ассистенты и SKILL.md».

Для разового вопроса обычно достаточно Markdown-версии одной или нескольких страниц.
{% endhint %}

## Выбор источника документации

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

{% tabs %}
{% tab title="MCP" %}
Используйте MCP для регулярной работы, поиска по документации и вопросов, которые затрагивают несколько связанных разделов.

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

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

Через MCP совместимый AI-инструмент сможет:

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

Порядок подключения приведён на странице «MCP документации iEXExchanger».
{% endtab %}

{% tab title="Одна страница" %}
Добавьте `.md` в конец адреса опубликованной страницы, чтобы открыть её Markdown-версию.

Пример:

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

Используйте этот вариант, когда:

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

Перед подготовкой ответа попросите AI прочитать страницу полностью, а не использовать только её заголовок или отдельный фрагмент.
{% endtab %}

{% tab title="Карта документации" %}
Для поиска нужной страницы используйте:

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

`llms.txt` содержит список материалов и ссылки на их Markdown-версии.

`sitemap.md` показывает структуру документации и помогает найти нужный раздел, когда точное название страницы неизвестно.

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

{% tab title="Полный снимок" %}
Для локальной базы знаний или AI-инструмента без поддержки MCP используйте:

```
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
```

Все части вместе содержат полный снимок опубликованной документации.

Используйте его, когда:

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

Загруженные файлы не обновляются автоматически.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Начинайте с `llms.txt` и нескольких страниц по теме. Подключайте полный снимок только тогда, когда задача действительно требует большого объёма документации.
{% endhint %}

## Как составить точный запрос

Используйте следующую структуру:

```
Источник + задача + контекст + ограничения + формат ответа + проверка
```

### Источник

Укажите, что ответ должен основываться на документации iEXExchanger, подключённом MCP или приложенных Markdown-файлах.

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

### Задача

Опишите один конкретный результат.

Например:

* найти настройку;
* подготовить инструкцию;
* проверить конфигурацию;
* определить причину ошибки;
* сравнить два способа настройки;
* проверить существующую инструкцию.

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

### Контекст

Укажите сведения, которые могут изменить ответ:

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

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

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

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

Например:

```
Сначала предложи только безопасные проверки без изменения конфигурации.

Не смешивай инструкции для FastPanel и чистого сервера.

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

### Формат ответа

Попросите дать:

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

### Проверка

Попросите объяснить, как убедиться, что настройка применена или проблема устранена.

Фраза «проверьте, что всё работает» не является достаточной проверкой. Должен быть указан конкретный сценарий и ожидаемый результат.

## Пример точного запроса

Недостаточно:

```
Почему не работает Nginx?
```

В таком запросе не указаны компонент, окружение, симптом, последние изменения и допустимые действия.

Более точный вариант:

```
По документации iEXExchanger помоги диагностировать ошибку 502 Bad Gateway у Frontend.

Окружение:
- версия iEXExchanger: <версия>;
- операционная система: <ОС>;
- способ установки: <FastPanel или чистый сервер>;
- компонент: Frontend;
- проблема появилась после: <действие или неизвестно>;
- точный текст ошибки: <ошибка>.

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

Отдели подтверждённые действия от диагностических предположений.

Для каждой проверки укажи:
1. цель;
2. команду или действие;
3. ожидаемый результат;
4. что означает отклонение;
5. ссылку на использованную страницу.
```

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

Набор необходимых сведений зависит от задачи.

{% tabs %}
{% tab title="Панель управления" %}
Укажите:

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

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

Не переименовывайте поля и статусы своими словами, если можете скопировать их точные названия из интерфейса.
{% endtab %}

{% tab title="Сервер" %}
Укажите:

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

К проблемному компоненту могут относиться:

* Frontend;
* Backend;
* Nginx;
* PostgreSQL;
* Redis;
* Reverb;
* очередь;
* PM2;
* PHP-FPM.

Не отправляйте полный файл `.env`, полные журналы или большой вывод терминала без предварительной проверки на секретные данные.
{% endtab %}

{% tab title="Обмен и курсы" %}
Укажите:

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

Ограничения могут зависеть от страны, языка, города, суммы, верификации и других настроек.

Не передавайте данные реального клиента или реальной заявки.
{% endtab %}

{% tab title="Установка и обновление" %}
Укажите:

* текущую версию iEXExchanger;
* целевую версию;
* операционную систему;
* FastPanel или чистый сервер;
* способ текущей установки;
* этап, на котором возникла проблема;
* точный текст ошибки;
* наличие актуальной резервной копии.

Попросите AI не смешивать инструкции для разных способов установки и версий продукта.
{% endtab %}
{% endtabs %}

## Безопасный порядок работы

При диагностике или изменении рабочей системы соблюдайте следующий порядок.

1. Сформулируйте один проверяемый результат.
2. Найдите относящиеся к задаче страницы документации.
3. Полностью прочитайте выбранные материалы.
4. Выполните проверки без изменения данных и конфигурации.
5. Сопоставьте результаты с документацией.
6. Подтвердите причину проблемы.
7. Внесите одно необходимое изменение.
8. Повторите исходный сценарий.
9. Проверьте журналы, статусы или результат в интерфейсе.
10. Верните изменение, если ожидаемый результат не достигнут и способ возврата заранее определён.

### Безопасные проверки

Для серверной проблемы сначала можно проверить:

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

Для панели управления сначала проверьте:

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

Не переходите к изменению конфигурации, если причина остаётся только предположением.

### Одно изменение за раз

Не применяйте сразу несколько исправлений.

После каждого изменения повторите проверку. Такой порядок позволяет понять, какое действие действительно повлияло на результат, и упрощает возврат.

Перед рискованным изменением определите:

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

## Постоянная инструкция

Сохраните следующий текст в инструкциях AI-проекта или добавляйте его перед важными вопросами.

{% prompt description="Инструкция для точных ответов по iEXExchanger" icon="file-check" %}

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

Перед ответом найди относящиеся к задаче страницы и прочитай их полностью. Не делай подробный вывод только по заголовкам или фрагментам поиска.

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

Учитывай версию iEXExchanger, операционную систему, способ установки и используемый компонент. Если этих сведений недостаточно, сначала запроси их.

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

Отделяй подтверждённые сведения от предположений. Если точного ответа в документации нет, прямо скажи об этом и укажи, какой информации не хватает.

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

Для каждого действия укажи:

1. Цель.
2. Ожидаемый результат.
3. Способ проверки.
4. Подтверждённый риск.
5. Ссылку на источник.

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

{% endprompt %}

Для постоянного применения этих правил установите готовый навык со страницы «AI-ассистенты и SKILL.md».

## Готовые запросы

{% prompt description="Найти настройку" %}

```markdown
Используя документацию iEXExchanger, найди настройку автоматического обновления основных курсов.

Укажи:

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

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

{% endprompt %}

{% prompt description="Направление не отображается" icon="arrows-left-right" %}

```markdown
По документации iEXExchanger помоги определить, почему направление обмена не отображается на клиентском сайте.

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

Сначала дай только безопасные проверки в правильной последовательности.

Для каждой проверки укажи:

1. Что проверить.
2. Где это проверить.
3. Какой результат ожидается.
4. Что означает отклонение.
5. На какой странице документации это описано.

Отдели подтверждённые причины от диагностических предположений.
```

{% endprompt %}

{% prompt description="Диагностика серверной ошибки" icon="server" %}

```markdown
Используя документацию iEXExchanger, помоги диагностировать следующую проблему:

<опишите симптом и точный текст ошибки>

Окружение:
- версия iEXExchanger: <версия>;
- операционная система: <ОС>;
- способ установки: <способ>;
- панель управления сервером: <панель или отсутствует>;
- компонент: <Frontend, Backend, Nginx, PostgreSQL, Reverb или другой>;
- последние изменения: <действие или неизвестно>.

Сначала предложи только безопасные проверки и команды чтения состояния.

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

Для каждой проверки укажи ожидаемый результат.

В конце приложи ссылки на использованные страницы.
```

{% endprompt %}

{% prompt description="Проверить готовую инструкцию" icon="shield-check" %}

```markdown
Проверь следующую инструкцию по документации iEXExchanger:

<вставьте инструкцию>

Раздели результат на четыре части:

1. Подтверждённые действия.
2. Действия, которые противоречат документации.
3. Сведения, которые не удалось проверить.
4. Использованные страницы.

Не исправляй неподтверждённые части предположениями.
```

{% endprompt %}

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

Перед выполнением инструкции убедитесь, что:

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

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

Сначала подтвердите причину, область изменения, ожидаемый результат и возможность восстановления.
{% endhint %}

## Защита данных

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

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

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

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

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

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

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

Не скрывайте названия полей, команды и сообщения об ошибках, если они не содержат конфиденциальных данных. Они могут быть важны для диагностики.

## Актуальность источников

MCP и Markdown-ссылки обращаются к текущей опубликованной версии документации.

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

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

После обновления документации:

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

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

## Решение проблем

<details>

<summary>AI не может открыть ссылки</summary>

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

**Причина:** используемый инструмент не имеет доступа к интернету или не умеет открывать внешние страницы.

**Как исправить:** подключите MCP документации или скачайте нужные Markdown-страницы и прикрепите их к диалогу.

Не просите AI отвечать по странице, содержимое которой он не смог получить.

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

</details>

<details>

<summary>Ответ получился слишком общим</summary>

**Симптом:** ответ не содержит точного пути, названий полей, последовательных действий или проверки результата.

**Причина:** запрос не содержит конкретной задачи и достаточного контекста либо AI не прочитал полные страницы.

**Как исправить:** укажите версию, окружение, компонент, симптом и ожидаемый результат. Попросите открыть полные страницы и приложить ссылки.

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

</details>

<details>

<summary>Предложена настройка, которой нет в панели</summary>

**Симптом:** AI указывает поле, вкладку или раздел, которого нет в используемой версии iEXExchanger.

**Причина:** ответ основан на предположении, другой версии продукта или стороннем источнике.

**Как исправить:** попросите указать точное название страницы документации и фрагмент, подтверждающий существование настройки.

Если подтверждающего источника нет, считайте настройку неподтверждённой.

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

</details>

<details>

<summary>Получены противоречивые инструкции</summary>

**Симптом:** в одном ответе используются разные команды, пути или способы установки.

**Причина:** смешаны разные версии iEXExchanger, операционные системы, способы установки или старые загруженные файлы.

**Как исправить:** укажите конкретную версию и окружение. Попросите разделить источники и не объединять различающиеся инструкции.

Если противоречие остаётся, не применяйте ни один из вариантов до его уточнения.

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

</details>

<details>

<summary>AI утверждает, что изучил всю документацию</summary>

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

**Причина:** ответ подготовлен без подтверждённого чтения необходимых материалов.

**Как исправить:** попросите перечислить страницы, открыть их полностью и указать, какие сведения были взяты из каждого источника.

**Проверка результата:** в ответе должны быть прямые ссылки и подтверждённые сведения из выбранных страниц.

</details>

<details>

<summary>Используется устаревшая копия</summary>

**Симптом:** ответ содержит старые команды, названия или порядок действий.

**Причина:** в AI-проекте остались ранее загруженные файлы.

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

**Проверка результата:** ответ должен соответствовать текущей опубликованной документации.

</details>

## Итоговая проверка

Ответ готов к применению, если:

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

{% hint style="success" %}
AI должен ускорять поиск информации и подготовку инструкции, но не заменять проверку документации и контроль человека над рабочей системой.
{% 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://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/optimizaciya-raboty-s-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.