MCP Tools Reference: classroommcp.googleapis.com

টুল: create_topic

কোর্সে নতুন বিষয় তৈরি করে। কোর্সওয়ার্ক সাজাতে বিষয় ব্যবহার করা হয়। কোর্সে শিক্ষকের ভূমিকা থাকতে হবে।

নিচের কোড স্যাম্পেল থেকে বোঝা যায় যে create_topic 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": "create_topic",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

কোনও কোর্সে বিষয় তৈরি করার অনুরোধ।

CreateTopicRequest

JSON উপস্থাপনা
{
  "courseId": string,
  "title": string
}
ফিল্ড
courseId

string

প্রয়োজনীয়। কোর্সের শনাক্তকারী।

title

string

প্রয়োজনীয়। বিষয়ের শীর্ষক। সর্বাধিক ১০০টি অক্ষর থাকতে হবে।

আউটপুট স্কিমা

কোর্সের মধ্যে থাকা কোনও বিষয়।

বিষয়

JSON উপস্থাপনা
{
  "id": string,
  "title": string
}
ফিল্ড
id

string

শুধু আউটপুট। শনাক্তকারী। বিষয় আইডি।

title

string

বিষয়ের শীর্ষক।

টুল অ্যানোটেশন

প্রদত্ত টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য MCP ক্লায়েন্টদের টুল অ্যানোটেশন পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এইসব ইঙ্গিতকে বিশ্বাসযোগ্য বলে মনে করে না, তবে ব্যবহারকারীকে কখন কনফার্মেশন প্রম্পট পাঠানো হবে তা নির্ধারণ করতে এগুলি ব্যবহার করা যেতে পারে।

টাইটেল স্ট্রিংয়ের সাথে, নিম্নলিখিত বুলিয়ান ইঙ্গিতগুলি এইভাবে সংজ্ঞায়িত করা হয়েছে:

  • readOnlyHint: সত্য হলে, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false.
  • destructiveHint: সত্য হলে, টুলটি ধ্বংসাত্মক অ্যাকশন পারফর্ম করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র যোগ করার অ্যাকশন করতে পারে। ডিফল্ট: true.
  • idempotentHint: সত্য হলে, একই আর্গুমেন্ট সহ টুলটিকে বারবার কল করলে এর এনভায়রনমেন্টে কোনও অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false.
  • openWorldHint: সত্য হলে, টুলটি বাহ্যিক এন্টিটির 'মুক্ত পৃথিবী'-র সাথে ইন্টার‍্যাক্ট করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র অভ্যন্তরীণ এন্টিটির সাথে ইন্টার‍্যাক্ট করতে পারে। যেমন, ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হলেও মেমরি টুল ওপেন ওয়ার্ল্ড নয়।

ডেস্ট্রাক্টিভ ইঙ্গিত: ❌ | আইডেমপোটেন্ট ইঙ্গিত: ❌ | শুধু পড়ার ইঙ্গিত: ❌ | ওপেন ওয়ার্ল্ড ইঙ্গিত: ❌

অনুমোদনের স্কোপ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/classroom.topics