Выполнение задачи

Теперь поручите работу вашему агенту. Выполняйте описанные ниже шаги в чате вашего ИИ-инструмента. Замените названия в квадратных скобках на названия ваших собственных проектов и страниц.

Шаг 1. Попросите агента найти устаревшие страницы

Вставьте в чат агента примерно такой промпт, указав проект, который нужно проверить:

Просмотри проект [Название проекта] на моём портале Документерры и составь список страниц, которые выглядят устаревшими. Например, страницы, которые давно не обновлялись или в которых упоминаются старые номера версий, удалённые функции или шаги, которые больше не соответствуют продукту. Для каждой страницы укажи её название и краткую причину, почему она выглядит устаревшей. Пока ничего не меняй.

Что вы увидите: агент выполнит поиск по проекту и вернёт список страниц, каждая с кратким пояснением — например, «Импорт контента — всё ещё описывает старый мастер импорта и ссылается на версию 7». Ничего не изменено; это отчёт для вашего изучения.

Шаг 2. Выберите страницу и запросите предлагаемые правки

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

Открой страницу [Название страницы]. Покажи, какие именно части выглядят устаревшими, и объясни почему. Затем предложи обновлённые формулировки — но пока не применяй никаких изменений.

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

Шаг 3. Утвердите изменение и отправьте его на проверку

Когда вас устроит предложенный вариант, скажите агенту применить его и перевести страницу в статус проверки:

Отлично. Пожалуйста, примени эти изменения к странице и установи её статус [ваш статус проверки], чтобы автор мог проверить её перед публикацией.

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

Названия статусов зависят от рабочего процесса вашего портала. Используйте то, что ваша команда применяет для значения «готово к проверке» — например, На проверке или Требуется проверка. Если вы не уверены, можете спросить у агента, какие статусы доступны.

Шаг 4. Масштабируйте процесс (опционально)

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

Пройдись по всем страницам в проекте [Название проекта], обнови те, что явно устарели, таким же образом и установи каждой обновлённой странице статус [ваш статус проверки]. Дай мне сводку того, что ты изменил.

Вы также можете подключать другие источники в рамках того же чата. Если ваш агент подключён к вашему трекеру задач через его собственный MCP-сервер, вы можете попросить его сравнить задачи из релиза с вашей документацией и указать — или подготовить черновик — того, что ещё не описано, без ручного копирования данных между двумя инструментами. Вы сохраняете контроль на всех этапах: агент реагирует на ваши промпты в чате шаг за шагом, а не действует самостоятельно.

Хотите делать также на своём портале?

Если у вас ещё нет аддона, вот что он открывает: возможность поручать реальную работу с документацией ИИ-агенту на обычном языке прямо внутри Документерры. Авторский MCP-сервер входит в аддон REST API + MCP — смотрите страницу с ценами, чтобы подключить его, или обсудите ваш сценарий использования с нашей командой.

Уже есть аддон? Изучите Варианты использования авторского MCP-сервера, чтобы узнать больше способов применения — от документирования кодовой базы до аудита переводов.