Начало
Документация AgentOS
AgentOS – кабинет студента курса «AgentOS 3»: уроки и эфиры, транскрипты, анкета, персональный план, прогресс, AI-тьютор и личный менторинг. Всё, что студент видит в кабинете, его агент может читать через REST API или MCP – от имени студента и только в пределах выданных прав.
| Что | Адрес |
|---|---|
| REST API | https: |
| MCP (Streamable HTTP) | https: |
| Контракт OpenAPI | / |
| Для ИИ-агентов | / · / |
Как это устроено#
Бэкенд AgentOS – для агентов, кабинет – для людей. Один и тот же слой возможностей обслуживает три входа:
- Кабинет (веб и Telegram Mini App) – вход по ссылке из бота, Telegram Login или паролю, сессия в cookie.
- REST API –
Authorization:; персональный API-ключ студент выпускает в кабинете.Bearer < ключ> - MCP – те же данные в виде инструментов для Claude, ChatGPT, Claude Code и Codex; авторизация по OAuth или тем же API-ключом.
REST и MCP используют общие обработчики, общий журнал вызовов и общие лимиты ключа: инструмент aos_ возвращает тот же JSON, что GET .
Авторизация#
- API-ключ –
aos3.и 43 символа base64url, действует 90 дней. Секрет показывается один раз при создании. Права задают scopes.sk_ - OAuth – для коннекторов Claude.ai и ChatGPT: discovery, динамическая регистрация клиента (DCR), authorization code с PKCE S256. Access token живёт час, refresh token – 30 суток с каждой выдачи (при ротации срок сдвигается).
- Bearer-токен передаётся только в заголовке, никогда в query.
| Scope | Что открывает | По умолчанию |
|---|---|---|
course: | уроки, эфиры, транскрипты, поиск, прогресс, профиль | да |
profile: | анкета и персональный план | да |
progress: | отметки уроков и шагов плана | нет, включается явно |
tutor: | чтение собственной истории тьютора | нет, включается явно |
mentoring: | личный менторинг (тарифы «С куратором / Лично с Даши») | нет, включается явно |
Подробнее – Авторизация и ключи и OAuth для MCP.
Что может агент#
| Задача | REST | MCP |
|---|---|---|
| Узнать, кто студент, тариф и права ключа | GET | aos_ |
| Найти урок или момент в эфире | GET | aos_ |
| Прочитать урок и транскрипт | GET | aos_, aos_ |
| Подсказать следующий шаг | GET | aos_ |
| Отметить урок и шаг плана | PUT | aos_, aos_ |
| Прочитать личный трек и встречи с ментором | GET | aos_, aos_ |
Тьютор, вложения, диктовка и управление ключами доступны только из кабинета – см. Тарифы и доступ.
С чего начать#
- Быстрый старт – первый запрос за минуту и подключение MCP к Claude, ChatGPT, Claude Code и Codex.
- REST API – все публичные эндпоинты по разделам.
- Инструменты MCP – что умеет агент и какие права нужны.
- Ошибки и Лимиты – как обрабатывать отказы и повторы.
Документация для ИИ#
Каждая страница доступна как markdown: добавьте . к адресу (/), для обзора – /. Кнопка «Скопировать для ИИ» кладёт markdown страницы в буфер, «Открыть в Claude» и «Открыть в ChatGPT» передают ссылку на неё в новый чат. Индекс по стандарту llms.txt – /, вся документация одним файлом – /.