MCP Tools Reference: classroommcp.googleapis.com

Инструмент: search_course_standards

Поиск образовательных стандартов в курсе, чтобы добавить их в задания или критерии оценки. Для этого в курсе должны быть настроены образовательные стандарты.

  • Конкретные стандарты. Поиск по точному коду (например, "HS-LS1-1") или определенным ключевым словам (includeGroupingStandards=false).
  • Категории. Задайте includeGroupingStandards=true с широким тематическим словом, чтобы найти родительские категории, а затем передайте идентификатор категории в learningStandardIds, чтобы сузить результаты.

В примере кода ниже показано, как использовать curl для вызова инструмента MCP search_course_standards.

Запрос cURL
curl --location 'https://classroommcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_course_standards",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Запрос на поиск в предварительно выбранных деревьях образовательных стандартов на уровне курса.

SearchCourseStandardsRequest

JSON-представление
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
Поля
courseId

string

Обязательно. Идентификатор курса.

learningStandardIds[]

string

Необязательное поле. Ограничивает поиск этими наборами стандартов или стандартами категорий и их дочерними элементами. Передайте идентификатор набора стандартов из Course.learning_goals (в list_courses) или идентификаторы категорий из предыдущего вызова с includeGroupingStandards = true (не standardCode), но не оба. Если оставить поле пустым, поиск будет выполняться по всем стандартам курса.

query

string

Обязательно. Поисковые запросы без учета регистра; результаты должны содержать ВСЕ слова, разделенные пробелами, в коде или операторе. - Если includeGroupingStandards = false, передайте точный стандартный код (например, "HS-LS1-1") или 2–3 ключевых слова (например, "площадь треугольника"). - Если includeGroupingStandards = true, передайте 1–2 слова, описывающих предметную область (например, "геометрия"), которые соответствуют названиям категорий.

includeGroupingStandards

boolean

Необязательное поле. Если задано значение true, возвращает заголовки категорий (нельзя добавить в задание), идентификаторы которых сужают последующие поисковые запросы. Если false (по умолчанию), возвращает стандарты, которые можно добавить в учебные материалы.

Схема вывода

Ответ, содержащий образовательные стандарты.

SearchCourseStandardsResponse

JSON-представление
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
Поля
learningStandards[]

object (LearningGoal)

Список стандартов, соответствующих запросу.

LearningGoal

JSON-представление
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
Поля
id

string

Только для вывода. Идентификатор учебной цели. Чтобы прикрепить стандарт, используйте id из search_course_standards (не standardCode).

type

enum (Type)

Только для вывода. Тип учебной цели.

standardCode

string

Только для вывода. Стандартный код (например, "NY-2.NBT.4"). Заполняется только для стандартов.

title

string

Только для вывода. Описание утверждения для стандартов или человекочитаемое название для навыков.

documentTitle

string

Только для вывода. Название документа с учебным планом. Заполняется только для стандартов.

Тип

Тип учебной цели.

Перечисления
TYPE_UNSPECIFIED Тип учебной цели не указан.
STANDARD Образовательный стандарт из учебной программы.
SKILL Навык, представляющий собой образовательную концепцию или компетенцию. Добавлять и удалять навыки в Классе могут только преподаватели.

Аннотации инструментов

Аннотации инструментов отправляются клиентам MCP, чтобы описать основные риски, связанные с определенным инструментом. Большинство клиентов считают эти подсказки ненадежными, но их можно использовать, чтобы решить, когда пользователю может быть отправлен запрос на подтверждение.

Помимо строки заголовка, определены следующие логические подсказки:

  • readOnlyHint: если задано значение true, инструмент не изменяет свою среду. Значение по умолчанию – false.
  • destructiveHint: если задано значение True, инструмент может выполнять деструктивные действия. Если false, то инструмент может выполнять только действия по добавлению. Значение по умолчанию: true.
  • idempotentHint. Если задано значение True, повторный вызов инструмента с теми же аргументами не будет иметь дополнительного эффекта. Значение по умолчанию – false.
  • openWorldHint: если задано значение true, инструмент может взаимодействовать с "открытым миром" внешних объектов. Если false, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Области авторизации

Требует одной из следующих областей применения OAuth:

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly