Интеграция AI-агентов

Markdown

Эта документация создана так, чтобы её читали не только люди, но и AI-агенты, инструменты на базе LLM и ассистенты разработчика. Это возможно благодаря трём ресурсам:

• Markdown-версия каждой страницы в виде простого текста.
• Индекс llms.txt для каждого языка, который описывает структуру всего сайта.
• Панель действий в верхней части каждой страницы, которая одним кликом отправляет страницу ассистенту.

Markdown-версия каждой страницы

Добавьте .md в конец любого URL страницы в браузере или HTTP-клиенте:

URL страницы	URL Markdown
/developers/api-reference/post-processes	/developers/api-reference/post-processes.md
/products/sign-up/multi-accounts	/products/sign-up/multi-accounts.md
/capabilities/liveness	/capabilities/liveness.md
/pt-BR/capabilities/liveness	/pt-BR/capabilities/liveness.md

Ответ — это Markdown-содержимое страницы без навигации, боковой панели и HTML-обёртки. У каждого языка своя Markdown-версия, с тем же языковым префиксом, что и у страницы.

Индекс llms.txt

У каждого языка есть файл llms.txt в формате llms.txt:

Язык	URL индекса
Английский	/llms.txt
Португальский (Бразилия)	/pt-BR/llms.txt
Испанский	/es/llms.txt

Все остальные языки следуют тому же шаблону: языковой префикс их страниц, а затем /llms.txt.

Файл повторяет навигацию сайта:

• По одному разделу на каждую вкладку верхней панели навигации. За ними идут вкладки Dual API, у каждой название вкладки, за которым следует (Dual API).
• Боковая панель каждой вкладки в виде вложенных списков, в том же порядке, что и на сайте.
• Ссылка на Markdown-версию каждой страницы и описание страницы, если оно есть.

Агент может начать с llms.txt на языке читателя, чтобы понять, как устроена документация. Затем он открывает только нужные ему Markdown-страницы.

Панель действий

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

• Копировать страницу — копирует Markdown страницы в буфер обмена.
• Markdown — открывает Markdown-версию страницы в новой вкладке.
• Открыть в — открывает страницу в AI-ассистенте: ChatGPT, Claude, Gemini, Perplexity, Grok или Copilot. Ассистент получает промпт с Markdown-URL страницы. Для Gemini и Copilot промпт копируется в буфер обмена, и вы вставляете его в чат.
• Копировать URL Markdown — копирует абсолютный URL Markdown-версии, чтобы вставить его в агенты для программирования, такие как Cursor, Codex или Claude Code.

На компьютере Копировать страницу, Markdown, ChatGPT и Claude — это кнопки панели, а остальные действия находятся в Ещё. На мобильных устройствах остальные действия находятся в меню, которое открывает стрелка рядом с Копировать страницу.

Автоматическое обнаружение

HTML каждой страницы объявляет оба ресурса в своём <head>, поэтому агент, открывший любую страницу, находит их без инструкций:

<link rel="alternate" type="text/markdown" href="/capabilities/liveness.md">
<link rel="llms-txt" href="/llms.txt">

• rel="alternate" указывает на Markdown-версию текущей страницы.
• rel="llms-txt" указывает на llms.txt языка страницы.

Сценарии использования

• AI-ассистенты для программирования — передайте ассистенту llms.txt или URL .md, чтобы он работал с точным и актуальным контекстом об эндпоинте, возможности или сценарии использования.
• Промпты для LLM — получите страницу в формате Markdown и включите её в промпт для резюмирования, перевода или генерации кода.
• RAG-пайплайны — используйте llms.txt как список источников, а URL .md — как источник загрузки данных для систем генерации с дополнением из поиска.
• Автоматизированные скрипты — разбирайте контент документации без HTML-скрапера.

Примеры

Получите индекс документации на английском языке:

curl https://developer.unico.io/llms.txt

Получите Markdown-версию страницы аутентификации:

curl https://developer.unico.io/developers/start/authentication.md

Оба ответа — простой текст, готовый к передаче в любую LLM или конвейер обработки.