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) โดยไม่ส่งทั้ง 2 อย่าง หากเว้นว่างไว้ ระบบจะค้นหามาตรฐานทั้งหมดในหลักสูตร

query

string

ต้องระบุ ข้อความค้นหาที่ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ผลลัพธ์ต้องมีคำที่คั่นด้วยเว้นวรรคทั้งหมดในโค้ดหรือคำสั่ง - เมื่อ includeGroupingStandards = false: ส่งรหัสมาตรฐานที่ตรงกันทุกประการ (เช่น "HS-LS1-1") หรือคีย์เวิร์ดที่เฉพาะเจาะจง 2-3 คำ (เช่น "พื้นที่สามเหลี่ยม") - เมื่อ includeGroupingStandards = true: ส่งคำโดเมนแบบกว้าง 1-2 คำ (เช่น "เรขาคณิต") ที่ตรงกับชื่อหมวดหมู่

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

เอาต์พุตเท่านั้น ชื่อเอกสารหลักสูตร จะป้อนข้อมูลสำหรับมาตรฐานเท่านั้น

ประเภท

ประเภทของเป้าหมายการเรียนรู้

Enum
TYPE_UNSPECIFIED ประเภทเป้าหมายการเรียนรู้ที่ไม่ระบุ
STANDARD มาตรฐานการเรียนรู้จากหลักสูตรการศึกษา
SKILL ทักษะที่แสดงถึงแนวคิดหรือความสามารถด้านการศึกษา มีเพียงครูเท่านั้นที่เพิ่มหรือนำทักษะออกได้ใน Classroom

คำอธิบายประกอบเครื่องมือ

ระบบจะส่งคำอธิบายประกอบเครื่องมือไปยังไคลเอ็นต์ MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือหนึ่งๆ ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่สามารถใช้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งเพื่อยืนยันไปยังผู้ใช้เมื่อใด

นอกจากสตริงชื่อแล้ว ยังมีการกำหนดคำแนะนำบูลีนต่อไปนี้ด้วย

  • readOnlyHint: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อมของตนเอง ค่าเริ่มต้น: false
  • destructiveHint: หากเป็น "จริง" เครื่องมือจะดำเนินการที่ส่งผลกระทบต่อข้อมูลได้ หากเป็นเท็จ เครื่องมือจะดำเนินการได้เฉพาะการดำเนินการแบบเพิ่มเท่านั้น ค่าเริ่มต้น: true
  • idempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่มีผลเพิ่มเติมต่อสภาพแวดล้อม ค่าเริ่มต้น: false
  • openWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบได้เฉพาะกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นเว็บจะเป็นแบบโอเพนเวิลด์ ส่วนเครื่องมือความทรงจำจะไม่ใช่แบบโอเพนเวิลด์

คำแนะนำเกี่ยวกับการทำลาย: ❌ | คำแนะนำเกี่ยวกับ Idempotent: ✅ | คำแนะนำเกี่ยวกับแบบอ่านอย่างเดียว: ✅ | คำแนะนำเกี่ยวกับโอเพนเวิลด์: ❌

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly