MCP Tools Reference: classroommcp.googleapis.com

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

string

Bắt buộc. Giá trị nhận dạng của khoá học.

learningStandardIds[]

string

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ừ Course.learning_goals (trong list_courses) hoặc mã nhận dạng danh mục từ lệnh gọi trước đó với includeGroupingStandards = true (không phải standardCode), chứ không phải cả hai. Nếu để trống, hệ thống sẽ tìm tất cả tiêu chuẩn trong khoá học.

query

string

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 = false: truyền mã tiêu chuẩn chính xác (ví dụ: "HS-LS1-1") hoặc 2-3 từ khoá cụ thể (ví dụ: "diện tích tam giác"). – Khi includeGroupingStandards = true: truyền 1-2 từ miền rộng (ví dụ: "hình học") khớp với tiêu đề danh mục.

includeGroupingStandards

boolean

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 (LearningGoal)
    }
  ]
}
Trường
learningStandards[]

object (LearningGoal)

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 (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
Trường
id

string

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 id từ search_course_standards (không phải standardCode).

type

enum (Type)

Chỉ có đầu ra. Loại mục tiêu học tập.

standardCode

string

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

string

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

string

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.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly