Инструмент: 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 |
Обязательно. Идентификатор курса. |
learningStandardIds[] |
Необязательное поле. Ограничивает поиск этими наборами стандартов или стандартами категорий и их дочерними элементами. Передайте идентификатор набора стандартов из |
query |
Обязательно. Поисковые запросы без учета регистра; результаты должны содержать ВСЕ слова, разделенные пробелами, в коде или операторе. - Если |
includeGroupingStandards |
Необязательное поле. Если задано значение true, возвращает заголовки категорий (нельзя добавить в задание), идентификаторы которых сужают последующие поисковые запросы. Если false (по умолчанию), возвращает стандарты, которые можно добавить в учебные материалы. |
Схема вывода
Ответ, содержащий образовательные стандарты.
SearchCourseStandardsResponse
| JSON-представление |
|---|
{
"learningStandards": [
{
object ( |
| Поля | |
|---|---|
learningStandards[] |
Список стандартов, соответствующих запросу. |
LearningGoal
| JSON-представление |
|---|
{
"id": string,
"type": enum ( |
| Поля | |
|---|---|
id |
Только для вывода. Идентификатор учебной цели. Чтобы прикрепить стандарт, используйте |
type |
Только для вывода. Тип учебной цели. |
standardCode |
Только для вывода. Стандартный код (например, "NY-2.NBT.4"). Заполняется только для стандартов. |
title |
Только для вывода. Описание утверждения для стандартов или человекочитаемое название для навыков. |
documentTitle |
Только для вывода. Название документа с учебным планом. Заполняется только для стандартов. |
Тип
Тип учебной цели.
| Перечисления | |
|---|---|
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.courseshttps://www.googleapis.com/auth/classroom.courses.readonly