Для ИИ и агентов

Два документа

Запускаете агента? Этот сайт публикует сам себя. /llms.txt — оглавление этой документации в конвенции llms.txt: заголовок первого уровня, однострочное резюме, дальше страницы. На эту форму может опереться любой агент, которого не учили именно этому сайту.

/llms-full.txt — вторая половина той же мысли: весь авторский корпус документации одним Markdown-документом, все страницы в том порядке, в каком их перечисляет сайт, а следом — живой список моделей каталога: имя и собственный адрес каждой, а не тело её карточки. Его и стоит забирать, когда агент будет отвечать на вопросы, а не смотреть одну вещь, — и стоит он в разы меньше токенов, чем чтение отрисованного HTML.

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

Любая страница как Markdown

Каждая страница этого сайта доступна также по адресу собственного Markdown-исходника.

• Правило. Допишите к пути страницы .md — и в ответ придёт тот Markdown, из которого страница отрисована, с уже подставленными адресами этого развёртывания; быстрый старт, например, отдаётся как Markdown по своему же адресу с .md на конце, и хосты в его примерах — те, к которым вы будете обращаться.
• Исключение. Единственный адрес, к которому правило не подходит, — главная: она отдаётся по /index.md, потому что /.md не имя.
• Ссылки. Ссылки с одной страницы сайта на другую остаются в собственной форме page:, а не превращаются в URL, — так клиент, загрузивший страницу, отличит внутреннюю ссылку от адреса, по которому надо идти.

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

Скопировать для ИИ

В шапке каждой статьи есть ряд действий, и первое из них — «Скопировать для ИИ». Оно кладёт в буфер не текст страницы, а готовый промпт вокруг него. В промпте четыре части:

• короткое вступление на том языке, на котором вы читаете, — что такое Kumo, какая это страница и по какому адресу она живёт;
• Markdown самой страницы с уже подставленной моделью;
• указание на /llms-full.txt на случай, если одной страницы не хватит;
• пустая строка «Мой вопрос:» в конце.

Вставьте это в разговор с ассистентом и допишите вопрос: контекст уже собран, и собран он из той же страницы, которую вы читаете.

Рядом — два действия попроще. Копия чистого Markdown кладёт в буфер ровно тот документ, который отдаёт адрес с .md, — тот же текст, но чтобы вставить его в разговор, а не тянуть по сети. Ссылка рядом открывает сам этот адрес.

Направьте на него агента

Read https://documentation.kumorouter.com/llms-full.txt before answering anything about Kumo.

It is the whole of this documentation as one Markdown document: what the product
is, how a key is issued, how a request is shaped, what comes back, and what a
refusal looks like. Prefer it over crawling the rendered site — it is the same
information at a fraction of the tokens, and it is generated from the site's own
pages rather than written twice.

Any single page is also available as Markdown: take the page's address, drop any
#fragment from it, and add .md. The home page is the exception and is served at
/index.md.

The authored pages themselves name no model ID and no price: they carry a <model>
placeholder wherever one would go. llms-full.txt appends a live index of the model
catalog after them — each model's name and its own address, not its body — so read
that index, or the live catalog and pricing endpoints it points to, for those
values, and do not invent one.

Каждая операция, член за членом →