> 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 Выберите подходящий источник документации iEXExchanger, передайте необходимый контекст и проверяйте ответы перед применением. Качество ответа AI зависит не только от выбранной модели. Важно предоставить подходящие страницы документации, описать окружение, поставить точную задачу и заранее определить, как проверить результат. Используйте эту страницу при установке, настройке, эксплуатации, обновлении и диагностике iEXExchanger. Точный и полезный ответ должен: * основываться на опубликованной документации iEXExchanger; * учитывать версию продукта и используемое окружение; * сохранять точные названия разделов, полей, статусов и параметров; * отделять подтверждённые сведения от предположений; * начинать диагностику с проверок без изменения данных и конфигурации; * содержать ссылки на полностью прочитанные страницы; * объяснять ожидаемый результат и способ его проверки. {% hint style="info" %} Для регулярной работы подключите MCP документации и добавьте готовый навык со страницы «AI-ассистенты и SKILL». Для разового вопроса обычно достаточно Markdown-версии одной или нескольких страниц. {% endhint %} ## Источники документации Не передавайте AI всю документацию, если вопрос относится к одной функции. Чем точнее выбран источник, тем меньше посторонней информации попадёт в контекст и тем проще получить конкретный ответ. ### Выбор источника | Задача | Источник | Результат | | ------------------------------------------------ | -------------------------------------- | ----------------------------------------------------- | | Регулярно искать сведения по нескольким разделам | MCP документации | AI находит и полностью открывает актуальные страницы | | Задать вопрос по одной известной инструкции | Markdown-версия страницы | В контекст передаётся только нужный материал | | Найти страницу по названию или теме | `llms.txt` | AI получает индекс опубликованных страниц | | Создать локальную базу знаний | Вся последовательность `llms-full.txt` | AI получает полный снимок опубликованной документации | ### MCP Используйте MCP для регулярной работы, поиска по документации и вопросов, которые затрагивают несколько связанных разделов. {% content-ref url="/pages/bCnuD0cboWHUB1cSH6an" %} [MCP](/nachalo-raboty/rabota-s-ai/mcp.md) {% endcontent-ref %} Адрес MCP-сервера: ``` https://docs.iexexchanger.com/~gitbook/mcp ``` Через MCP совместимый AI-инструмент сможет: * искать подходящие страницы; * открывать полное содержимое выбранных материалов; * сопоставлять сведения из нескольких инструкций; * получать актуальную опубликованную версию; * прикладывать ссылки на использованные источники. При работе через MCP: 1. Используйте `searchDocumentation`, чтобы найти материалы по задаче. 2. Используйте `getPage`, чтобы полностью прочитать каждую выбранную страницу. 3. Используйте `askQuestion` для быстрого ответа с источниками, но не ограничивайтесь им при подробной или потенциально опасной инструкции. {% hint style="warning" %} Фрагмент поисковой выдачи не заменяет полное содержимое страницы. Не подготавливайте многоэтапную инструкцию только по заголовку или короткому фрагменту. {% endhint %} Порядок подключения и проверки приведён на странице «MCP». ### Одна страница Добавьте `.md` в конец адреса опубликованной страницы, чтобы открыть её Markdown-версию. Markdown-версия страницы MCP: ``` https://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/mcp.md ``` Используйте этот вариант, когда: * нужная инструкция уже найдена; * вопрос относится к одной функции; * страницу нужно прикрепить к диалогу; * AI не может корректно прочитать обычную веб-страницу. Перед подготовкой ответа попросите AI прочитать страницу полностью, а не использовать только её заголовок или отдельный фрагмент. ### Индекс документации Для поиска нужной страницы используйте: ``` https://docs.iexexchanger.com/llms.txt ``` `llms.txt` содержит список опубликованных материалов и ссылки на их Markdown-версии. {% hint style="warning" %} Индекс помогает найти материал, но не заменяет чтение его полного содержимого. {% endhint %} ### Полный снимок Для локальной базы знаний или AI-инструмента без поддержки MCP начните с адреса: ``` https://docs.iexexchanger.com/llms-full.txt ``` Если в конце файла указана ссылка `Next Page`, загрузите следующую часть и продолжайте, пока такой ссылки больше нет. Все части должны быть получены последовательно и использоваться вместе. Используйте полный снимок, когда: * вопрос охватывает несколько крупных разделов; * документация загружается в отдельный AI-проект; * AI не может открывать внешние ссылки; * требуется локальная база знаний. Загруженные вручную файлы не обновляются автоматически. {% hint style="warning" %} MCP и `llms-full.txt` могут включать скрытые страницы. Для конкретной задачи сначала определите материалы, относящиеся к текущей версии и окружению, и попросите AI перечислить страницы, на которых основан ответ. {% endhint %} {% hint style="info" %} Начинайте с `llms.txt` и нескольких страниц по теме. Подключайте полный снимок только тогда, когда задача действительно требует большого объёма документации. {% endhint %} ## Подготовка точного запроса Используйте следующую структуру: **источник, задача, контекст, ограничения, формат ответа и проверка**. Один запрос должен приводить к одному понятному результату. ### Структура запроса #### Источник Укажите, что ответ должен основываться на документации iEXExchanger, подключённом MCP или приложенных Markdown-файлах. Не ограничивайтесь фразой «изучи документацию». Попросите найти относящиеся к задаче страницы, прочитать их полностью и приложить прямые ссылки. #### Задача Опишите один конкретный результат: * найти настройку; * подготовить инструкцию; * проверить конфигурацию; * определить причину ошибки; * сравнить два подтверждённых способа настройки; * проверить существующую инструкцию. Не объединяйте в одном запросе несколько несвязанных задач. #### Контекст Укажите сведения, которые могут изменить ответ: * версию iEXExchanger; * операционную систему; * способ установки; * используемый раздел, компонент или службу; * ожидаемый результат; * фактический результат; * точный текст ошибки или статуса; * последние изменения; * уже выполненные проверки. Если критичного контекста недостаточно, попросите AI сначала задать уточняющие вопросы. #### Ограничения Заранее определите допустимые действия. Для рабочей системы сначала разрешайте только проверки без изменения файлов, данных, конфигурации и состояния служб. Для обновления заранее укажите один выбранный способ: через терминал или через административную панель. Не разрешайте смешивать оба способа в одной последовательности. #### Формат ответа Попросите указать: * использованные страницы; * подтверждённые сведения; * диагностические предположения; * действия в правильной последовательности; * назначение каждого действия; * ожидаемый результат; * подтверждённые риски; * способ проверки. #### Проверка Попросите объяснить, как убедиться, что настройка применена или проблема устранена. Фраза «проверьте, что всё работает» недостаточна. Должен быть указан конкретный сценарий и ожидаемый результат. ### Пример точного запроса Недостаточно: ``` Почему не работает Nginx? ``` В таком запросе не указаны компонент, окружение, симптом, последние изменения и допустимые действия. Более точный вариант: ```markdown По документации iEXExchanger помоги диагностировать ошибку 502 Bad Gateway у Frontend. Окружение: - версия iEXExchanger: <версия>; - операционная система: <ОС>; - установка: актуальный Installer на чистом сервере; - компонент: Frontend; - проблема появилась после: <действие или неизвестно>; - точный текст ошибки: <ошибка>. Сначала предложи только проверки без изменения данных, файлов, конфигурации и состояния служб. Отдели подтверждённые действия от диагностических предположений. Для каждой проверки укажи: 1. Цель. 2. Команду или действие. 3. Ожидаемый результат. 4. Что означает отклонение. 5. Ссылку на использованную страницу. ``` ## Контекст по типу задачи Передавайте только сведения, относящиеся к текущему вопросу. Не прикладывайте полный журнал, конфигурацию или снимок всей административной панели, если достаточно небольшого очищенного фрагмента. {% stepper %} {% step %} ### Административная панель Укажите: * версию iEXExchanger; * точное название раздела или страницы; * выполняемую задачу; * ожидаемое поведение; * фактическое поведение; * точный текст сообщения, статуса или ошибки; * изменения, выполненные перед появлением проблемы; * права сотрудника, если они могут влиять на действие. Если точный путь неизвестен, попросите AI найти его в документации. Не переименовывайте поля и статусы своими словами, если можете скопировать их точные названия из интерфейса. {% endstep %} {% step %} ### Сервер Укажите: * версию iEXExchanger; * операционную систему; * состояние установки, выполненной актуальным Installer на чистом сервере; * проблемный компонент или службу; * точный текст ошибки; * время появления проблемы; * последние изменения; * небольшой очищенный фрагмент журнала; * результаты уже выполненных проверок. К проблемному компоненту могут относиться: * Frontend; * Backend; * Nginx; * PHP-FPM; * PostgreSQL; * Redis; * Reverb; * Horizon; * Scheduler; * Update Agent; * системная служба iEXExchanger. Не отправляйте полный `.env`, полные журналы или большой вывод терминала без предварительной проверки на секретные данные. {% endstep %} {% step %} ### Обмен и курсы Укажите: * валюту или направление обмена; * точный раздел, в котором возникает проблема; * ожидаемое поведение; * фактическое поведение; * состояние связанных валют и направления; * наличие резерва; * проверяемую сумму; * источник курса; * применяемые лимиты и ограничения; * страну, язык, город и требования верификации, если они относятся к сценарию. Не передавайте сведения о реальном клиенте или реальной заявке. {% endstep %} {% step %} ### Установка и обновление Укажите: * текущую версию iEXExchanger; * целевую версию; * операционную систему; * этап установки или обновления; * выбранный способ обновления: терминал или административная панель; * состояние Installer, Updater или Update Agent, относящееся к задаче; * точный текст ошибки; * наличие актуальной резервной копии; * уже выполненные действия. Попросите AI не смешивать инструкции для первичной установки и обновления, а также не объединять терминальный и административный способы обновления. {% endstep %} {% endstepper %} ## Безопасный порядок работы При диагностике или изменении рабочей системы сначала подтвердите текущее состояние и только затем переходите к действиям. ### Последовательность диагностики 1. Сформулируйте один проверяемый результат. 2. Найдите относящиеся к задаче страницы документации. 3. Полностью прочитайте выбранные материалы. 4. Зафиксируйте текущее состояние и уже выполненные изменения. 5. Выполните проверки без изменения данных, файлов, конфигурации и состояния служб. 6. Сопоставьте результаты с документацией. 7. Подтвердите причину проблемы. 8. Определите одно необходимое изменение, ожидаемый эффект и подтверждённый риск. 9. Перед влияющим на данные или доступность действием проверьте резервную копию и подтверждённый способ возврата. 10. Внесите одно изменение и повторите исходный сценарий. 11. Проверьте результат в интерфейсе, состояниях служб или журналах, относящихся к задаче. Если причина не подтверждена, не переходите к изменению конфигурации. ### Проверки без изменения системы Для серверной проблемы сначала можно проверить: * состояние проблемной службы; * последние относящиеся к ошибке записи журнала; * доступность локального порта; * синтаксис конфигурации; * права доступа; * наличие требуемого файла; * доступность основного или административного домена. Для административной панели сначала проверьте: * статус объекта; * значения связанных полей; * применяемые ограничения; * права сотрудника; * состояние зависимых объектов; * результат сохранения. ### Одно изменение за раз Не применяйте сразу несколько исправлений. После каждого изменения повторяйте исходную проверку, чтобы определить, какое действие действительно повлияло на результат. Перед изменением должны быть известны: * изменяемый объект, файл, параметр или служба; * компоненты, на которые повлияет действие; * ожидаемый результат; * подтверждённый риск; * состояние резервной копии, если она требуется; * подтверждённый способ возврата, если он предусмотрен. {% hint style="danger" %} Не выполняйте на рабочем сервере команды удаления, восстановления базы данных, изменения SSH, Firewall, Nginx, PostgreSQL или системных служб только потому, что их предложил AI. Сначала подтвердите причину, область изменения, ожидаемый результат и возможность восстановления. {% endhint %} ## Постоянные правила и готовые запросы Сохраните постоянную инструкцию в настройках AI-проекта. Готовые запросы используйте для отдельных задач, заменяя значения в угловых скобках своими обезличенными данными. {% prompt description="Инструкция для точных ответов по iEXExchanger" icon="file-check" %} ```markdown Используй опубликованную документацию iEXExchanger как основной источник. Перед ответом найди относящиеся к задаче страницы и прочитай их полностью. Не делай подробный вывод только по заголовкам или фрагментам поиска. Сохраняй точные названия разделов, кнопок, полей, вкладок, статусов, команд, файлов, переменных и параметров. Учитывай версию iEXExchanger, операционную систему, состояние установки, выбранный способ обновления и используемый компонент. Если этих сведений недостаточно, сначала запроси их. Не смешивай инструкции для разных версий, операционных систем, способов установки и способов обновления. Для обновления используй только один выбранный путь: терминал или административную панель. Не предлагай запускать их одновременно. Отделяй подтверждённые сведения от предположений. Если точного ответа в документации нет, прямо скажи об этом и укажи, какой информации не хватает. Для диагностики сначала предложи проверки без изменения данных, файлов, конфигурации и состояния служб. Для каждого действия укажи: 1. Цель. 2. Ожидаемый результат. 3. Способ проверки. 4. Подтверждённый риск. 5. Ссылку на источник. Не придумывай отсутствующие настройки, команды, пути, порты, переменные, значения по умолчанию, ограничения или поведение продукта. ``` {% endprompt %} Для постоянного применения этих правил установите готовый навык. ### Готовые запросы {% 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: <версия>; - операционная система: <ОС>; - установка: актуальный Installer на чистом сервере; - компонент или служба: ; - последние изменения: <действие или неизвестно>; - уже выполненные проверки: <перечень или отсутствуют>. Сначала предложи только проверки и команды чтения состояния. Не изменяй конфигурацию, не перезапускай все службы и не удаляй данные, пока причина не подтверждена. Для каждой проверки укажи цель, ожидаемый результат и значение отклонения. В конце приложи прямые ссылки на использованные страницы. ``` {% endprompt %} {% prompt description="Проверить готовую инструкцию" icon="shield-check" %} ```markdown Проверь следующую инструкцию по опубликованной документации iEXExchanger: <вставьте инструкцию> Не выполняй описанные действия. Раздели результат на пять частей: 1. Подтверждённые действия. 2. Действия, которые противоречат документации. 3. Сведения, которые не удалось проверить. 4. Подтверждённые риски и предварительные условия. 5. Использованные страницы со ссылками. Не исправляй неподтверждённые части предположениями. ``` {% endprompt %} ## Проверка ответа и защита данных Перед применением инструкции проверьте источники, соответствие окружению, риски и ожидаемый результат. ### Проверка ответа перед применением Убедитесь, что: * использованы страницы документации iEXExchanger; * приложенные ссылки открываются; * выбранные страницы прочитаны полностью; * ответ относится к вашей версии и окружению; * названия меню, полей, статусов, команд и файлов указаны точно; * команды не содержат придуманных путей, портов, параметров или переменных; * подтверждённые сведения отделены от предположений; * сначала предложены проверки без изменения системы; * объяснены назначение и ожидаемый результат каждого действия; * указаны подтверждённые риски; * описан конкретный способ проверки результата; * обновление выполняется только одним выбранным способом; * перед рискованным изменением подготовлена актуальная резервная копия; * способ возврата подтверждён документацией. {% hint style="danger" %} Не применяйте инструкцию, если AI не указал подтверждающие страницы, ожидаемый результат, реальные риски и способ проверки. Для действий, влияющих на данные или доступность, сначала проверьте актуальную резервную копию и подтверждённый способ возврата. {% endhint %} ### Защита данных Не передавайте AI: * пароли; * содержимое рабочего `.env`; * seed-фразы; * приватные ключи; * SSH-ключи; * API-токены; * ключи и пароли мерчантов; * пароли базы данных; * данные SMTP; * реальные платёжные реквизиты; * документы клиентов; * персональные данные; * содержимое реальных заявок; * журналы с заголовками авторизации. Проверяйте не только текст запроса, но и прикреплённые файлы, снимки экрана, журналы и вывод терминала. Заменяйте секретные значения безопасными шаблонами: ```dotenv APP_KEY=<скрыто> DB_DATABASE=<имя_базы> DB_USERNAME=<пользователь_базы> DB_PASSWORD=<скрыто> API_TOKEN=<скрыто> ``` Для доменов используйте: ``` https://ваш_домен https://app.ваш_домен ``` Не скрывайте точные названия полей, безопасные команды и сообщения об ошибках, если они не содержат конфиденциальных данных. Они могут быть важны для диагностики. ## Актуальность источников MCP, Markdown-страницы, `llms.txt` и `llms-full.txt` отражают текущую опубликованную версию документации. Изменения, которые ещё не опубликованы, через эти источники недоступны. Файлы, загруженные вручную, являются отдельным снимком и не обновляются автоматически. ### Обновление локальных материалов После обновления документации: 1. Удалите устаревшие копии из AI-проекта. 2. Повторно загрузите `llms.txt`. 3. Заново загрузите начальный `llms-full.txt` и все страницы `Next Page`, если используется полный снимок. 4. Замените сохранённые Markdown-страницы. 5. Начните новый диалог. 6. Повторите проверочный запрос. {% hint style="warning" %} Не объединяйте части `llms-full.txt`, полученные в разное время. Если одна часть была обновлена, загрузите весь снимок заново. {% endhint %} ## Решение проблем Если ответ не подходит, сначала исправьте источник или запрос. Не компенсируйте общий или противоречивый ответ случайным применением нескольких вариантов.
AI не может открыть ссылки **Симптом:** AI сообщает, что не получил содержимое страницы, или отвечает без использования указанной ссылки. **Причина:** инструмент не имеет доступа к интернету, не умеет открывать внешние страницы или получил только поисковый фрагмент. **Как исправить:** подключите MCP документации либо скачайте нужные Markdown-страницы и прикрепите их к диалогу. Не просите AI отвечать по странице, содержимое которой он не смог получить. **Проверка результата:** ответ содержит сведения из переданной страницы и прямую ссылку на источник.
Ответ получился слишком общим **Симптом:** ответ не содержит точного пути, названий полей, последовательных действий или проверки результата. **Причина:** запрос не содержит конкретной задачи и достаточного контекста либо AI не прочитал полные страницы. **Как исправить:** укажите версию, окружение, раздел или компонент, симптом, ожидаемый результат и допустимые действия. Попросите открыть полные страницы и приложить ссылки. **Проверка результата:** ответ относится к одному сценарию и содержит конкретные действия, ожидаемый результат и способ проверки.
Предложена настройка, которой нет в административной панели **Симптом:** AI указывает поле, вкладку или раздел, которого нет в используемой версии iEXExchanger. **Причина:** ответ основан на предположении, другой версии продукта или стороннем источнике. **Как исправить:** попросите указать полную страницу документации, которая подтверждает существование настройки. Если подтверждающего источника нет, считайте настройку неподтверждённой. **Проверка результата:** путь и название элемента совпадают с документацией и текущим интерфейсом.
Получены противоречивые инструкции **Симптом:** в одном ответе используются разные команды, пути, версии или способы обновления. **Причина:** смешаны разные версии iEXExchanger, операционные системы, способы установки, способы обновления или загруженные в разное время файлы. **Как исправить:** укажите конкретную версию и окружение. Выберите один способ выполнения и попросите AI не объединять различающиеся инструкции. Если противоречие остаётся, не применяйте ни один из вариантов до его уточнения. **Проверка результата:** итоговая инструкция относится только к одному подтверждённому окружению и одному способу выполнения.
AI утверждает, что изучил всю документацию **Симптом:** AI заявляет о полном изучении документации, но не может перечислить использованные страницы. **Причина:** ответ подготовлен без подтверждённого чтения необходимых материалов. **Как исправить:** попросите перечислить страницы, открыть их полностью и указать, какие сведения были взяты из каждого источника. **Проверка результата:** ответ содержит прямые ссылки и подтверждённые сведения из выбранных страниц.
Используется устаревшая копия **Симптом:** ответ содержит старые команды, названия или порядок действий. **Причина:** в AI-проекте остались ранее загруженные Markdown-файлы или части полного снимка. **Как исправить:** удалите старые копии, загрузите актуальные материалы и начните новый диалог. **Проверка результата:** источники открываются на опубликованном сайте, а ответ соответствует их текущему содержимому.
## Итоговая проверка Ответ готов к применению, если: * источник указан и доступен; * окружение определено; * действия относятся к вашей версии; * названия элементов сохранены точно; * подтверждённые сведения отделены от предположений; * отсутствующие данные не выдуманы; * сначала выполнена безопасная диагностика; * ожидаемый результат описан; * способ проверки указан; * риски понятны; * резервная копия подготовлена, если она требуется; * изменение можно контролируемо отменить подтверждённым способом. {% hint style="success" %} AI должен ускорять поиск информации и подготовку инструкции, но не заменять проверку документации и контроль человека над рабочей системой. {% endhint %}