টুল: search_course_standards
কোর্সওয়ার্ক বা রুবিকে ট্যাগ করার জন্য কোর্সে একাডেমিক লার্নিং স্ট্যান্ডার্ড সার্চ করে। কোর্সে শিক্ষকের দ্বারা কনফিগার করা লার্নিং স্ট্যান্ডার্ড থাকতে হবে।
- নির্দিষ্ট স্ট্যান্ডার্ড: সঠিক কোড (যেমন, "HS-LS1-1") বা নির্দিষ্ট কীওয়ার্ড (includeGroupingStandards=false) দিয়ে সার্চ করুন।
- বিভাগ: পেরেন্ট বিভাগ খুঁজে পেতে, একটি বিস্তৃত বিষয়ের শব্দের সাথে includeGroupingStandards=true সেট করুন, তারপর ফলাফল আরও নির্দিষ্ট করতে learningStandardIds-এ বিভাগ আইডি পাস করুন।
নিচের কোড স্যাম্পেল থেকে বোঝা যায় যে search_course_standards MCP টুল কল করার জন্য কীভাবে curl ব্যবহার করতে হয়।
| 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 |
প্রয়োজনীয়। সার্চ করা শব্দে ছোট বা বড় হাতের অক্ষর ব্যবহার করা যেতে পারে; ফলাফলের কোড বা বিবৃতিতে স্পেস দিয়ে আলাদা করা প্রতিটি শব্দ থাকতে হবে। - |
includeGroupingStandards |
ঐচ্ছিক। ট্রু হলে, ক্যাটেগরি হেডার (কোর্সওয়ার্কে ট্যাগ করা যায় না) রিটার্ন করে, যার আইডি ফলো-আপ সার্চকে সীমিত করে। মিথ্যা (ডিফল্ট) হলে, কোর্সওয়ার্কে ট্যাগ করা যেতে পারে এমন স্ট্যান্ডার্ড ফিরিয়ে দেয়। |
আউটপুট স্কিমা
লার্নিং স্ট্যান্ডার্ড সহ উত্তর।
SearchCourseStandardsResponse
| JSON উপস্থাপনা |
|---|
{
"learningStandards": [
{
object ( |
| ফিল্ড | |
|---|---|
learningStandards[] |
ম্যাচিং স্ট্যান্ডার্ডের তালিকা। |
LearningGoal
| JSON উপস্থাপনা |
|---|
{
"id": string,
"type": enum ( |
| ফিল্ড | |
|---|---|
id |
শুধু আউটপুট। লার্নিং সংক্রান্ত লক্ষ্যের আইডি। স্ট্যান্ডার্ড অ্যাটাচ করতে, search_course_standards থেকে |
type |
শুধু আউটপুট। লার্নিং সংক্রান্ত লক্ষ্যের ধরন। |
standardCode |
শুধু আউটপুট। স্ট্যান্ডার্ড কোড (যেমন, "NY-2.NBT.4")। শুধুমাত্র স্ট্যান্ডার্ডের জন্য পূরণ করা হয়েছে। |
title |
শুধু আউটপুট। স্ট্যান্ডার্ডের জন্য স্টেটমেন্টের বিবরণ অথবা দক্ষতার জন্য মানুষের-পঠনযোগ্য শীর্ষক। |
documentTitle |
শুধু আউটপুট। কারিকুলাম ডকুমেন্টের নাম। শুধুমাত্র স্ট্যান্ডার্ডের জন্য পূরণ করা হয়েছে। |
ধরন
লার্নিং সংক্রান্ত লক্ষ্যের ধরন।
| Enums | |
|---|---|
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.courseshttps://www.googleapis.com/auth/classroom.courses.readonly