---
title: Для LLM-агентов
description: Как потреблять этот портал программно — llms.txt, Markdown-двойники каждой страницы, замороженный контракт OpenAPI и манифест сборки с content-хэшами по страницам.
locale: ru
version: 0.2.0
canonical: https://enterium-developer-docs.pages.dev/developers/ru/for-llm-agents/
---

> Documentation index: https://enterium-developer-docs.pages.dev/developers/llms.txt — every page of this portal has a Markdown twin at <route>.md; the frozen API contract is at https://enterium-developer-docs.pages.dev/developers/api/openapi.json.

Эта страница говорит агенту, как читать портал дёшево и надёжно.

## Машинная поверхность (контракт)

| Артефакт | Назначение |
| --- | --- |
| `/developers/llms.txt` | Курируемые точки входа с однострочными описаниями плюс секция Instructions |
| `/developers/llms-full.txt` | Вся дока одним Markdown-документом |
| `/developers/<path>.md` | Markdown-двойник каждой HTML-страницы — бери его, не HTML |
| `/developers/manifest.json` | Nav-дерево + карта роут → content-хэш; сравнивай хэши, чтобы найти изменившиеся страницы |
| `/developers/versions.json` | Опубликованные версии доков и время текущей сборки |
| `/developers/api/openapi.json` | Замороженный контракт OpenAPI, из которого сгенерирован REST-справочник этой сборки |
| `/developers/sitemap.md` | Все страницы плоским списком `.md`-двойников — самый дешёвый полный индекс |
| `/developers/agents.md` | Что портал даёт агенту и чего не обещает — прочитайте, прежде чем что-либо предполагать |
| `/developers/search-index.json` | Маршрут, заголовок, подзаголовки и фрагмент текста на страницу — индекс, который ранжирует инструмент `search` docs-MCP |
| `/developers/changelog.json` | Заметки о выпусках как JSON Feed 1.1: записи портала и API плюс каждая capability-версия агентов |
| `/.well-known/agent-skills/index.json` | Каталог навыков (Agent Skills discovery 0.2.0): `enterium-integration/SKILL.md` с sha256-дайджестом — `npx skills add` устанавливает его |
| `https://entherium.duckdns.org:8443/mcp/docs/` | Эта документация как MCP-инструменты (`search` / `fetch` / `submit_feedback`), без токена — [подробнее](../mcp/connecting/#docs-mcp-без-токена) |
| `https://entherium.duckdns.org:8443/api/status.json` | Статус платформы в форме Statuspage v2, без токена |
| `/.well-known/llms.txt`, `/.well-known/api-catalog` | Алиасы в корне: конвенция llms.txt и каталог API по RFC 9727 (`application/linkset+json`) со ссылками на замороженный контракт, справочник, пробу здоровья и страницу онбординга MCP |

## Обнаружение с любой страницы

Каждая HTML-страница несёт в `<head>` две link-relation (llms.txt v2):
`<link rel="alternate" type="text/markdown" href="<route>.md">` — Markdown-двойник
этой страницы — и `<link rel="describedby" href="/developers/llms.txt">` — индекс,
который её покрывает. Зеркало отдаёт их и HTTP-заголовком `Link:`
(`rel="llms-txt"`, `rel="llms-full-txt"`, `rel="api-catalog"`) и `X-Llms-Txt`, так что
инструмент, читающий только заголовки, тоже находит индекс. Каждый `.md`-двойник
начинается с однострочной директивы с адресом индекса — агент, пришедший по прямой
ссылке, не потеряется.

`.md`-двойники и `manifest.json` отдаются с `ETag`: шлите `If-None-Match` при перечитывании —
`304` скажет, что страница не менялась, без передачи тела.

## Практические правила

1. Предпочитай `.md`-двойники HTML — тот же контент, доля токенов.
2. Чтобы понять, что изменилось с прошлого чтения, храни карту `pages` из
   `manifest.json` и сравнивай с текущей — хэш роута меняется только
   тогда, когда меняется содержимое самой страницы.
3. Английские страницы — канон; русские зеркала существуют для людей.
4. Mermaid-диаграммы сохраняют исходник в `.md`-двойниках — читай
   код-блок, не тяни отрендеренный SVG.
