MCP Tools Reference: classroommcp.googleapis.com

כלי: 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

string

חובה. המזהה של הקורס.

learningStandardIds[]

string

אופציונלי. הגבלת החיפוש לקבוצות מדדי ההערכה או לקטגוריות של מדדי ההערכה האלה ולמדדי ההערכה שמשויכים אליהם. צריך להעביר מזהה של קבוצת מדדי הערכה מ-Course.learning_goals (ב-list_courses) או מזהי קטגוריות מקריאה קודמת עם includeGroupingStandards = true (לא standardCode), אבל לא את שניהם. אם השדה ריק, החיפוש יתבצע בכל הסטנדרטים בקורס.

query

string

חובה. מונחי חיפוש לא תלויי-רישיות. התוצאות חייבות להכיל את כל המילים שמופרדות ברווחים בקוד או בהצהרה שלהן. - When includeGroupingStandards = false: pass an exact standard code (e.g. "HS-LS1-1") or 2-3 specific keywords (e.g. "area triangles"). - כש-includeGroupingStandards = true: מעבירים 1-2 מילים רחבות של דומיין (למשל "גיאומטריה") שתואמות לשמות הקטגוריות.

includeGroupingStandards

boolean

אופציונלי. אם הערך הוא True, הפונקציה מחזירה כותרות של קטגוריות (שאי אפשר לתייג לעבודות) שהמזהים שלהן מצמצמים את החיפושים הבאים. אם הערך הוא false (ברירת המחדל), הפונקציה מחזירה סטנדרטים שאפשר לתייג בעבודות.

סכימת הפלט

תשובה שמכילה דרישות לימודיות.

SearchCourseStandardsResponse

ייצוג ב-JSON
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
שדות
learningStandards[]

object (LearningGoal)

רשימת התקנים התואמים.

LearningGoal

ייצוג ב-JSON
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
שדות
id

string

פלט בלבד. המזהה של יעד הלמידה. כדי לצרף סטנדרט, צריך להשתמש ב-id מ-search_course_standards (ולא ב-standardCode).

type

enum (Type)

פלט בלבד. סוג יעד הלמידה.

standardCode

string

פלט בלבד. קוד סטנדרטי (למשל, "NY-2.NBT.4"). מאוכלס רק עבור תקנים.

title

string

פלט בלבד. תיאור ההצהרה של הסטנדרטים, או כותרת קריאה לאנשים של המיומנויות.

documentTitle

string

פלט בלבד. שם מסמך תוכנית הלימודים. מאוכלס רק עבור תקנים.

סוג

סוג יעד הלמידה.

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED סוג יעד הלמידה לא צוין.
STANDARD דרישה לימודית מתוכנית לימודים אקדמית.
SKILL מיומנות שמייצגת מושג או יכולת חינוכיים. רק מורים יכולים להוסיף או להסיר מיומנויות ב-Classroom.

הערות לגבי הכלים

הערות לגבי כלים נשלחות ללקוחות 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.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly