Тема
Инструменты AI-агента: справочник
Полный список того, что умеет AI-агент, подключённый к EasyA. У каждого инструмента — готовый промпт, который можно скопировать в чат, описание и список параметров с допустимыми значениями.
Как подключить агента — Подключение AI-агента (MCP).
Содержание
- Как этим пользоваться
- Диагностика
- Программы обучения
- Словари, слова и теги
- Уроки
- Задания и домашние работы
- Тесты
- Бухгалтерия
- Чего агент не умеет
- Частые вопросы
- Связанные страницы
Как этим пользоваться
Имена инструментов запоминать не нужно. Они приведены для справки — чтобы понимать, что именно сделал агент, и чтобы направить его, если он выбрал не то. В обычной работе достаточно сказать задачу словами: агент сам подберёт инструмент.
Промпты в примерах — рабочие формулировки, а не заклинания. Меняйте имена, даты и числа под себя; агент поймёт и свободный пересказ.
Общие правила у всех инструментов:
- Постраничная выдача. Там, где список может быть длинным, агент листает страницами: по умолчанию 50 записей, максимум 200 за раз. Если ответ обрывается — попросите следующую страницу.
- Даты — в формате
ГГГГ-ММ-ДД. Говорить можно по-человечески («за июль», «с прошлого понедельника») — агент переведёт сам. - Лимиты тарифа действуют так же, как в интерфейсе. Если словарь упёрся в лимит слов, агент получит ту же ошибку, что и вы.
- Часть инструментов помечена как «требует подтверждения» — агент обязан спросить вас перед вызовом, потому что действие видно другим или запускает деньги.
Откуда агент знает, что и в каком порядке делать
При подключении сервер сам рассказывает агенту о себе: присылает список доступных инструментов, описание каждого параметра и правила работы — например, что данные принадлежат только вам, что списки листаются страницами и что видимость заметки нельзя угадывать. Отдельно помечено, какие действия необратимы.
Порядок шагов агент выстраивает сам из этих описаний. Скажем, на просьбу собрать программу он увидит в описании «создать программу», что разделы, темы и содержимое добавляются отдельно, — и выстроит цепочку: создать программу → разделы → темы → наполнить темы теорией.
Что это значит на практике: формулируйте задачу целиком, а не по шагам.
Промпт: «Собери программу «Разговорный английский A2» на 12 тем: разделы «Знакомство», «Еда», «Путешествия», «Работа». В каждой теме — короткая теория с примерами фраз. Покажи структуру перед тем, как создавать.»
Просьба «покажи перед тем, как создавать» полезна на больших задачах: увидите план до того, как в кабинете появятся два десятка тем.
Если агент пошёл не тем путём — поправьте словами («не создавай раздел, положи темы напрямую в программу»). Названия инструментов при этом называть необязательно, но можно: они совпадают с заголовками ниже.
Диагностика
whoami — кто я и что мне доступно
Промпт: «Проверь, под кем ты подключён к EasyA и что тебе доступно.»
Показывает имя, роль, тариф и список групп инструментов, которые открыты на вашем тарифе. Первое, что стоит спросить, если агент говорит, что чего-то не может.
Параметров нет.
Программы обучения
programs_list — список программ
Промпт: «Покажи мои программы обучения. Есть ли что-то про B1?»
Программы учителя и готовые программы платформы, с количеством тем и назначений.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
q | строка | — | любой текст | поиск по названию |
status | строка | — | active, archived | фильтр по статусу |
source | строка | — | own — свои, system — готовые платформы | чьи программы показать |
Плюс постраничная выдача.
program_get — программа целиком
Промпт: «Открой программу «Английский с нуля» и покажи, из каких разделов и тем она состоит.»
Вся структура: разделы, темы и элементы тем. Идентификатор агент возьмёт из списка сам.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
program_id | число | да | id из programs_list | какую программу открыть |
program_statistics — как проходят программу
Промпт: «Как ученики продвигаются по программе «Английский с нуля»?»
Статистика прохождения назначенными учениками и группами.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
program_id | число | да | id из programs_list | по какой программе считать |
program_create — создать программу
Промпт: «Создай программу «Разговорный английский A2», уровень A2, описание — курс на 12 недель для взрослых.»
Создаёт пустую программу. Разделы, темы и содержимое добавляются следом — обычно агент делает это в том же ответе, если попросить сразу «собери программу целиком».
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
name | строка | да | любой текст | название |
description | строка | — | любой текст | описание |
level | строка | — | A1, A2, B1, B2, C1, C2 | уровень по шкале CEFR |
program_section_create — добавить раздел
Промпт: «Добавь в эту программу разделы: «Знакомство», «Еда», «Путешествия».»
Разделы группируют темы. Тему можно создать и без раздела.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
program_id | число | да | id программы | куда добавить |
title | строка | да | любой текст | название раздела |
program_theme_create — добавить тему
Промпт: «В раздел «Еда» добавь темы: «В кафе», «Покупки в супермаркете», «Любимые блюда» — с краткими описаниями.»
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
program_id | число | да | id программы | в какую программу |
title | строка | да | любой текст | название темы |
summary | строка | — | любой текст | краткое описание |
section_id | число | — | id раздела этой же программы | положить в раздел; без него тема будет вне разделов |
theme_element_create — наполнить тему
Промпт: «В тему «В кафе» добавь теорию: как заказать еду, вежливые формы, типичные вопросы официанта. Списком, с примерами фраз.»
Добавляет в тему теорию или блок словаря. Текст пишется в markdown — заголовки, списки, цитаты, жирный, курсив, ссылки сохранятся.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
theme_id | число | да | id темы | куда добавить |
type | строка | да | theory — теория, vocabulary — блок словаря | что за элемент |
title | строка | — | любой текст | заголовок элемента |
markdown | строка | — | текст в markdown | содержимое |
Задание этим инструментом в тему не добавить — он кладёт только теорию и словарные блоки. Для заданий есть отдельный инструмент, theme_exercise_add — см. Задания и домашние работы.
Словари, слова и теги
Теги живут на словах
Теги вешаются на слова вашей библиотеки, а не на карточки учеников. Через карточки их не собрать и не поправить — подробности в Тегах.
dictionaries_list — список словарей
Промпт: «Какие у меня есть словари и сколько в них слов?»
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
q | строка | — | любой текст | поиск по названию |
Плюс постраничная выдача.
words_search — найти слово
Промпт: «Есть ли у меня уже слово reservation? Проверь точным совпадением.»
Промпт: «Покажи слова из словаря «Путешествия B1», у которых нет перевода.»
Поиск по библиотеке. Режим точного совпадения нужен, чтобы проверить наличие слова перед добавлением и не плодить дубли.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
q | строка | — | слово или его часть | что искать |
exact | да/нет | — | true — только слово целиком | точный поиск |
dictionary_id | число | — | id словаря | искать внутри одного словаря |
without_translation | да/нет | — | true | только слова без перевода |
without_transcription | да/нет | — | true | только слова без транскрипции |
Плюс постраничная выдача.
Запрос необязателен, но выборку надо чем-то сузить: словарём или фильтром незаполненности. Без единого условия агент получит отказ — иначе в ответ уехала бы вся библиотека целиком. Фильтры незаполненности отвечают на вопрос «что осталось доделать»: по ним агент находит слова, которым не хватает перевода или транскрипции, и дозаполняет их одним заходом.
Выдача идёт по релевантности: сначала точное совпадение, затем слова, начинающиеся с запроса, затем остальные; внутри группы — по алфавиту. Искомое слово, если оно есть, агент получает первым и не «теряет» его в середине списка.
tags_list — список тегов
Промпт: «Покажи мои теги.»
Ваши теги и системные.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
q | строка | — | любой текст | поиск по названию |
Плюс постраничная выдача.
dictionary_create — создать словарь
Промпт: «Заведи словарь «Путешествия B1» с описанием: лексика для поездок, отели, транспорт.»
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
name | строка | да | любой текст | название |
description | строка | — | любой текст | описание |
words_add — добавить слова пакетом
Промпт: «Добавь в словарь «Путешествия B1» 30 слов по теме аэропорта — с переводом и транскрипцией, и повесь тег travel.»
Главный инструмент наполнения. До 100 слов за один вызов; если попросить больше, агент разобьёт на несколько заходов. Слова, которые уже есть в библиотеке, переиспользуются, а не дублируются, — и при этом дозаполняются: если у слова не хватало перевода или транскрипции, а агент их прислал, они допишутся.
Ваши правки агент не перетирает. Дозаполняются только пустые поля: перевод, который вы вводили руками, останется как есть, даже если агент предложит другой. Озвучку он не трогает вовсе.
Отсюда рабочий сценарий: «пройдись по словарю «Путешествия B1», найди слова без перевода и транскрипции и допиши их» — агент отберёт незаполненные через words_search и дозаполнит этим же инструментом.
Существующие слова не расходуют лимит тарифа: дозаполнение проходит, даже когда библиотека у потолка плана.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
dictionary_id | число | да | id словаря | куда добавлять |
words | список | — | объекты {text, translation, transcription}; text обязателен | сами слова |
tag_ids | список чисел | — | id тегов | повесить теги на все добавленные слова |
tag_create — создать тег
Промпт: «Создай тег «Аэропорт» синего цвета.»
Если тег с таким именем уже есть, агент вернёт существующий и скажет об этом — повторный вызов ничего не сломает.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
name | строка | да | любой текст | название тега |
color | строка | — | цвет в формате #rrggbb, по умолчанию #6c757d | цвет метки |
word_tags_set — заменить теги у слова
Промпт: «У слова boarding pass оставь только теги «Аэропорт» и «Путешествия».»
Заменяет весь набор тегов у слова, а не добавляет к существующим. Пустой список снимает все теги.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
word_id | число | да | id слова | у какого слова |
tag_ids | список чисел | — | id тегов; пустой список снимает все | итоговый набор |
Уроки
lessons_list — расписание
Промпт: «Какие у меня уроки сегодня?»
Уроки за период. По умолчанию — сегодняшние. В ответе сводка: время, статус, с кем и счётчики; подробности — отдельным инструментом.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
from | дата | — | ГГГГ-ММ-ДД, по умолчанию сегодня | начало периода |
to | дата | — | ГГГГ-ММ-ДД, по умолчанию совпадает с from | конец периода |
status | строка | — | planned, in_progress, completed, canceled | фильтр по статусу |
student_id | число | — | id ученика | только уроки с этим учеником |
Плюс постраничная выдача.
lesson_get — карточка урока
Промпт: «Покажи подробности урока с Аней в 15:00 — что там по словам и заметкам.»
Статус, участники, слова урока и заметки. У каждой заметки указана видимость.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
lesson_id | число | да | id из lessons_list | какой урок |
lesson_start — начать урок
Промпт: «Начни урок с Аней.»
Переводит урок в статус «идёт». Пока урок не начат, добавлять на него слова нельзя. Повторный вызов на уже идущем уроке ничего не меняет.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
lesson_id | число | да | id урока | какой урок начать |
lesson_finish — завершить урок
Промпт: «Заверши урок с Аней.»
Требует подтверждения
Завершение запускает списание оплаты по договору — ровно как кнопка в интерфейсе. Агент обязан спросить вас перед вызовом; если он это сделал без вопроса, это ошибка клиента, а не сервера.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
lesson_id | число | да | id урока | какой урок завершить |
lesson_words_add — слова на урок
Промпт: «Добавь на текущий урок слова, которые мы сейчас разобрали: reservation, boarding pass, delayed — с переводом.»
До 50 слов за вызов. Урок должен быть начат. Из этих слов потом собирается тест.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
lesson_id | число | да | id идущего урока | на какой урок |
words | список | — | объекты {text, translation}; text обязателен | сами слова |
student_ids | список чисел | — | id участников; пусто — всем | кому именно на групповом уроке |
lesson_notes_list — заметки урока
Промпт: «Что я записывал на прошлом уроке с Аней?»
Все заметки урока с пометкой видимости: shared — её видит ученик, private_teacher — только вы.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
lesson_id | число | да | id урока | какой урок |
lesson_note_add — записать заметку
Промпт: «Запиши приватную заметку к сегодняшнему уроку с Аней: путает past simple и present perfect, на следующем дать упражнения на разницу.»
Видимость обязательна
У заметки два вида, и агент обязан спросить, какую создать. Молчаливого умолчания нет специально: приватная запись, случайно ставшая общей, — это то, что ученик увидит у себя в карточке урока. Говорите прямо: «сделай приватную» или «сделай общую».
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
lesson_id | число | да | id урока | к какому уроку |
visibility | строка | да | shared — видна ученику; private_teacher — только вам | кто увидит |
markdown | строка | да | текст в markdown | сама заметка |
Задания и домашние работы
Агент собирает задания в ваш банк, ставит их в темы программ, задаёт на дом и помогает разбирать сданное. Оценку при этом всегда ставите вы — агент только записывает то, что вы назвали.
Как выглядит обычная цепочка
Формулируйте задачу целиком, а не по шагам: агент сам сходит за схемой типа, соберёт содержимое и покажет черновик.
Промпт: «Собери задание на past simple: текст на 6 предложений с пропусками, ученик вписывает глагол сам. Покажи, что получилось, и сохрани черновиком.»
Порядок агент выстроит сам: посмотреть банк (exercises_list) → взять схему типа (exercise_types) → создать (exercise_create). Дальше по обстоятельствам — поставить в тему (theme_exercise_add) или задать на дом (homework_assign).
Готовое проверяется до создания. Агент заглядывает в банк перед тем, как собирать новое: у вас может уже лежать подходящее задание, и второе такое же вам не нужно.
exercise_types — типы заданий и их формат
Промпт: «Какие типы заданий ты умеешь собирать?»
Без аргумента — список типов. С аргументом — схема содержимого и рабочий пример именно этого типа. Агент вызывает его сам перед сборкой: формат у каждого типа свой, по памяти его не собрать.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
type | строка | — | код типа из таблицы ниже | схема и пример одного типа |
Агенту доступны 14 типов:
| Код | Название | Автопроверка | Тариф |
|---|---|---|---|
drag_gaps | Пропуски перетаскиванием | да | — |
cloze | Вписать в пропуски | да | — |
dropdown_gaps | Пропуски с выбором | да | — |
choice | Выбор ответа | да | — |
true_false | Верно / неверно | да | — |
matching | Соответствия | да | — |
sentence_builder | Собери предложение | да | — |
ordering | Порядок | да | — |
grouping | Группировка | да | — |
error_correction | Найди ошибку | да | — |
translation | Перевод предложения | подсказка, зачёт ваш | — |
crossword | Кроссворд и филворд | да | премиум |
open_answer | Свободный ответ | нет, проверяете вы | премиум |
oral_answer | Устный ответ | нет, проверяете вы | — |
Типов в EasyA больше: картинка, аудирование и диктант собираются в интерфейсе — им нужны файлы, которых у агента нет.
exercises_list — банк заданий
Промпт: «Что у меня есть готового на past simple?»
Свои задания и витрина платформы. Содержимое не отдаётся — за ним exercise_get.
Витринное задание агент показывает, но скопировать его вам в банк не может — копия делается в интерфейсе. Выдать витринное задание на дом можно и без копии.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
type | строка | — | код типа | только этот тип |
level | строка | — | low, medium, high | сложность |
status | строка | — | draft — черновик, ready — готово к выдаче | архив скрыт по умолчанию |
q | строка | — | подстрока в названии | поиск |
source | строка | — | own — свои, system — витрина платформы | чьи задания |
Плюс постраничная выдача.
exercise_get — задание целиком
Промпт: «Покажи задание «Past simple: неправильные глаголы» полностью.»
Содержимое с эталонами, настройки и список тем, где задание стоит.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
exercise_id | число | да | id из exercises_list | какое задание |
exercise_create — создать задание
Промпт: «Сделай задание «Verbs of movement»: 8 предложений с пропусками, слова перетаскиванием, средняя сложность. Пока черновиком.»
Задание попадает в банк. Чтобы оно оказалось у учеников, его нужно отдельно поставить в тему или задать на дом.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
type | строка | да | код типа | какой тип собрать |
title | строка | да | до 255 символов | название |
content | объект | да | по схеме из exercise_types | содержимое и эталоны |
level | строка | — | low, medium, high; по умолчанию medium | сложность |
instructions | строка | — | текст | инструкция ученику |
status | строка | — | draft (по умолчанию), ready | готовность |
settings | объект | — | ignore_case | не различать регистр при проверке |
Остальные настройки задания — перемешивание вариантов, показ правильных ответов, число попыток — агенту недоступны и меняются в интерфейсе.
exercise_update — изменить задание
Промпт: «В задании «Verbs of movement» поправь третье предложение и переведи его в готовые.»
Правка расходится по всем темам и домашкам
Задание одно на все места, где оно стоит. Уже начатые попытки учеников не меняются — они держат снимок задания на момент запуска. А вот ещё не начатый пункт домашки ссылается на задание по id: ученик откроет его и увидит новое условие.
Тип задания сменить нельзя — для другого типа нужно новое задание. Отправить задание в архив и удалить его агент тоже не может: и то и другое только в интерфейсе.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
exercise_id | число | да | id из exercises_list | какое задание |
title, content, level, instructions, status, settings | — | — | как в exercise_create | что поменять |
theme_exercise_add — поставить задание в тему
Промпт: «Поставь это задание в тему «Прошедшее время» программы «Разговорный A2».»
Либо exercise_id готового задания из банка, либо type и content — тогда задание создаётся и сразу встаёт в тему. Именно этим инструментом задание попадает в тему: theme_element_create кладёт только теорию и словарь.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
theme_id | число | да | id из program_get | в какую тему |
exercise_id | число | — | готовое задание из банка | вместе с ним type и content не нужны |
type, title, content, instructions, level, status | — | — | как в exercise_create | для нового задания |
Выдать ученикам можно только задание в статусе ready.
homework_assign — задать на дом
Промпт: «Задай Ане на дом два задания на past simple с последнего урока.»
Требует подтверждения
Домашка сразу видна ученику. Агент обязан показать, что и кому собирается задать, до вызова.
Домашка привязана к уроку. Пункты добавляются к уже заданным, ничего не стирая; уже заданное повторно не дублируется. Задание должно быть в статусе ready — черновик выдать нельзя.
Чего агент здесь не делает: не дописывает пункты в работу, которую ученик уже сдал или которую вы уже проверили; не заводит текстовый пункт — только упражнения из банка; не ставит срок сдачи, у домашки его нет в принципе. Вернуть работу на доработку и принять её тоже нельзя — это в кабинете.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
lesson_id | число | да | id из lessons_list | к какому уроку |
exercise_ids | список чисел | — | до 20 за вызов | что задать |
student_ids | список чисел | — | пусто — всем участникам урока | кому задать |
homework_get — что задано и что сдано
Промпт: «Что у Ани по домашкам за последние две недели?»
Состав пунктов, сроки, что сдано и что проверено. Смотреть сюда стоит перед тем, как задавать: так одно и то же не уедет дважды.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
homework_id | число | — | id одной работы | конкретная домашка |
student_id | число | — | id ученика | последние работы ученика |
review_queue — очередь на проверку
Промпт: «Что ждёт моей проверки?»
Задания с уроков, домашки и самостоятельная практика в одном списке.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
state | строка | — | pending (по умолчанию), checked, all | что показывать |
context | строка | — | lesson, homework; без него — всё | откуда работы |
student_id | число | — | id ученика | только его работы |
submitted_from / submitted_to | дата | — | ГГГГ-ММ-ДД | когда сдано |
Плюс постраничная выдача, до 100 записей за раз.
submission_get — сданная работа целиком
Промпт: «Покажи, что Аня ответила в задании на past simple.»
Ответы ученика, эталон на момент выдачи и результат автопроверки.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
run_id | число | да | id строки review_queue с kind=exercise_run | какая работа |
Записи устных ответов агенту не отдаются — их слушают в кабинете.
submission_check — балл за работу
Промпт: «Поставь Ане 80 за это задание и напиши: молодец, но проверь третье предложение.»
Балл называете вы
Агент не оценивает работу — он записывает вашу оценку. Если он предлагает балл сам, это его инициатива: соглашайтесь осознанно.
За устный ответ балл не ставится
Расшифровки записи у агента нет, оценить её он не может. Комментарий оставить можно, балл ставится в кабинете после прослушивания.
Если работу успели переоценить, пока агент собирался, вызов честно откажет и предложит перечитать — чужой вердикт молча не затирается.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
run_id | число | да | id строки review_queue с kind=exercise_run | какая работа |
expected_updated_at | строка | да | updated_at из review_queue или submission_get | версия работы |
score_percent | число | — | 0–100; без него засчитывается только комментарий | балл |
comment | строка | — | до 5000 символов | текст видит ученик |
homework_item_check — балл за текстовый пункт домашки
Промпт: «Поставь 90 за письменный ответ во второй домашке Ани.»
Для пунктов домашки, написанных текстом. Пункт-задание так не проверяется — за него отвечает submission_check.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
item_id | число | да | id строки review_queue с kind=homework_item | какой пункт |
score_percent | число | да | 0–100 | балл |
expected_updated_at | строка | да | updated_at из review_queue | версия пункта |
comment | строка | — | до 5000 символов | текст видит ученик |
Тесты
lesson_build_words_test — собрать тест из слов урока
Промпт: «Собери тест по словам сегодняшнего урока.»
Создаёт тест-черновик из слов, добавленных на уроке. Если слов на уроке нет, тест не создастся. Запускать тест ученику — по-прежнему из интерфейса.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
lesson_id | число | да | id урока со словами | из какого урока брать слова |
test_get — состояние теста
Промпт: «Что с тестом, который мы собрали? Аня его прошла?»
Статус, состав и результат, если тест завершён.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
test_id | число | да | id теста | какой тест |
Проходить тест через агента нельзя — это интерфейс ученика.
Бухгалтерия
Вся бухгалтерия у агента только на чтение. Создавать расходы и менять налоговые настройки можно лишь в интерфейсе — см. Бухгалтерию.
accounting_summary — сводка за период
Промпт: «Сколько я заработал в июле? Покажи с налогом и расходами.»
Валовый доход, налог, расходы и чистый остаток. По умолчанию — текущий месяц.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
from | дата | — | ГГГГ-ММ-ДД, по умолчанию первое число текущего месяца | начало периода |
to | дата | — | ГГГГ-ММ-ДД, по умолчанию сегодня | конец периода |
income_report — отчёт по доходам
Промпт: «Разбей мой доход за квартал по ученикам, по месяцам.»
Доходы за период с группировкой и разрезом.
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
from | дата | — | ГГГГ-ММ-ДД | начало периода |
to | дата | — | ГГГГ-ММ-ДД | конец периода |
group_by | строка | — | day, week, month; по умолчанию day | шаг по времени |
breakdown | строка | — | student — по ученикам, group — по группам, subscription — по абонементам, method — по способу оплаты | разрез отчёта |
expenses_list — расходы
Промпт: «Покажи мои расходы за август по категории «Инструменты».»
| Параметр | Тип | Обяз. | Допустимые значения | Зачем |
|---|---|---|---|---|
from | дата | — | ГГГГ-ММ-ДД | начало периода |
to | дата | — | ГГГГ-ММ-ДД | конец периода |
category | строка | — | rent — аренда, marketing — маркетинг, tools — инструменты, other — прочее | фильтр по категории |
Плюс постраничная выдача.
tax_settings_get — налоговый режим
Промпт: «Какой у меня налоговый режим и ставка?»
Параметров нет. Только чтение — менять настройки через агента нельзя.
Чего агент не умеет
Осознанные границы, а не недоделки:
| Область | Что нельзя |
|---|---|
| Расписание | создавать, отменять и переносить уроки — это меняет расчёты по договору |
| Бухгалтерия | заводить расходы, менять налоговые настройки |
| Карточки учеников | работать с ними; агент работает со словами вашей библиотеки |
| Задания | загружать картинки и аудио: картинку, аудирование и диктант собрать нельзя |
| Задания | архивировать и удалять задания; копировать себе задание из витрины платформы |
| Домашка | возвращать работу на доработку и принимать её — это в кабинете |
| Домашка | дописывать пункты в уже сданную или проверенную работу |
| Домашка | заводить текстовый пункт — агент выдаёт только упражнения, хотя оценивать текстовые умеет |
| Проверка | ставить балл за устный ответ — записи агент не слышит |
| Тесты | проходить тест за ученика |
| Удаление | удалять программы, словари, уроки и заметки |
| Ученики и договоры | заводить учеников, менять цены и договоры |
Частые вопросы
Агент говорит, что инструмент недоступен. Скорее всего, нужная возможность не входит в тариф, или список инструментов у клиента устарел после смены тарифа. Спросите «что тебе доступно» — сработает whoami. Если группы нет в списке — дело в тарифе; если есть, а инструмент не виден — переподключите приложение.
Агент придумал слово или перевод. Проверяйте пакетные добавления: агент — языковая модель, и в списке из 50 слов может встретиться неточность. Инструмент words_search с точным совпадением помогает не плодить дубли, но за смысл перевода отвечаете вы.
Можно ли откатить, если агент добавил лишнее? Через агента — нет, удаления у него нет вовсе. Всё правится в интерфейсе обычным способом.
Агент завершил урок без спроса. Инструмент помечен как требующий подтверждения, но соблюдает пометку сам клиент. Если ваш клиент так себя ведёт, включите в нём подтверждение действий — и напишите в поддержку.
Почему агент не видит карточки моих учеников? Их у него нет по устройству: агент работает с библиотекой учителя. Теги живут на словах библиотеки — см. Теги.
Связанные страницы
- Подключение AI-агента (MCP) — как подключить и отключить.
- Банк заданий, Домашние задания и Проверка работ — те же задания, домашки и очередь, только в интерфейсе.
- Программы обучения
- Словари и Теги
- Слова на уроке и Тест из слов урока
- Бухгалтерия
- Активность — там видно все вызовы агента.