Công cụ: search_course_standards
Tìm các tiêu chuẩn học tập trong một khoá học để gắn thẻ vào tài liệu môn học hoặc tiêu chí chấm điểm. Yêu cầu khoá học phải có các tiêu chuẩn học tập do giáo viên định cấu hình.
- Tiêu chuẩn cụ thể: Tìm kiếm bằng mã chính xác (ví dụ: "HS-LS1-1") hoặc từ khoá cụ thể (includeGroupingStandards=false).
- Danh mục: Đặt includeGroupingStandards=true bằng một từ chủ đề rộng để tìm danh mục mẹ, sau đó chuyển mã danh mục vào learningStandardIds để thu hẹp kết quả.
Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ MCP search_course_standards.
| Yêu cầu 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 }' |
Giản đồ đầu vào
Yêu cầu tìm kiếm trong cây các tiêu chuẩn học tập cấp khoá học được chọn trước.
SearchCourseStandardsRequest
| Biểu diễn dưới dạng JSON |
|---|
{ "courseId": string, "learningStandardIds": [ string ], "query": string, "includeGroupingStandards": boolean } |
| Trường | |
|---|---|
courseId |
Bắt buộc. Giá trị nhận dạng của khoá học. |
learningStandardIds[] |
Không bắt buộc. Giới hạn phạm vi tìm kiếm trong các bộ tiêu chuẩn hoặc tiêu chuẩn danh mục này và các tiêu chuẩn con của chúng. Truyền mã nhận dạng bộ tiêu chuẩn từ |
query |
Bắt buộc. Cụm từ tìm kiếm không phân biệt chữ hoa chữ thường; kết quả phải chứa TẤT CẢ các từ được phân tách bằng dấu cách trong mã hoặc câu lệnh. – Khi |
includeGroupingStandards |
Không bắt buộc. Nếu đúng, hàm sẽ trả về tiêu đề danh mục (không thể gắn thẻ cho tài liệu môn học) có mã thu hẹp phạm vi tìm kiếm tiếp theo. Nếu là false (mặc định), hàm này sẽ trả về các tiêu chuẩn có thể được gắn thẻ trên tài liệu môn học. |
Giản đồ đầu ra
Phản hồi chứa các tiêu chuẩn học tập.
SearchCourseStandardsResponse
| Biểu diễn dưới dạng JSON |
|---|
{
"learningStandards": [
{
object ( |
| Trường | |
|---|---|
learningStandards[] |
Danh sách các tiêu chuẩn phù hợp. |
LearningGoal
| Biểu diễn dưới dạng JSON |
|---|
{
"id": string,
"type": enum ( |
| Trường | |
|---|---|
id |
Chỉ có đầu ra. Mã nhận dạng của mục tiêu học tập. Để đính kèm một tiêu chuẩn, hãy sử dụng |
type |
Chỉ có đầu ra. Loại mục tiêu học tập. |
standardCode |
Chỉ có đầu ra. Mã tiêu chuẩn (ví dụ: "NY-2.NBT.4"). Chỉ được điền sẵn cho tiêu chuẩn. |
title |
Chỉ có đầu ra. Nội dung mô tả tuyên bố cho các tiêu chuẩn hoặc tiêu đề mà con người có thể đọc được cho các kỹ năng. |
documentTitle |
Chỉ có đầu ra. Tên tài liệu chương trình học. Chỉ được điền sẵn cho tiêu chuẩn. |
Loại
Loại mục tiêu học tập.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Loại mục tiêu học tập không xác định. |
STANDARD |
Một tiêu chuẩn học tập trong chương trình học. |
SKILL |
Một kỹ năng đại diện cho một khái niệm hoặc năng lực giáo dục. Chỉ giáo viên mới có thể thêm hoặc xoá kỹ năng trong Lớp học. |
Chú thích về công cụ
Chú thích về công cụ được gửi đến ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.
Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:
readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của nó. Mặc định: false.destructiveHint: Nếu đúng, thì công cụ có thể thực hiện các hành động có tính huỷ diệt. Nếu là false, thì công cụ chỉ có thể thực hiện các hành động bổ sung. Mặc định: true.idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm hiệu ứng nào đối với môi trường của công cụ đó. Mặc định: false.openWorldHint: Nếu đúng, thì công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: công cụ tìm kiếm trên web sẽ là công cụ thế giới mở, còn công cụ ghi nhớ sẽ không phải là công cụ thế giới mở.
Gợi ý về thao tác huỷ bỏ: ❌ | Gợi ý về thao tác không thay đổi giá trị: ✅ | Gợi ý về thao tác chỉ đọc: ✅ | Gợi ý về thao tác thế giới mở: ❌
Phạm vi cấp phép
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/classroom.courseshttps://www.googleapis.com/auth/classroom.courses.readonly