ابزار: 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 |
الزامی. عبارتهای جستجو به حروف بزرگ و کوچک حساس نیستند؛ نتایج باید شامل همه کلمههای جداشده با فاصله در کد یا عبارت باشند. - وقتی |
includeGroupingStandards |
اختیاری. اگر درست باشد، سرصفحههای دستهای را برمیگرداند (نمیتوان به کار کلاسی برچسب زد) که شناسههایشان جستجوهای پیگیری را محدود میکند. اگر نادرست باشد (پیشفرض)، استانداردهایی را برمیگرداند که میتوانند در کار کلاسی برچسبگذاری شوند. |
طرح برونداد
پاسخ حاوی استانداردهای یادگیری.
SearchCourseStandardsResponse
| نمایش JSON |
|---|
{
"learningStandards": [
{
object ( |
| فیلدها | |
|---|---|
learningStandards[] |
فهرست استانداردهای منطبق. |
LearningGoal
| نمایش JSON |
|---|
{
"id": string,
"type": enum ( |
| فیلدها | |
|---|---|
id |
فقط خروجی. شناسه هدف یادگیری. برای پیوست کردن استاندارد، از |
type |
فقط خروجی. نوع هدف یادگیری. |
standardCode |
فقط خروجی. کد استاندارد (مثلاً «NY-2.NBT.4»). فقط برای استانداردها درج میشود. |
title |
فقط خروجی. شرح بیانیه برای استانداردها، یا عنوان قابلخواندن برای انسان برای مهارتها. |
documentTitle |
فقط خروجی. نام سند برنامه درسی. فقط برای استانداردها درج میشود. |
نوع
نوع هدف یادگیری.
| شمارشیها | |
|---|---|
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