MCP Tools Reference: classroommcp.googleapis.com

Araç: search_course_standards

Bir kurstaki akademik öğrenme standartlarını, çalışma materyallerine veya puan anahtarlarına etiket eklemek için arar. Derste öğretmen tarafından yapılandırılmış öğrenme standartları bulunmalıdır.

  • Belirli standartlar: Tam kodla (ör. "HS-LS1-1") veya belirli anahtar kelimelerle arama yapın (includeGroupingStandards=false).
  • Kategoriler: Üst kategorileri bulmak için includeGroupingStandards=true değerini geniş bir konu kelimesiyle ayarlayın, ardından sonuçları daraltmak için kategori kimliğini learningStandardIds'ye iletin.

Aşağıdaki kod örneğinde, search_course_standards MCP aracını çağırmak için curl öğesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği
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
}'

Giriş şeması

Önceden seçilmiş kurs düzeyindeki öğrenme standardı ağaçlarında arama isteği.

SearchCourseStandardsRequest

JSON gösterimi
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
Alanlar
courseId

string

Zorunlu. Dersin tanımlayıcısı.

learningStandardIds[]

string

İsteğe bağlıdır. Aramayı bu standart setleri veya kategori standartları ve bunların alt öğeleriyle kısıtlar. Course.learning_goals (list_courses içinde) standart seti kimliğini veya includeGroupingStandards = true (standardCode değil) olan önceki bir çağrıdan kategori kimliklerini iletin. İkisini birden iletmeyin. Boş bırakılırsa dersteki tüm standartlar aranır.

query

string

Zorunlu. Arama terimleri büyük/küçük harfe duyarlı değildir. Sonuçların kodunda veya ifadesinde, boşlukla ayrılmış TÜM kelimeler bulunmalıdır. - includeGroupingStandards = false olduğunda: Tam bir standart kod (ör. "HS-LS1-1") veya 2-3 spesifik anahtar kelime (ör. "üçgenlerin alanı") iletin. - includeGroupingStandards = true olduğunda: Kategori başlıklarıyla eşleşen 1-2 geniş alan kelimesi (ör. "geometri") iletin.

includeGroupingStandards

boolean

İsteğe bağlıdır. Doğru ise kimlikleri takip aramalarını daraltan kategori başlıklarını (çalışma materyaline etiketlenemez) döndürür. Yanlış ise (varsayılan) çalışma materyalinde etiketlenebilecek standartları döndürür.

Çıkış şeması

Öğrenme standartlarını içeren yanıt.

SearchCourseStandardsResponse

JSON gösterimi
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
Alanlar
learningStandards[]

object (LearningGoal)

Eşleşen standartların listesi.

LearningGoal

JSON gösterimi
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
Alanlar
id

string

Yalnızca çıkış. Öğrenme hedefinin kimliği. Standart eklemek için search_course_standards'dan bir id kullanın (standardCode değil).

type

enum (Type)

Yalnızca çıkış. Öğrenme hedefinin türü.

standardCode

string

Yalnızca çıkış. Standart kod (ör. "NY-2.NBT.4"). Yalnızca standartlar için doldurulur.

title

string

Yalnızca çıkış. Standartlar için ifade açıklaması veya beceriler için kullanıcılar tarafından okunabilir başlık.

documentTitle

string

Yalnızca çıkış. Müfredat dokümanı adı. Yalnızca standartlar için doldurulur.

Tür

Öğrenme hedefinin türü.

Sıralamalar
TYPE_UNSPECIFIED Öğrenme hedefi türü belirtilmedi.
STANDARD Akademik müfredattaki bir öğrenme standardı.
SKILL Eğitimle ilgili bir kavramı veya yeterliliği temsil eden beceri. Classroom'da yalnızca öğretmenler beceri ekleyebilir veya kaldırabilir.

Araç Notları

Araç ek açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olarak değerlendirmez ancak kullanıcıya ne zaman onay istemi gönderileceğine karar vermek için kullanılabilir.

Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğru ise araç, yıkıcı işlemler gerçekleştirebilir. "False" ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.
  • openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.

Yıkıcı İpucu: ❌ | Aynı Sonucu Veren İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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