ИИ Ассистент

Как открыть

1. Покажите панель ИИ Ассистент через меню Вид.
2. В редакторе выделенный фрагмент можно отправить в чат кнопкой Добавить в ИИ Ассистент.
3. Enter — отправить сообщение, Shift+Enter — новая строка.

Вкладки панели: Сообщения (текущий диалог) и История (сохранённые чаты). Кнопки: новый чат, настройки, экспорт, стоп генерации.

Что настроить перед первым запросом

Без этих пунктов ассистент не запустится или будет гадать.

1. Провайдер ИИ — OpenAI, Anthropic, z.ai или локальный LM Studio. Нужны модель, API-ключ и при необходимости Base URL.
2. Папка проекта (Project root folder) — обязательна. Это корень, внутри которого ассистент читает и пишет файлы. Обычно это папка робота со стартовым файлом и каталогом .agents.
3. Режим — Ask или Code (см. ниже).
4. XHE MCP-сервер — включите «Использовать XHE MCP сервер», чтобы ассистент сверял методы с документацией API, а не выдумывал сигнатуры. Поиск методов вручную: Поиск API.

Новый проект с правилами для ИИ можно создать из чата (ассистент умеет инициализировать папку) или обычным шаблоном робота. Структура папок: описание.

Режимы Ask и Code

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

На каждое сообщение Studio собирает контекст и отправляет его модели вместе с набором инструментов.

В контекст попадает:

• системная инструкция (писать скрипты на выбранном языке);
• режим чата и путь к папке проекта;
• список файлов проекта;
• включённые правила из .agents/rules/*.md;
• файл AGENTS.md из корня проекта (в начале нового чата — целиком);
• при включённых настройках — содержимое активного файла в редакторе и список открытых вкладок.

Дальше модель вызывает инструменты, пока не закончит задачу:

• файлы — список, чтение, запись, правка по строкам;
• запуск скрипта — старт, чтение лога, остановка;
• текущая страница браузера — URL, title, HTML, скриншот;
• вопрос пользователю — если не хватает URL, пути к файлу, имени колонки Excel;
• список задач — прогресс шагов в панели;
• MCP-документация — поиск метода, описание класса, примеры;
• инициализация проекта — добавить .agents в существующую папку или создать новый робот.

Типичный цикл в режиме Code: прочитать правила → найти метод в MCP → записать файл → запустить скрипт → прочитать лог → если в логе [ERROR], исправить и повторить.

Готовые куски кода по задачам, без ИИ: каталог сниппетов. Навигация в браузере: browser, элементы страницы: DOM.

Как формулировать задачу

Плохо: «сделай парсер».

Хорошо:

Напиши PHP-скрипт: открыть https://example.com/login,
ввести логин из data/accounts.xlsx (колонки Login и Password, лист 1),
нажать «Войти», дождаться ссылки «Кабинет»,
сохранить HTML в data/cabinet.html.
Файл: login_and_save.php.

Обязательно укажите:

• язык (PHP / JS / Python / C#) — сравнение: языки скриптов;
• URL или путь к файлу;
• что считать успехом (какой элемент, какой файл на выходе);
• имя файла скрипта, если оно важно.

Если данных не хватает, ассистент должен спросить через диалог, а не выдумывать URL и колонки Excel. Если начал угадывать — нажмите Stop и допишите недостающее.

Правила и скиллы проекта

В шаблоне робота лежат инструкции для модели. Их включают и выключают во вкладке Rules настроек ассистента.

Правила (.agents/rules/): как подключать init, как завершать WINDOW::$app->quit(), как обращаться к WEB::$browser / DOM::$button, как ждать элемент, не выдумывать методы API. Init и quit: app, навигация: navigate.

Скиллы (.agents/skills/): готовые приёмы — wait_js() после navigate(), выбор DOM-класса, поиск элемента, ожидание, чтение MCP.

Свои правила — обычные .md в .agents/rules/. Первая строка description: ... или заголовок # станет подписью в настройках. Выключенное правило в запрос не попадает.

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

• Режим Code.
• Включить Использовать XHE MCP сервер.
• Включить Включать активный файл в контекст, если правите уже открытый скрипт.
• Temperature ближе к 0.2–0.4 (значение 0.7 даёт более «творческий» и менее точный код).
• Флажок Отправлять только новое сообщение оставляйте выключенным для OpenAI / Anthropic / z.ai: у этих API нет своей памяти между запросами, историю должна отправлять Studio. Включайте только если модель сама помнит диалог (некоторые локальные сборки).
• Ограничить доступ к папкам оставляйте включённым: ассистент не выйдет за корень проекта (чтение Templates/init.php при этом разрешено).

Что получается и что нет

Получается, если задача конкретная, в браузере Studio открыта нужная страница, включены Code и MCP, в проекте есть шаблонные правила.

Ломается, если в Ask просят «сохрани файл», если MCP выключен (модель выдумывает методы), если не заданы URL и пути.

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

Короткий сценарий «напиши скрипт»

1. Создайте или откройте папку робота, укажите её как папку проекта.
2. В настройках: провайдер, модель, режим Code, MCP включён.
3. Откройте в браузере Studio целевой сайт (ассистент умеет снять HTML и скриншот текущей вкладки). Браузер: встроенный браузер.
4. В чате опишите шаги, URL, входные и выходные файлы и язык.
5. Дождитесь, пока файл появится в папке проекта. В Code ассистент должен сам записать файл, а не оставлять огромный код только в чате.
6. Если в логе [ERROR] — пришлите ошибку в тот же чат: «исправь строку N, ошибка такая-то».

FAQ

Ассистент пишет код в чат, файла нет. Проверьте режим: нужен Code, не Ask. Укажите папку проекта.

Методы «как будто есть», а скрипт падает. Включите MCP и попросите сверить вызов с документацией. Имя метода ищите в Поиске API.

Нет init / quit / wait после navigate. В проекте должен быть шаблон с AGENTS.md и правилами. Инициализируйте папку через ассистента или возьмите шаблон робота.

Можно ли без облачной модели? Да, через LM Studio на локальной машине. Качество кода будет зависеть от выбранной coder-модели.

С чего начать без ИИ? С чего начать, макросы, сниппеты.