Alat: search_course_standards
Menelusuri standar pembelajaran akademik dalam kursus untuk diberi tag pada tugas mata pelajaran atau rubrik. Kursus harus memiliki standar pembelajaran yang dikonfigurasi oleh pengajar.
- Standar spesifik: Telusuri dengan kode persis (misalnya, "HS-LS1-1") atau kata kunci spesifik (includeGroupingStandards=false).
- Kategori: Tetapkan includeGroupingStandards=true dengan kata topik yang luas untuk menemukan kategori induk, lalu teruskan ID kategori ke learningStandardIds untuk mempersempit hasil.
Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP search_course_standards.
| Permintaan 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 }' |
Skema Input
Permintaan untuk menelusuri hierarki standar pembelajaran tingkat kursus yang telah dipilih sebelumnya.
SearchCourseStandardsRequest
| Representasi JSON |
|---|
{ "courseId": string, "learningStandardIds": [ string ], "query": string, "includeGroupingStandards": boolean } |
| Kolom | |
|---|---|
courseId |
Wajib. ID kursus. |
learningStandardIds[] |
Opsional. Membatasi penelusuran ke set standar atau standar kategori ini dan turunannya. Teruskan ID set standar dari |
query |
Wajib. Istilah penelusuran tidak peka huruf besar/kecil; hasil harus berisi SEMUA kata yang dipisahkan spasi dalam kode atau pernyataannya. - Jika |
includeGroupingStandards |
Opsional. Jika benar, akan menampilkan header kategori (tidak dapat diberi tag ke tugas mata pelajaran) yang ID-nya mempersempit penelusuran lanjutan. Jika salah (default), menampilkan standar yang dapat diberi tag pada tugas mata pelajaran. |
Skema Output
Respons yang berisi standar pembelajaran.
SearchCourseStandardsResponse
| Representasi JSON |
|---|
{
"learningStandards": [
{
object ( |
| Kolom | |
|---|---|
learningStandards[] |
Daftar standar yang cocok. |
LearningGoal
| Representasi JSON |
|---|
{
"id": string,
"type": enum ( |
| Kolom | |
|---|---|
id |
Hanya output. ID sasaran pembelajaran. Untuk melampirkan standar, gunakan |
type |
Hanya output. Jenis sasaran pembelajaran. |
standardCode |
Hanya output. Kode standar (misalnya, "NY-2.NBT.4"). Hanya diisi untuk standar. |
title |
Hanya output. Deskripsi pernyataan untuk standar, atau judul yang dapat dibaca manusia untuk keterampilan. |
documentTitle |
Hanya output. Nama dokumen kurikulum. Hanya diisi untuk standar. |
Jenis
Jenis sasaran pembelajaran.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Jenis sasaran pembelajaran belum ditentukan. |
STANDARD |
Standar pembelajaran dari kurikulum akademik. |
SKILL |
Keterampilan yang mewakili konsep atau kompetensi pendidikan. Hanya pengajar yang dapat menambahkan atau menghapus keterampilan di Classroom. |
Anotasi Alat
Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk tersebut dapat digunakan untuk memutuskan kapan perintah konfirmasi mungkin dikirim kepada pengguna.
Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:
readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan aditif. Default: true.idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/classroom.courseshttps://www.googleapis.com/auth/classroom.courses.readonly