الأداة: create_topic
لإنشاء موضوع جديد في دورة تدريبية تُستخدَم المواضيع لتنظيم المواد التعليمية. يتطلّب ذلك دور المعلّم في الدورة التدريبية.
توضح عينة التعليمات البرمجية التالية كيفية استخدام curl لطلب أداة بروتوكول سياق النموذج (MCP) create_topic.
| طلب 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 }' |
مخطط الإدخال
طلب إنشاء موضوع في دورة تدريبية
CreateTopicRequest
| تمثيل JSON |
|---|
{ "courseId": string, "title": string } |
| الحقول | |
|---|---|
courseId |
الحقل مطلوب. معرّف الدورة التدريبية |
title |
الحقل مطلوب. عنوان الموضوع يجب ألا يزيد عدد الأحرف عن 100 حرف. |
مخطط النتائج
موضوع في دورة تدريبية
الموضوع
| تمثيل JSON |
|---|
{ "id": string, "title": string } |
| الحقول | |
|---|---|
id |
النتائج فقط. المعرّف. رقم تعريف الموضوع |
title |
عنوان الموضوع |
التعليقات التوضيحية للأدوات
يتم إرسال التعليقات التوضيحية للأدوات إلى عملاء 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.topics