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"). - When includeGroupingStandards = true: pass 1-2 broad domain words (e.g. "geometry") matching category titles.

includeGroupingStandards

boolean

اختيارية: إذا كانت القيمة صحيحة، يتم عرض عناوين الفئات (التي لا يمكن وضع علامة عليها في المواد التعليمية) التي تضيّق أرقام تعريفها نطاق عمليات البحث اللاحقة. إذا كانت القيمة "خطأ" (الإعداد التلقائي)، يتم عرض المعايير التي يمكن وضع علامة عليها في الواجب الدراسي.

مخطط النتائج

الردّ الذي يتضمّن معايير التعلّم

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

النتائج فقط. اسم مستند المنهج الدراسي تتم تعبئة هذا الحقل للمعايير فقط.

النوع

نوع الهدف التعليمي

عمليات التعداد
TYPE_UNSPECIFIED نوع الهدف التعليمي غير محدّد.
STANDARD تمثّل هذه السمة معيارًا من معايير التعلُّم من منهج دراسي أكاديمي.
SKILL مهارة تمثّل مفهومًا تعليميًا أو كفاءة معيّنة يمكن للمعلّم فقط إضافة المهارات أو إزالتها في Classroom.

التعليقات التوضيحية للأدوات

يتم إرسال التعليقات التوضيحية للأدوات إلى عملاء MCP لوصف المخاطر الأساسية لأداة معيّنة. تتعامل معظم البرامج مع هذه التلميحات على أنّها غير موثوق بها، ولكن يمكن استخدامها لتحديد الحالات التي قد يتم فيها إرسال طلب تأكيد إلى المستخدم.

إلى جانب سلسلة العنوان، يتم تحديد التلميحات المنطقية التالية على النحو التالي:

  • ‫readOnlyHint: إذا كانت القيمة صحيحة، لا تعدّل الأداة بيئتها. القيمة التلقائية: false
  • ‫destructiveHint: إذا كانت القيمة "صحيح"، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة "خطأ"، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
  • ‫idempotentHint: إذا كانت القيمة "صحيح"، لن يؤدي استدعاء الأداة بشكل متكرّر باستخدام الوسيطات نفسها إلى أي تأثير إضافي في بيئتها. القيمة التلقائية: false
  • ‫openWorldHint: إذا كانت القيمة "صحيح"، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة "خطأ"، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة بحث الويب عالمًا مفتوحًا، في حين أنّ أداة الذاكرة لن تكون كذلك.

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