Оптимизация работы с AI
Выберите подходящий источник документации iEXExchanger, передайте необходимый контекст и проверяйте ответы перед применением.
Качество ответа AI зависит не только от выбранной модели. Важно предоставить подходящие страницы документации, описать окружение, поставить точную задачу и заранее определить, как проверить результат.
Используйте эту страницу при установке, настройке, эксплуатации и диагностике iEXExchanger.
Точный и полезный ответ должен:
основываться на документации iEXExchanger;
учитывать версию продукта и используемое окружение;
сохранять точные названия разделов, полей и параметров;
отделять подтверждённые сведения от предположений;
начинать диагностику с безопасных проверок;
содержать ссылки на использованные страницы;
объяснять, как проверить результат.
Для регулярной работы подключите MCP документации и добавьте готовый навык со страницы «AI-ассистенты и SKILL.md».
Для разового вопроса обычно достаточно Markdown-версии одной или нескольких страниц.
Выбор источника документации
Не передавайте AI всю документацию, если вопрос относится к одной функции. Чем точнее выбран источник, тем меньше посторонней информации попадёт в контекст и тем проще получить конкретный ответ.
Используйте MCP для регулярной работы, поиска по документации и вопросов, которые затрагивают несколько связанных разделов.
Адрес MCP-сервера:
https://docs.iexexchanger.com/~gitbook/mcpЧерез MCP совместимый AI-инструмент сможет:
искать подходящие страницы;
открывать полное содержимое выбранных материалов;
получать актуальную опубликованную версию;
прикладывать ссылки на использованные источники.
Порядок подключения приведён на странице «MCP документации iEXExchanger».
Добавьте .md в конец адреса опубликованной страницы, чтобы открыть её Markdown-версию.
Пример:
https://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/mcp.mdИспользуйте этот вариант, когда:
нужная инструкция уже найдена;
вопрос относится к одной функции;
страницу нужно прикрепить к диалогу;
AI не может корректно прочитать обычную веб-страницу.
Перед подготовкой ответа попросите AI прочитать страницу полностью, а не использовать только её заголовок или отдельный фрагмент.
Для поиска нужной страницы используйте:
llms.txt содержит список материалов и ссылки на их Markdown-версии.
sitemap.md показывает структуру документации и помогает найти нужный раздел, когда точное название страницы неизвестно.
Карта помогает найти материал, но не заменяет чтение его полного содержимого. Не подготавливайте подробную инструкцию только по названию страницы или короткому поисковому фрагменту.
Для локальной базы знаний или AI-инструмента без поддержки MCP используйте:
Все части вместе содержат полный снимок опубликованной документации.
Используйте его, когда:
вопрос охватывает несколько крупных разделов;
документация загружается в отдельный AI-проект;
AI не может открывать внешние ссылки;
нужна локальная база знаний.
Загруженные файлы не обновляются автоматически.
Начинайте с llms.txt и нескольких страниц по теме. Подключайте полный снимок только тогда, когда задача действительно требует большого объёма документации.
Как составить точный запрос
Используйте следующую структуру:
Источник
Укажите, что ответ должен основываться на документации iEXExchanger, подключённом MCP или приложенных Markdown-файлах.
Не ограничивайтесь фразой «изучи документацию». Попросите найти относящиеся к задаче страницы, прочитать их полностью и приложить ссылки.
Задача
Опишите один конкретный результат.
Например:
найти настройку;
подготовить инструкцию;
проверить конфигурацию;
определить причину ошибки;
сравнить два способа настройки;
проверить существующую инструкцию.
Не объединяйте в одном запросе несколько несвязанных задач.
Контекст
Укажите сведения, которые могут изменить ответ:
версию iEXExchanger;
операционную систему;
способ установки;
наличие панели управления сервером;
используемый компонент;
наблюдаемый результат;
последние изменения.
Если контекста недостаточно, попросите AI сначала задать уточняющие вопросы.
Ограничения
Заранее определите допустимые действия.
Например:
Формат ответа
Попросите дать:
действия в правильной последовательности;
назначение каждого действия;
ожидаемый результат;
способ проверки;
подтверждённые риски;
ссылки на источники.
Проверка
Попросите объяснить, как убедиться, что настройка применена или проблема устранена.
Фраза «проверьте, что всё работает» не является достаточной проверкой. Должен быть указан конкретный сценарий и ожидаемый результат.
Пример точного запроса
Недостаточно:
В таком запросе не указаны компонент, окружение, симптом, последние изменения и допустимые действия.
Более точный вариант:
Какой контекст передать
Набор необходимых сведений зависит от задачи.
Укажите:
версию iEXExchanger;
раздел или страницу панели управления;
что вы пытаетесь настроить;
ожидаемое поведение;
что происходит сейчас;
точный текст сообщения или статуса;
что изменялось перед появлением проблемы.
Если точный путь неизвестен, попросите AI найти его в документации.
Не переименовывайте поля и статусы своими словами, если можете скопировать их точные названия из интерфейса.
Укажите:
версию iEXExchanger;
операционную систему;
FastPanel или чистый сервер;
способ установки;
проблемный компонент;
точный текст ошибки;
время появления проблемы;
последние изменения;
небольшой очищенный фрагмент журнала.
К проблемному компоненту могут относиться:
Frontend;
Backend;
Nginx;
PostgreSQL;
Redis;
Reverb;
очередь;
PM2;
PHP-FPM.
Не отправляйте полный файл .env, полные журналы или большой вывод терминала без предварительной проверки на секретные данные.
Укажите:
валюту или направление обмена;
где именно возникает проблема;
ожидаемое поведение;
фактическое поведение;
состояние валют;
состояние направления;
наличие резерва;
проверяемую сумму;
источник курса;
применяемые ограничения.
Ограничения могут зависеть от страны, языка, города, суммы, верификации и других настроек.
Не передавайте данные реального клиента или реальной заявки.
Укажите:
текущую версию iEXExchanger;
целевую версию;
операционную систему;
FastPanel или чистый сервер;
способ текущей установки;
этап, на котором возникла проблема;
точный текст ошибки;
наличие актуальной резервной копии.
Попросите AI не смешивать инструкции для разных способов установки и версий продукта.
Безопасный порядок работы
При диагностике или изменении рабочей системы соблюдайте следующий порядок.
Сформулируйте один проверяемый результат.
Найдите относящиеся к задаче страницы документации.
Полностью прочитайте выбранные материалы.
Выполните проверки без изменения данных и конфигурации.
Сопоставьте результаты с документацией.
Подтвердите причину проблемы.
Внесите одно необходимое изменение.
Повторите исходный сценарий.
Проверьте журналы, статусы или результат в интерфейсе.
Верните изменение, если ожидаемый результат не достигнут и способ возврата заранее определён.
Безопасные проверки
Для серверной проблемы сначала можно проверить:
состояние процесса;
последние записи журнала;
доступность локального порта;
синтаксис конфигурации;
права доступа;
наличие требуемого файла;
доступность домена или поддомена.
Для панели управления сначала проверьте:
статус объекта;
значения связанных полей;
ограничения;
права сотрудника;
состояние зависимых объектов;
результат сохранения.
Не переходите к изменению конфигурации, если причина остаётся только предположением.
Одно изменение за раз
Не применяйте сразу несколько исправлений.
После каждого изменения повторите проверку. Такой порядок позволяет понять, какое действие действительно повлияло на результат, и упрощает возврат.
Перед рискованным изменением определите:
что именно будет изменено;
на какие компоненты это повлияет;
какой результат ожидается;
существует ли актуальная резервная копия;
как вернуть предыдущее состояние.
Постоянная инструкция
Сохраните следующий текст в инструкциях AI-проекта или добавляйте его перед важными вопросами.
Для постоянного применения этих правил установите готовый навык со страницы «AI-ассистенты и SKILL.md».
Готовые запросы
Проверка ответа перед применением
Перед выполнением инструкции убедитесь, что:
использованы страницы документации iEXExchanger;
приложенные ссылки открываются;
AI прочитал полное содержимое страниц;
ответ относится к вашей версии и окружению;
названия меню, полей и статусов указаны точно;
команды не содержат придуманных путей, портов или переменных;
подтверждённые сведения отделены от предположений;
сначала предложены безопасные проверки;
объяснён ожидаемый эффект;
указаны реальные риски;
описан конкретный способ проверки результата;
перед рискованным изменением создана резервная копия;
способ возврата подтверждён заранее.
Не выполняйте на рабочем сервере команды удаления, восстановления базы данных, изменения SSH, Firewall, Nginx, PostgreSQL или системных служб только потому, что их предложил AI.
Сначала подтвердите причину, область изменения, ожидаемый результат и возможность восстановления.
Защита данных
Не передавайте AI:
пароли;
содержимое рабочего
.env;seed-фразы;
приватные ключи;
SSH-ключи;
API-токены;
ключи и пароли мерчантов;
пароли базы данных;
данные SMTP;
реальные платёжные реквизиты;
документы клиентов;
персональные данные;
данные реальных заявок;
журналы с заголовками авторизации.
Проверяйте не только текст запроса, но и прикреплённые файлы, снимки экрана, журналы и вывод терминала.
Заменяйте секретные значения безопасными шаблонами:
Для доменов используйте:
Не скрывайте названия полей, команды и сообщения об ошибках, если они не содержат конфиденциальных данных. Они могут быть важны для диагностики.
Актуальность источников
MCP и Markdown-ссылки обращаются к текущей опубликованной версии документации.
Изменения, которые ещё не опубликованы, недоступны через MCP, .md, llms.txt и llms-full.txt.
Файлы, загруженные вручную, являются отдельным снимком и не обновляются автоматически.
После обновления документации:
Удалите устаревшие копии из AI-проекта.
Повторно загрузите
llms.txt.При необходимости повторно загрузите все части
llms-full.txt.Замените сохранённые Markdown-страницы.
Начните новый диалог.
Повторите проверочный запрос.
Не смешивайте части полного снимка, загруженные в разное время.
Решение проблем
AI не может открыть ссылки
Симптом: AI сообщает, что не получил содержимое страницы, или отвечает без использования указанной ссылки.
Причина: используемый инструмент не имеет доступа к интернету или не умеет открывать внешние страницы.
Как исправить: подключите MCP документации или скачайте нужные Markdown-страницы и прикрепите их к диалогу.
Не просите AI отвечать по странице, содержимое которой он не смог получить.
Проверка результата: в ответе должны быть сведения из переданной страницы и ссылка на источник.
Ответ получился слишком общим
Симптом: ответ не содержит точного пути, названий полей, последовательных действий или проверки результата.
Причина: запрос не содержит конкретной задачи и достаточного контекста либо AI не прочитал полные страницы.
Как исправить: укажите версию, окружение, компонент, симптом и ожидаемый результат. Попросите открыть полные страницы и приложить ссылки.
Проверка результата: ответ должен содержать конкретные действия, ожидаемый результат и способ проверки.
Предложена настройка, которой нет в панели
Симптом: AI указывает поле, вкладку или раздел, которого нет в используемой версии iEXExchanger.
Причина: ответ основан на предположении, другой версии продукта или стороннем источнике.
Как исправить: попросите указать точное название страницы документации и фрагмент, подтверждающий существование настройки.
Если подтверждающего источника нет, считайте настройку неподтверждённой.
Проверка результата: путь и название элемента должны совпасть с документацией и интерфейсом.
Получены противоречивые инструкции
Симптом: в одном ответе используются разные команды, пути или способы установки.
Причина: смешаны разные версии iEXExchanger, операционные системы, способы установки или старые загруженные файлы.
Как исправить: укажите конкретную версию и окружение. Попросите разделить источники и не объединять различающиеся инструкции.
Если противоречие остаётся, не применяйте ни один из вариантов до его уточнения.
Проверка результата: итоговая инструкция должна относиться только к одному подтверждённому окружению.
AI утверждает, что изучил всю документацию
Симптом: AI заявляет о полном изучении документации, но не может перечислить использованные страницы.
Причина: ответ подготовлен без подтверждённого чтения необходимых материалов.
Как исправить: попросите перечислить страницы, открыть их полностью и указать, какие сведения были взяты из каждого источника.
Проверка результата: в ответе должны быть прямые ссылки и подтверждённые сведения из выбранных страниц.
Используется устаревшая копия
Симптом: ответ содержит старые команды, названия или порядок действий.
Причина: в AI-проекте остались ранее загруженные файлы.
Как исправить: удалите старые копии, загрузите актуальные страницы и начните новый диалог.
Проверка результата: ответ должен соответствовать текущей опубликованной документации.
Итоговая проверка
Ответ готов к применению, если:
источник указан и доступен;
окружение определено;
действия относятся к вашей версии;
названия элементов сохранены точно;
подтверждённые сведения отделены от предположений;
отсутствующие данные не выдуманы;
сначала выполнена безопасная диагностика;
ожидаемый результат описан;
способ проверки указан;
риски понятны;
резервная копия подготовлена;
изменение можно контролируемо отменить.
AI должен ускорять поиск информации и подготовку инструкции, но не заменять проверку документации и контроль человека над рабочей системой.
Последнее обновление
Это было полезно?