เครื่องมือ: 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 |
เอาต์พุตเท่านั้น ชื่อเอกสารหลักสูตร จะป้อนข้อมูลสำหรับมาตรฐานเท่านั้น |
ประเภท
ประเภทของเป้าหมายการเรียนรู้
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
ประเภทเป้าหมายการเรียนรู้ที่ไม่ระบุ |
STANDARD |
มาตรฐานการเรียนรู้จากหลักสูตรการศึกษา |
SKILL |
ทักษะที่แสดงถึงแนวคิดหรือความสามารถด้านการศึกษา มีเพียงครูเท่านั้นที่เพิ่มหรือนำทักษะออกได้ใน Classroom |
คำอธิบายประกอบเครื่องมือ
ระบบจะส่งคำอธิบายประกอบเครื่องมือไปยังไคลเอ็นต์ MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือหนึ่งๆ ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่สามารถใช้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งเพื่อยืนยันไปยังผู้ใช้เมื่อใด
นอกจากสตริงชื่อแล้ว ยังมีการกำหนดคำแนะนำบูลีนต่อไปนี้ด้วย
readOnlyHint: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อมของตนเอง ค่าเริ่มต้น: falsedestructiveHint: หากเป็น "จริง" เครื่องมือจะดำเนินการที่ส่งผลกระทบต่อข้อมูลได้ หากเป็นเท็จ เครื่องมือจะดำเนินการได้เฉพาะการดำเนินการแบบเพิ่มเท่านั้น ค่าเริ่มต้น: trueidempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่มีผลเพิ่มเติมต่อสภาพแวดล้อม ค่าเริ่มต้น: falseopenWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบได้เฉพาะกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นเว็บจะเป็นแบบโอเพนเวิลด์ ส่วนเครื่องมือความทรงจำจะไม่ใช่แบบโอเพนเวิลด์
คำแนะนำเกี่ยวกับการทำลาย: ❌ | คำแนะนำเกี่ยวกับ Idempotent: ✅ | คำแนะนำเกี่ยวกับแบบอ่านอย่างเดียว: ✅ | คำแนะนำเกี่ยวกับโอเพนเวิลด์: ❌
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/classroom.courseshttps://www.googleapis.com/auth/classroom.courses.readonly