Инструмент: create_topic
Создает новую тему в курсе. Темы используются для упорядочивания заданий. Требуется роль преподавателя на курсе.
В примере кода ниже показано, как использовать curl для вызова инструмента MCP create_topic.
| Запрос 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": "create_topic", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Схема ввода
Запрос на создание темы в курсе.
CreateTopicRequest
| JSON-представление |
|---|
{ "courseId": string, "title": string } |
| Поля | |
|---|---|
courseId |
Обязательно. Идентификатор курса. |
title |
Обязательно. Название темы. Максимальное количество символов: 100. |
Схема вывода
Тема курса.
Тема
| JSON-представление |
|---|
{ "id": string, "title": string } |
| Поля | |
|---|---|
id |
Только для вывода. Идентификатор. Идентификатор темы. |
title |
Название темы. |
Аннотации инструментов
Аннотации инструментов отправляются клиентам 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.topics