Ваша команда
Оркестратор
ID агента-оркестратора
Имя оркестратора
Генерация картинок
Включена
Модель
Статус
—
Кэш провайдеров
—
Уборка мусорных файлов
Сканирует crew-artifacts/ на VPS и удаляет PNG/JPEG-файлы, на которые больше нет ссылок в БД (артефакты чатов, генерации картинок, временные uploads). Из соображений безопасности файлы моложе 24 часов не трогаются.
Авто-уборка
Последний авто-проход
—
Смена пароля
Текущий пароль
Новый пароль
Подтвердите новый пароль
Пользователи
| Имя | Роль |
|---|
Подключите сервис и агенты сами будут им пользоваться
Telegram-бот
Токен бота (BotFather)
Режим сети
ip:port прокси
Сеть
Подключение настроено администратором — ничего менять не нужно.
Подключен: — (@—)
—
Известные чаты
Последние события
Как агенты пользуются ботом
Когда коннектор включен, агенты этого инстанса могут отправлять сообщения, опросы, файлы и управлять чатами через локальный HTTP endpoint на VPS:
POST http://localhost:18794/tg/call
{"tool": "tg.send_message", "params": {"chat_id": 123, "text": "..."}}
Полный список тулов (send_poll, send_media_group, inline_keyboard, edit_message, pin_message, ban/promote участников и т.д.) задокументирован в AGENTS.md и доступен через GET /tg/tools.
ВКонтакте — сообщество
Коннектор публикует посты от имени вашей VK-группы: текст, картинки, опросы. Один коннектор = одна группа. Для нескольких групп — заведите несколько окружений.
Нужны два токена:
— Токен сообщества — для публикации. Админка группы → Управление → Работа с API → Создать ключ доступа (скоупы: wall, photos, docs, polls).
— Пользовательский токен (опционально, но почти всегда нужен) — для удаления/редактирования постов и для публикации с картинками. VK часто режет `photos.*` и `wall.delete`/`wall.edit` с community-токеном. Получить: открой эту OAuth-ссылку под админским аккаунтом группы, нажми «Разрешить» → скопируй весь URL из адресной строки (вида
Прокси не нужен —
Нужны два токена:
— Токен сообщества — для публикации. Админка группы → Управление → Работа с API → Создать ключ доступа (скоупы: wall, photos, docs, polls).
— Пользовательский токен (опционально, но почти всегда нужен) — для удаления/редактирования постов и для публикации с картинками. VK часто режет `photos.*` и `wall.delete`/`wall.edit` с community-токеном. Получить: открой эту OAuth-ссылку под админским аккаунтом группы, нажми «Разрешить» → скопируй весь URL из адресной строки (вида
https://oauth.vk.com/blank.html#access_token=…&expires_in=0&user_id=…) и вставь в поле ниже — платформа сама вытащит токен, срок и id автора. Scope'ы: wall, photos, groups, offline (offline = бессрочный).
Прокси не нужен —
api.vk.com в РФ не блокирован.
ID группы
Токен сообщества
User access token
(для delete/edit)
(для delete/edit)
API version
Недавние публикации
Как агенты публикуют в VK
Когда коннектор подключён, агенты могут публиковать посты через локальный HTTP endpoint на VPS:
POST http://localhost:18794/vk/call
{"tool":"vk.wall_post","params":{"message":"Привет!","photo_urls":["https://..."]}}
Полный список тулов: vk.wall_post, wall_edit, wall_delete, wall_pin, wall_unpin, resolve_group, get_recent_posts.
Агент находит их сам через tools.search.
CloudText — публикация заданий и тестов
Коннектор логинится на lk.cloudtext.ru под вашей учётной записью и даёт агентам возможность создавать задания, тесты и опросники прямо из чата. Поддерживаются все 7 типов блоков CloudText: материалы, развёрнутый/краткий ответ, одиночный/множественный выбор, голосовой, шкала.
У CloudText нет публичного API, поэтому мы используем ваши логин и пароль — Playwright входит в кабинет, получает cookies, дальше всё идёт через обычный HTTP. Пароль хранится зашифрованным (ChaCha20-Poly1305), ключ — отдельная переменная окружения на бридже.
У CloudText нет публичного API, поэтому мы используем ваши логин и пароль — Playwright входит в кабинет, получает cookies, дальше всё идёт через обычный HTTP. Пароль хранится зашифрованным (ChaCha20-Poly1305), ключ — отдельная переменная окружения на бридже.
Email от cloudtext.ru
Пароль
Подключен: —
Последний вход: —
Пресеты
Пресет = пакет умолчаний (папка, предмет, флаги) + подсказка агенту как собирать задание. Агент вызывает
cloudtext.create_task(preset="slug", …), не придумывая каждый раз куда класть и в каком тоне.
Папки в CloudText
Превью структуры раздела «Материалы». Используется для привязки пресетов и как подсказка агентам.
История публикаций
Каталог инструментов
Единый реестр инструментов коннекторов (RFC-004). Поиск — семантический, multilingual-MiniLM, ~1–3ms/запрос. Индекс живёт в
data/tools_index.sqlite3.
Все инструменты по коннекторам
Задачи
Планировщик
Отложенные и периодические задачи
Библиотека
Генерация картинок
Пишите промпт — получаете картинку. Не понравилось — редактируете доп-промптом.
—
⚠ Генерация картинок отключена администратором платформы. Форма ниже не сработает, пока функция не будет включена обратно в «Настройки → Платформа».
Текущая модель не поддерживает редактирование картинок — прикрепить изображение нельзя. Чтобы редактировать, попроси админа выбрать другую модель в Настройках → Платформа.
📎 Можно или перетащить сюда — тогда промпт станет инструкцией к их редактированию (несколько картинок будут использованы как референсы).
Режим: редактирование. Опишите, что изменить.
Идёт генерация — 20-60 секунд…
Последний результат
История генераций
📚 База знаний
Активность
Создание, удаление, смена моделей агентов и другие длительные операции. Хранятся 7 дней.
Загрузка…
Как пользоваться
💬 Чат с командой
1️⃣ Напишите что вам нужно обычным языком
«Подготовь исследование про историю чая»
2️⃣ Оркестратор распределит задачу между агентами
3️⃣ Результат появится прямо в чате
4️⃣ Хотите файл? Скажите «заверни в docx»
@ Обращение к конкретному агенту
Введите @ и начните набирать имя — появится подсказка
@Исследователь найди факты про...
@Юрист проверь этот договор
Без @ — задача уйдёт оркестратору, и он сам решит кому поручить
📑 Вкладки чатов
+ — новый чат (каждый с чистого листа)
Правый клик на вкладку — переименовать, сменить цвет, удалить
Разные вкладки = разные разговоры. Агенты не помнят что было в другом чате
📎 Файлы
Загрузить: перетащите файл в окно или нажмите 📎
Скачать: нажмите на ссылку 📄 в чате
Библиотека: все файлы в одном месте — вкладка «Библиотека»
⚡ Готовые сценарии
Вкладка Задачи — готовые цепочки работы
Нажмите «Запустить» → заполните параметры → команда выполнит
Исследование → Статья, Перевод → Редактура, Юр. проверка
⏰ Планировщик
Вкладка Планировщик — задачи по расписанию
Выберите агента, опишите задачу, укажите частоту
«Каждый день собирай дайджест новостей по теме X»
🤖 Управление агентами
Вкладка Агенты — ваша команда
Добавить: «+ Добавить агента» → выберите роль из 20 вариантов
Настроить: кликните на карточку агента
Скиллы: вкладка «Скиллы» в редакторе — добавляйте возможности
💡 Советы
Чем конкретнее запрос — тем лучше результат
Не нравится? Скажите что не так — агент переделает
Введите /help в чате — список всех агентов
Агент отвечает на английском? Напишите «отвечай на русском»
✈️
Бот в Телеграме — ваш агент на связи 24/7
Агенты могут читать и отправлять сообщения, делать опросы, постить файлы — всё от имени вашего бота.
ℹ️ Эта секция подразумевает, что бот уже подключён в разделе Настройки → Коннекторы. Если нет — начните оттуда.
🏠 Шаг 1 — Добавьте бота в группу
Если вы хотите, чтобы бот отправлял сообщения, опросы или файлы в существующий групповой чат — его нужно пригласить туда как обычного участника.
- Откройте нужный групповой чат в Телеграме.
- Тапните по названию чата сверху → попадёте в «Информация о группе».
- Нажмите «Добавить участника» (или «Add Members»).
- В поиске введите
@ваш_бот— имя покажет Настройки → Коннекторы → Подключен. - Выберите бота из подсказки и подтвердите добавление.
⚠️ Если Телеграм говорит «этот бот не может быть добавлен» — проверьте в настройках бота у @BotFather:
/setjoingroups → Enable.
🔑 Шаг 2 — Выдайте боту нужные права
По умолчанию бот в группе — обычный участник. Он может отправлять сообщения, но не может закреплять их, создавать опросы с ограничениями, удалять чужие сообщения и т.д. Для полноценной работы сделайте бота администратором.
- Откройте информацию о группе (тап по названию сверху).
- Раздел «Администраторы» → «Добавить администратора».
- Найдите бота в списке.
- Включите нужные права (рекомендуем все из списка ниже):
✅ Обязательно включите
- Удаление сообщений
- Закрепление сообщений
- Приглашение участников по ссылке
- Управление опросами
🟡 Включайте по желанию
- Блокировка пользователей (бан)
- Назначение администраторов
- Изменение информации группы
💡 Для каналов: процесс тот же, но права называются чуть иначе — обязательно дайте «Публикация сообщений» и «Изменение сообщений».
🎯 Что умеет ваш бот — основные сценарии
Говорите агенту в чате Crew обычным языком — он сам выберет нужный инструмент в Телеграме.
💬
Отправить сообщение
Простой текст или объявление в канал/группу.
Вы: «Напиши в рабочий чат: завтра стендап в 10:00»
В Телеграме появится:
«Завтра стендап в 10:00»
«Завтра стендап в 10:00»
📊
Опрос в группу
Собрать мнение по вариантам. Можно сделать викторину с правильным ответом.
Вы: «Сделай опрос в команде: когда удобно созвониться — сейчас, через час, вечером, завтра?»
В Телеграме появится интерактивный опрос:
Когда удобно созвониться?
◯ Сейчас
◯ Через час
◯ Вечером
◯ Завтра
Анонимное голосование · 0 голосов
📸
Фото с подписью
Одна картинка + текст-комментарий.
Вы: (приложите фото) «Опубликуй в канал вакансий с подписью "Наша новая кофейня открылась на Ленина 5 — заходите!"»
В Телеграме: фото, под ним подпись.
📎
Прикрепить файл
PDF, Word, Excel, архив — до 50 МБ.
Вы: «Отправь отчёт в чат с клиентом» (и приложите файл в Crew)
🖼️
Альбом из нескольких фото
2–10 картинок одним сообщением.
Вы: «Сделай подборку из этих 5 фото в канал»
📌
Закрепить важное
Сообщение будет сверху чата у всех участников.
Вы: «Напиши в чат что в пятницу выходной и закрепи наверху»
✏️
Поправить / удалить сообщение
Если в отправленном сообщении опечатка или оно больше не актуально.
Вы: «Удали последнее что отправлял в рабочий чат» · «Поправь время: не 10:00 а 11:00»
🎯 Как агент понимает, в какой именно чат отправить
У вас может быть несколько групп с ботом. Чтобы агент не путался, называйте чат так, как он у вас в Телеграме:
- «в рабочий чат»
- «в группу «Проект X»»
- «в канал новостей»
- «мне в личку» (если пишете боту напрямую)
Агент посмотрит список известных боту чатов (они появляются после первого взаимодействия) и сопоставит. Если не уверен — переспросит.
💡 Совет: первый раз после добавления бота в группу — напишите что-нибудь сами в этой группе (хоть «привет»). Тогда бот её увидит. До этого момента для него эта группа не существует.
✨ Что ещё можно собрать — идеи на платформе
Телеграм — не отдельная фича, а часть всей платформы. Вот несколько реальных сценариев:
⏰
Регулярные посты в канал по расписанию
Вкладка Планировщик → создайте задачу: «Каждое утро в 9:00 выкладывай в канал следующий пост из этого списка». Агент по очереди берёт один из ваших заготовленных текстов и публикует.
🔔
Дайджест новостей по понедельникам
Попросите Исследователя каждый понедельник в 8:00 собирать новости по вашей теме и публиковать краткий обзор в рабочую группу. Настраивается одним окном планировщика.
📊
Еженедельный опрос команды
«Каждую пятницу в 15:00 запускай опрос «Как прошла неделя?» с вариантами: «огонь», «нормально», «тяжёлая». Присылай мне сводку результатов в понедельник утром».
📢
Быстрая рассылка клиентам
«Напиши такой-то текст во все мои группы с клиентами». Агент пройдёт по списку известных чатов и отправит.
📑
Автоматическая публикация отчётов
Аналитик собрал отчёт → Редактор подготовил краткую выжимку → агент отправил PDF-файл + выжимку в группу руководства. Всё одной фразой в чате Crew.
🎓
Викторины для учеников
«Сделай в группе 11-Б викторину по истории за эту неделю, 5 вопросов». Агент создаст квиз с правильными ответами и объяснениями.
⚙️ Что ещё доступно (кратко)
🎭 Стикеры и эмодзи-анимации (🎲 🎯 🏀 🎳) — «кинь кубик»
🎤 Голосовые сообщения — если хотите аудио, а не текст
🎬 Видео и GIF-анимации — «пошли смешное видео»
📍 Геолокации и места — «кинь точку, куда приезжать»
👤 Контакты — «поделись контактом с группой»
🔗 Ссылки-приглашения — «создай ссылку в чат с лимитом 10 человек на сутки»
🛡️ Модерация — забан, мут, выдать админку
⌨️ Inline-кнопки — сообщения с кликабельными вариантами
🤔 Если что-то идёт не так
Бот не отправил сообщение? Проверьте в Настройки → Коннекторы, статус бота должен быть зелёным. Если красный — нажмите «Запустить».
Не может закрепить / удалить? Бот не админ в этой группе. Вернитесь на Шаг 2.
Не знает в какой чат отправить? Вы, скорее всего, ещё ничего не писали в этом чате после добавления бота. Напишите любое сообщение в группе — бот её увидит.
Сказал «не могу отправить в чат X»? Возможно, вы имели в виду чат с похожим названием. Попробуйте написать полное название или «в группу N».
🅥
ВКонтакте — публикация в вашу группу
Агенты могут публиковать посты, картинки, опросы от имени вашего сообщества во ВКонтакте. Редактировать, закреплять, удалять — тоже.
ℹ️ Эта инструкция подразумевает, что группа уже создана во ВКонтакте и вы — её администратор. Если нет — сначала создайте группу на vk.com/groups.
🔑 Шаг 1 — Создайте ключ доступа сообщества
Токен сообщества — это «пропуск», который разрешает платформе писать от имени группы. Он хранится только у вас и никуда не уходит наружу.
- Откройте вашу группу ВКонтакте.
- Справа — блок «Управление» (или три точки «⋯» в мобилке → «Управление»).
- В боковом меню: Работа с API → вкладка Ключи доступа.
- Нажмите «Создать ключ».
- Выдайте права (отметьте галочки):
✅ Обязательно включите
- Сообщения сообщества (wall)
- Фотографии
- Документы
- Управление сообществом
🟡 По желанию
- Видео (если нужны видеопосты)
- Опросы / Stories / Market
- Нажмите «Создать», потом «Показать ключ» и скопируйте длинную строку (
vk1.a.XXXX...).
⚠️ Этот токен — как пароль. Не отправляйте его в переписках, не размещайте в публичных репозиториях. Если утечёт — в той же вкладке можно отозвать и создать заново.
🔢 Шаг 2 — Узнайте ID группы
Это число, которое уникально идентифицирует вашу группу. Нам нужно именно число, не красивый адрес типа
my_group.
- Зайдите в Управление → Настройки → Основное.
- Внизу страницы видите адрес вашей группы:
vk.com/public12345678илиvk.com/club12345678. - Число после
public/club— это ваш ID группы.
💡 Если у группы красивый адрес (
vk.com/my_awesome_group) — зайдите в неё, откройте «Информацию» или «Статистику», там в URL будет виден числовой id.
🔌 Шаг 3 — Подключите коннектор в платформе
- В платформе: Настройки → Коннекторы → ВКонтакте.
- Вставьте ID группы (число из Шага 2).
- Вставьте токен сообщества (из Шага 1).
- Нажмите «Проверить» — платформа обратится к VK и покажет название группы. Если получили ошибку — проверьте что токен и ID корректны.
- Нажмите «Подключить» — коннектор активен, агенты могут публиковать.
🎯 Что умеет делать платформа — основные сценарии
Говорите агенту в чате обычным языком — он сам выберет нужный инструмент VK.
📝
Опубликовать текстовый пост
Прилетит в стену группы моментально, выглядит как обычный пост от имени сообщества.
💬 Вы говорите: «Напиши небольшой анонс про осенний митап и выложи в нашу группу ВК»
→ Агент сам сформулирует пост, запостит на стену, пришлёт вам ссылку на публикацию.
🖼️
Опубликовать пост с фото
Можно дать агенту URL картинки (агент сам найдёт в Википедии или сделает через web search), или приложить файл в чат Crew — агент загрузит в VK и прикрепит.
💬 Вы говорите: «Выложи в вк пост про зимний Байкал с красивой фотографией»
→ Агент напишет текст, найдёт картинку, загрузит в VK, прикрепит к посту.
📊
Пост с опросом
От 2 до 10 вариантов ответа. Анонимный или открытый, с одним или несколькими вариантами ответа.
💬 Вы говорите: «Запости в вк опрос: какой день для следующей встречи удобнее — пятница, суббота или воскресенье? Анонимный»
→ Агент создаст опрос в VK, прикрепит к посту, опубликует.
✏️
Отредактировать / закрепить / удалить
Агент помнит недавние публикации (видно в «Настройки → Коннекторы → ВКонтакте → Недавние публикации»), может поправить текст или снести пост, если передумали.
💬 Вы говорите: «Закрепи последний пост сверху» / «Удали вчерашний пост про митап» / «Поправь опечатку в посте про Байкал — было "лёд", надо "лёд." с точкой»
→ Агент найдёт нужный пост (по контексту или в «Недавних публикациях»), применит изменение.
⚠️ Что НЕ умеет (пока)
- Реакции и комментарии — платформа не читает, что пишут в комментариях к постам. Мы это добавим отдельной фичей позже, если будет спрос.
- Inline-кнопки под постами — в VK их нет вообще (это возможно только в Telegram-ботах). Если хотите дать ссылку «Читать далее» — просто впишите URL в текст, VK сам развернёт preview.
- Прямые сообщения в личку сообщества — пока не трогаем (нужен Callback API с публичным URL).
- Истории (Stories) — нет в первой версии.
🔧 Если что-то пошло не так
❌ «Too many requests» (ошибка 6)
Платформа сама подождёт и повторит. Если постоянно — это лимит VK: ≈150 постов в сутки на сообщество. Реже.
❌ Токен не принимается
В админке группы → «Работа с API» → «Ключи доступа» → отозвать старый, создать новый с нужными правами, обновить в платформе.
❌ «Access denied: no permission»
Токен создан без нужного права. Создайте новый и отметьте «Сообщения сообщества» + «Фотографии» + «Опросы».
❌ Агент промахнулся текстом
Попросите отредактировать: «Поправь последний пост — убери упоминание цены» — агент найдёт свой пост в истории и отредактирует.
📚
CloudText — задания, тесты, опросники из чата
Вы описываете задачу словами, агент собирает её в формат CloudText и публикует в нужную папку. Ученики получают готовое задание по ссылке.
ℹ️ Перед началом
Этот гайд предполагает, что у вас есть учётная запись на lk.cloudtext.ru и вы в ней уже работаете — создаёте задания вручную, раздаёте ссылки ученикам. Если нет — сначала зарегистрируйтесь там и освойте базовый рабочий процесс, платформа только упрощает повторяемые шаги.
У CloudText нет открытого API. Мы заходим на сайт вашими логином и паролем через headless-браузер, собираем session-cookies и дальше общаемся с ним напрямую. Пароль на бридже зашифрован (ключ хранится отдельно). Никто кроме вашего инстанса платформы к нему не имеет доступа.
У CloudText нет открытого API. Мы заходим на сайт вашими логином и паролем через headless-браузер, собираем session-cookies и дальше общаемся с ним напрямую. Пароль на бридже зашифрован (ключ хранится отдельно). Никто кроме вашего инстанса платформы к нему не имеет доступа.
🔌 Шаг 1. Подключение
- Откройте Настройки → Коннекторы → CloudText.
- Введите email и пароль от вашего аккаунта на cloudtext.ru. Это те же учётные данные, которыми вы заходите в кабинет.
- Нажмите Подключить. Браузер платформы ~10 секунд логинится в ваш кабинет и сохраняет cookies. При успехе появится зелёная точка и «Подключен: ваш email».
- Если сессия потом протухнет (CloudText выкидывает раз в несколько дней) — агент сам запустит повторный вход. Можно и вручную: кнопка ↻ Обновить сессию.
⚠️ 2FA не поддерживается пока. Если в вашем аккаунте включена двухфакторка — зайдите без неё или заведите отдельный учительский аккаунт без 2FA.
🎯 Шаг 2. Пресеты — ваша заготовка для типовых заданий
Пресет — это набор умолчаний плюс подсказка агенту, как собирать задание. Один пресет = один типовой сценарий. Например:
- история_ЕГЭ_Даша — папка «20 задания ЕГЭ», предмет «История ЕГЭ», тон «сжатый, академический», 10 вопросов по умолчанию.
- опрос_обратной_связи — папка «Обратная связь», только блоки-шкалы и развёрнутые.
- домашка_литература — папка «ДЗ 10Б», предмет «Литература», краткий ответ + развёрнутый.
После подключения в панели появится раздел «Пресеты». Две шаблонных заготовки создадутся автоматически (
базовый, история_ЕГЭ), остальные вы заводите под свои предметы.
💡 Совет: один раз потратьте 2 минуты на настройку одного пресета под свой основной предмет — и дальше в чате достаточно сказать «сделай тест по X», агент сам положит в нужную папку в нужном стиле.
💬 Шаг 3. Как просить агента адекватно
Агент собирает задание в формате CloudText из того, что вы скажете. Чем конкретнее формулировка — тем меньше уточнений потребуется.
✅ Хорошая формулировка
Альфа, сделай тест на 10 вопросов по теме «Реформы Петра I», используй пресет история_ЕГЭ_Даша. Пять вопросов — краткий ответ (даты и имена), пять — единичный выбор (4 варианта, один правильный). Добавь первым блоком справочные материалы на 2 абзаца. Покажи мне список вопросов перед публикацией.
→ Агент дёрнет estimate_task, покажет разбивку, дождётся подтверждения, опубликует, отдаст ссылки edit/share.
❌ Плохая формулировка
сделай что-нибудь по истории
→ Агент задаст 5 уточнений (тема? класс? тип заданий? сколько? куда положить?) — быстрее самой сформулировать полноценный запрос.
Что стоит включать в запрос:
- Тема — конкретно («реформы Петра I», а не «история»).
- Количество вопросов числом («10 вопросов», не «немного»).
- Типы блоков — краткий ответ / единичный выбор / развёрнутый / шкала. Если не знаете — скажите «разные», агент подберёт.
- Папку (если не в пресете) — «в папку 20 задания ЕГЭ», либо «где обычно».
- Флаги — «покажи правильные ответы после сдачи», «нельзя пересдавать», «дедлайн — пятница в 20:00».
- «Покажи перед публикацией» — если хотите вычитать разбивку прежде чем агент отправит.
📐 Какие типы заданий поддерживаются
| Тип | Как просить | Что получается |
|---|---|---|
| Материалы | «добавь вступительный блок», «справочник по теме» | Текстовый блок для чтения без вопросов. |
| Развёрнутый ответ | «пусть напишут эссе», «развёрнутый», «аргументируй» | Ученик печатает текст, вы оцениваете по критериям. |
| Краткий ответ | «в одно слово», «название, дата, формула» | Поле ввода, автопроверка по списку правильных вариантов (включая опечатки). |
| Единичный выбор | «выбрать один», «тест с вариантами», «radio» | 4-5 вариантов, один правильный, автоматический балл. |
| Множественный выбор | «выбери все правильные» | Несколько правильных ответов, можно раздать балл за каждый. |
| Голосовой ответ | «пусть запишут голосом» | Ученик записывает аудио, вы оцениваете по критериям. |
| Шкала | «оцени от 1 до 10», «насколько согласен» | Ползунок min-max с подписями краёв. Для опросов обратной связи. |
🧪 Проверка перед публикацией
Скажите агенту «покажи мне что получилось прежде чем публиковать» — он вызовет estimate_task (локальная валидация, не трогает CloudText) и покажет разбивку:
Задание «ЕГЭ-20 Пётр I vs Александр II» — Папка: 20 задания ЕГЭ (id=1234) — Блоков: 11 • 1 справочный • 5 кратких ответов • 5 единичного выбора — Сумма баллов: 10 Всё валидно. Опубликовать?Только после вашего «да» агент дёрнет create_task и выложит в CloudText.
🎬 Типовые сценарии
1. Быстрый тест ЕГЭ
Вы: «Сделай тест на 10 вопросов по теме "Восстание декабристов", пресет история_ЕГЭ_Даша, все — краткий ответ».
Альфа собирает 10 блоков type=2, показывает разбивку, по вашему «да» публикует. Возвращает ссылку на edit и share.
2. Опрос обратной связи
Вы: «Нужен опрос после урока: 3 шкалы (понятность, интерес, сложность — 1-5) и одно развёрнутое "что было самое сложное". Без показа ответов. Папка Обратная связь».
Альфа собирает 4 блока (3× type=6 + 1× type=1), флаг show_answers=false, публикует.
3. Домашка с разными типами
Вы: «Домашка на пятницу по "Слову о полку Игореве": справка 2 абзаца, потом 5 кратких ответов, 3 единичного выбора, 1 развёрнутое эссе на 15 минут. Папка ДЗ 10Б. Дедлайн пятница 20:00, нельзя пересдавать».
Альфа собирает 10 блоков разных типов, deadline_at в int seconds, can_repeated=false, публикует.
4. Доработка существующего задания
Вы: «В задании №1234 поменяй дедлайн на понедельник 18:00 и убери правильные ответы из показа».
Альфа читает задание через get_task, меняет только два флага, update_task (merge-mode, остальное не трогает).
⚠️ Ограничения
- Картинки в вопросах не загружаются автоматически. Пока описывайте визуальное текстом или добавляйте их вручную через CloudText UI по edit-ссылке.
- Разделы «Работы» и «Ученики» не используем. Проверка ответов и управление группами — через родной UI CloudText.
- Маркетплейс — нет. Только ваш личный контент.
- Один аккаунт = один env. Если у вас два аккаунта CloudText — заведите два окружения.
- Если изменится форма логина или появится CAPTCHA — сломается. Мы зависим от стабильности их SPA. Напишите админу — починим.
🔧 Troubleshooting
Session expired / красная точка
Cookies протухли. Кнопка «↻ Обновить сессию» — Playwright зайдёт снова. Если не помогло — проверьте, не поменялся ли пароль.
invalid_spec от коннектора
Агент собрал задание в неправильном формате (чаще всего: у варианта выбора нет правильного ответа). Попросите переделать с конкретикой: «в вопросе №3 правильный ответ — вариант B».
folder_not_found
Папка в пресете удалена или переименована. Откройте пресет, нажмите «Подтянуть папки», привяжите заново.
Задание создалось, но не опубликовано
Эндпоинт публикации сейчас в фазе проверки. Откройте edit_url в CloudText и нажмите «Отправить задание» руками. После уточнения эндпоинта — пофиксим автоматом.
🔧
В разработке