Narzędzie: create_topic
Tworzy nowy temat na zajęciach. Tematy służą do porządkowania materiałów dydaktycznych. Wymaga roli nauczyciela na zajęciach.
Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP create_topic.
| Żądanie 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 }' |
Schemat wejściowy
Prośba o utworzenie tematu na zajęciach.
CreateTopicRequest
| Zapis JSON |
|---|
{ "courseId": string, "title": string } |
| Pola | |
|---|---|
courseId |
Wymagane. Identyfikator kursu. |
title |
Wymagane. Tytuł tematu. Możesz użyć maksymalnie 100 znaków. |
Schemat wyjściowy
Temat w kursie.
Temat
| Zapis JSON |
|---|
{ "id": string, "title": string } |
| Pola | |
|---|---|
id |
Tylko dane wyjściowe. Identyfikator. Identyfikator tematu. |
title |
Tytuł tematu. |
Adnotacje dotyczące narzędzi
Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy wysłać użytkownikowi prośbę o potwierdzenie.
Oprócz ciągu tytułu zdefiniowane są te wskazówki logiczne:
readOnlyHint: jeśli ma wartość „true”, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: false.destructiveHint: jeśli ma wartość „true”, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodawania. Wartość domyślna: true.idempotentHint: jeśli ma wartość „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: false.openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z elementami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie jest narzędziem typu Otwarty świat, a narzędzie do zapamiętywania – nie.
Wskazówka dotycząca niszczenia: ❌ | Wskazówka dotycząca idempotencji: ❌ | Wskazówka dotycząca tylko do odczytu: ❌ | Wskazówka dotycząca otwartego świata: ❌
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/classroom.topics