כלי: 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 |
חובה. המזהה של הקורס. |
learningStandardIds[] |
אופציונלי. הגבלת החיפוש לקבוצות מדדי ההערכה או לקטגוריות של מדדי ההערכה האלה ולמדדי ההערכה שמשויכים אליהם. צריך להעביר מזהה של קבוצת מדדי הערכה מ- |
query |
חובה. מונחי חיפוש לא תלויי-רישיות. התוצאות חייבות להכיל את כל המילים שמופרדות ברווחים בקוד או בהצהרה שלהן. - When |
includeGroupingStandards |
אופציונלי. אם הערך הוא True, הפונקציה מחזירה כותרות של קטגוריות (שאי אפשר לתייג לעבודות) שהמזהים שלהן מצמצמים את החיפושים הבאים. אם הערך הוא false (ברירת המחדל), הפונקציה מחזירה סטנדרטים שאפשר לתייג בעבודות. |
סכימת הפלט
תשובה שמכילה דרישות לימודיות.
SearchCourseStandardsResponse
| ייצוג ב-JSON |
|---|
{
"learningStandards": [
{
object ( |
| שדות | |
|---|---|
learningStandards[] |
רשימת התקנים התואמים. |
LearningGoal
| ייצוג ב-JSON |
|---|
{
"id": string,
"type": enum ( |
| שדות | |
|---|---|
id |
פלט בלבד. המזהה של יעד הלמידה. כדי לצרף סטנדרט, צריך להשתמש ב- |
type |
פלט בלבד. סוג יעד הלמידה. |
standardCode |
פלט בלבד. קוד סטנדרטי (למשל, "NY-2.NBT.4"). מאוכלס רק עבור תקנים. |
title |
פלט בלבד. תיאור ההצהרה של הסטנדרטים, או כותרת קריאה לאנשים של המיומנויות. |
documentTitle |
פלט בלבד. שם מסמך תוכנית הלימודים. מאוכלס רק עבור תקנים. |
סוג
סוג יעד הלמידה.
| טיפוסים בני מנייה (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.courseshttps://www.googleapis.com/auth/classroom.courses.readonly