Herramienta: create_topic
Crea un tema nuevo en un curso. Los temas se usan para organizar el trabajo en clase. Requiere un rol de profesor en el curso.
En la siguiente muestra de código, se indica cómo usar curl para llamar a la herramienta de MCP create_topic.
| Solicitud de 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 }' |
Esquema de entrada
Solicitud para crear un tema en un curso.
CreateTopicRequest
| Representación JSON |
|---|
{ "courseId": string, "title": string } |
| Campos | |
|---|---|
courseId |
Obligatorio. Es el identificador del curso. |
title |
Obligatorio. Es el título del tema. Debe tener un máximo de 100 caracteres. |
Esquema de salida
Es un tema de un curso.
Tema
| Representación JSON |
|---|
{ "id": string, "title": string } |
| Campos | |
|---|---|
id |
Solo salida. Es el identificador. ID del tema. |
title |
Es el título del tema. |
Anotaciones de herramientas
Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.
Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:
readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.
Sugerencia destructiva: ❌ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ❌ | Sugerencia de mundo abierto: ❌
Alcances de la autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/classroom.topics