Narzędzie: search_course_standards
Wyszukuje standardy nauczania akademickiego na kursie, aby oznaczyć tagiem materiały dydaktyczne lub oceny cząstkowe. Wymaga, aby nauczyciel skonfigurował standardy nauczania na zajęciach.
- Konkretne standardy: wyszukaj według dokładnego kodu (np. „HS-LS1-1”) lub konkretnych słów kluczowych (includeGroupingStandards=false).
- Kategorie: ustaw parametr includeGroupingStandards=true z ogólnym słowem tematycznym, aby znaleźć kategorie nadrzędne, a następnie przekaż identyfikator kategorii do parametru learningStandardIds, aby zawęzić wyniki.
Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP search_course_standards.
| Żą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": "search_course_standards", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Schemat wejściowy
Wyślij prośbę o wyszukiwanie we wstępnie wybranych drzewach standardów nauczania na poziomie kursu.
SearchCourseStandardsRequest
| Zapis JSON |
|---|
{ "courseId": string, "learningStandardIds": [ string ], "query": string, "includeGroupingStandards": boolean } |
| Pola | |
|---|---|
courseId |
Wymagane. Identyfikator kursu. |
learningStandardIds[] |
Opcjonalnie: Ogranicza wyszukiwanie do tych zestawów standardów lub standardów kategorii i ich elementów podrzędnych. Przekaż identyfikator zestawu standardów z |
query |
Wymagane. Wyszukiwane hasła, wielkość liter nie jest rozróżniana. Wyniki muszą zawierać WSZYSTKIE słowa rozdzielone spacjami w kodzie lub instrukcji. – Gdy |
includeGroupingStandards |
Opcjonalnie: Jeśli ma wartość „true”, zwraca nagłówki kategorii (których nie można oznaczyć tagiem materiałów dydaktycznych), których identyfikatory zawężają kolejne wyszukiwania. Jeśli ma wartość false (domyślnie), zwraca standardy, które można oznaczyć w materiałach dydaktycznych. |
Schemat wyjściowy
Odpowiedź zawierająca standardy nauczania.
SearchCourseStandardsResponse
| Zapis JSON |
|---|
{
"learningStandards": [
{
object ( |
| Pola | |
|---|---|
learningStandards[] |
Lista pasujących standardów. |
LearningGoal
| Zapis JSON |
|---|
{
"id": string,
"type": enum ( |
| Pola | |
|---|---|
id |
Tylko dane wyjściowe. Identyfikator celu edukacyjnego. Aby dołączyć standard, użyj |
type |
Tylko dane wyjściowe. Typ celu edukacyjnego. |
standardCode |
Tylko dane wyjściowe. Kod standardu (np. „NY-2.NBT.4”). Wartość jest podawana tylko w przypadku standardów. |
title |
Tylko dane wyjściowe. Opis oświadczenia dotyczącego standardów lub zrozumiały dla człowieka tytuł dotyczący umiejętności. |
documentTitle |
Tylko dane wyjściowe. Nazwa dokumentu programu nauczania. Wartość jest podawana tylko w przypadku standardów. |
Typ
Typ celu edukacyjnego.
| Wartości w polu enum | |
|---|---|
TYPE_UNSPECIFIED |
Nieokreślony typ celu edukacyjnego. |
STANDARD |
Standard nauczania z programu akademickiego. |
SKILL |
Umiejętność reprezentująca koncepcję lub kompetencję edukacyjną. Tylko nauczyciel może dodawać i usuwać umiejętności w Classroom. |
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 destrukcyjności: ❌ | 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.courseshttps://www.googleapis.com/auth/classroom.courses.readonly