ИИ-агент, подключённый к Авторскому MCP-серверу, может работать с вашей документацией так же, как это делал бы коллега по команде — читать страницы, искать по контенту и вносить правки, следуя инструкциям на обычном языке. Тот же агент, которого ваша команда уже использует для написания кода или ответов на обращения в поддержку, может поддерживать актуальность справочного контента, не заставляя никого вручную копировать данные между инструментами.
Это руководство проведёт вас через одну реальную задачу от начала до конца: поиск устаревших страниц на вашем портале и их обновление. К концу вы увидите, как агент сканирует ваш портал, указывает на то, что выглядит устаревшим, и обновляет страницу — причём только после вашего одобрения.
| Для работы с этим руководством вам не нужны технические навыки или навыки программирования — достаточно ИИ-инструмента и обычного языка. Если вы никогда раньше не использовали ИИ-агента для работы с документацией, это подходящее руководство, чтобы начать. |
Что можно делать
Документация устаревает по мере изменения продукта — старые номера версий, переименованные или удалённые функции, описания, которые больше не соответствуют действительности. Искать такие места вручную среди сотен страниц долго, и легко что-то упустить.
Агент, подключённый к Авторскому MCP-серверу, может выполнить рутинную часть работы за вас. В этом руководстве он:
- Просканирует проект и составит список страниц, которые выглядят устаревшими, с указанием причины для каждой.
- Покажет вам, что именно выглядит устаревшим в выбранной вами странице, и предложит новые формулировки.
- Применит изменение после вашего одобрения и переведёт страницу в статус проверки, чтобы её утвердил человек.
| Агент не может удалять страницы — это остаётся решением человека. Вместо этого он помечает то, что выглядит устаревшим, и присваивает таким страницам статус проверки, так что вы сохраняете контроль над тем, что действительно меняется. |
Это лишь один из сценариев. Больше примеров — создание страниц из транскрипта звонка, реструктуризация проекта по методологии Diataxis, аудит переводов или наведение порядка после неудачного импорта — смотрите в статье Варианты использования авторского MCP-сервера.
В этом руководстве
Выполните эти три шага по порядку:
- Перед началом работы — что вам понадобится и как настроить отдельную учётную запись для агента.
- Подключение ИИ-агента — соедините свой ИИ-инструмент с вашим порталом.
- Выполнение задачи — промпты для поиска и обновления устаревших страниц.