# Для агентов

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

> **Не путать со встроенным помощником школы.** Этот раздел — про то, как
> подключиться к школе **снаружи**: своим агентом, по ключу и по машинным
> выходам документации. Внутри школы есть свой помощник, он работает уже
> сегодня и настраивается галочками — см. [ИИ-агент школы](/guide/agent/).

## С чего начать агенту

1. **[/llms.txt](/llms.txt)** — карта разделов, по строке описания на каждый.
   Небольшой файл, с него стоит начинать.
2. **[/llms-full.txt](/llms-full.txt)** — вся документация одним текстом, если
   нужен полный контекст.
3. **[/openapi.draft.json](/openapi.draft.json)** — черновик спецификации API.
   `draft` в имени и признак `x-lms-provisional` — не украшение: работающих
   маршрутов пока нет, первый срез в разработке ([состав](/api/scope/)).
4. **Ключ только на чтение** — см. ниже.

Любая страница доступна в Markdown: к её адресу добавляется `.md`.

## Страницы раздела

| Страница | Состояние |
|---|---|
| [Машинные выходы](/agents/machine-readable/) | Работает сегодня |
| [Ключ с узкими правами](/agents/keys/) | Правила приняты, реестра ключей ещё нет |
| [MCP-сервер: как подключить](/agents/mcp/) | Сервера ещё нет |
| [Что умеет MCP-сервер](/agents/tools/) | Сервера ещё нет |

## Одно правило важнее остальных

> **Ключ для агента по умолчанию создаётся только на чтение.**

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

Права на запись выдаются явно, отдельным действием. Подробности —
[Ключ с узкими правами](/agents/keys/).

## Почему MCP-сервера ещё нет

Он появится не раньше, чем появятся настоящие маршруты API. Обернуть в инструменты
спецификацию, которой нет в коде, значит выдать агенту 226 несуществующих команд —
и он честно попробует их вызвать.