---
title: "Как сделать документацию удобной для ИИ"
id: "kak-sdelat-dokumentatsiyu-udobnoy-dlya-ii"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/kak-sdelat-dokumentatsiyu-udobnoy-dlya-ii"
keywords:
  - "AI"
updated: 2026-11-16T06:45:50Z
---

# Как сделать документацию удобной для ИИ

Современные ИИ-ассистенты — такие как ChatGPT, Claude, Gemini и другие — все чаще извлекают и обобщают контент из интернета в режиме реального времени. Чтобы эти инструменты работали максимально точно, ваш портал документации должен предоставлять контент в таком виде, чтобы ИИ-агенты могли эффективно его находить и считывать.

Что делает портал документации удобным для ИИ:

* **Использование llms.txt** — специально подготовленный, человекочитаемый индексный файл, который указывает ИИ-агентам, какие страницы вашего портала являются наиболее авторитетными и релевантными. Он следует [конвенции llms.txt](https://llmstxt.org/), предложенной сообществом исследователей ИИ, и является аналогом файлов robots.txt и sitemap.xml для традиционных поисковых систем. Узнайте, как [настроить llms.txt для вашего портала Документерры](/articles/manual/nastroyka-llms-txt-dlya-portala).
* **Машиночитаемые форматы** — предоставление документации в формате Markdown или через API (JSON) вместо PDF-файлов или сложной HTML-разметки, которые боты не всегда могут правильно распознать. В Документерре каждую страницу на вашем портале можно [получить в виде чистого Markdown](/articles/manual/poluchenie-stranits-v-formate-markdown). Это позволяет ИИ-агентам и инструментам на базе LLM читать отдельные страницы без необходимости парсить HTML.
* **MCP-серверы**— Документерра реализует Model Context Protocol (MCP), открытый стандарт, который позволяет ИИ-агентам подключаться к источнику данных, искать по нему и работать с его контентом. На портале есть два независимых MCP-сервера:
    * **[MCP-сервер опубликованной документации](/articles/manual/mcp-server-opublikovannoy-dokumentatsii)** — для ваших читателей. Их агенты обращаются к вашей опубликованной документации и отвечают по вашему контенту, а не додумывают и не опираются на устаревшую копию.
    * **[Авторский MCP-сервер](/articles/manual/mcp-server)** — для вашей команды. Ваши агенты получают доступ ко всему порталу, включая неопубликованные проекты, и могут редактировать контент.
* **Семантическая разметка** — строгая иерархия заголовков (H1 → H2 → H3), которая помогает моделям правильно разбивать текст на фрагменты для анализа.
* **Оптимальный размер страниц** — старайтесь делать отдельные страницы не слишком короткими, но и не слишком длинными. В очень коротких страницах не хватает контекста, необходимого ИИ для точных ответов на вопросы; очень длинные страницы могут превысить размер контекстного окна инструментов на базе LLM или привести к «размытию» нужной информации. Это полностью соответствует принципам [постраничного создания документации](/articles/manual/postranichnoye-sozdaniye-dokumentatsii): каждая страница должна быть самодостаточной и фокусироваться на одной концепции — что является одинаково хорошим подходом как для читателей-людей, так и для ИИ-агентов.
* **Отсутствие "скрытого" контекста** — ИИ не умеет угадывать. Термины должны быть четко определены в глоссарии, а примеры кода должны содержать все необходимые данные для немедленного запуска.

Эти советы в совокупности помогают гарантировать, что ваша документация будет корректно использоваться в ответах, сгенерированных ИИ, инструментах для разработчиков и агентных рабочих процессах.

* [Настройка llms.txt для портала](/articles/manual/nastroyka-llms-txt-dlya-portala)
* [Получение страниц в формате Markdown](/articles/manual/poluchenie-stranits-v-formate-markdown)