MCP Tools Reference: classroommcp.googleapis.com

Strumento: search_course_standards

Cerca gli standard di apprendimento accademico in un corso per taggare i materiali del corso o le griglie. Richiede che il corso abbia standard di apprendimento configurati dall'insegnante.

  • Standard specifici: cerca con il codice esatto (ad es. "HS-LS1-1") o con parole chiave specifiche (includeGroupingStandards=false).
  • Categorie: imposta includeGroupingStandards=true con una parola chiave generica per trovare le categorie principali, quindi passa l'ID categoria in learningStandardIds per restringere i risultati.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP search_course_standards.

Richiesta 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
}'

Schema di input

Richiesta di ricerca negli alberi degli standard di apprendimento a livello di corso preselezionati.

SearchCourseStandardsRequest

Rappresentazione JSON
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
Campi
courseId

string

Obbligatorio. Identificatore del corso.

learningStandardIds[]

string

Facoltativo. Limita la ricerca a questi set di standard o standard di categoria e ai relativi discendenti. Passa un ID set di standard da Course.learning_goals (in list_courses) o gli ID categoria da una chiamata precedente con includeGroupingStandards = true (non standardCode), non entrambi. Se il campo è vuoto, la ricerca viene eseguita in tutti gli standard del corso.

query

string

Obbligatorio. Termini di ricerca senza distinzione tra maiuscole e minuscole; i risultati devono contenere TUTTE le parole separate da spazi nel codice o nell'istruzione. - Quando includeGroupingStandards = false: passa un codice standard esatto (ad es. "HS-LS1-1") o 2-3 parole chiave specifiche (ad es. "area triangoli"). - Quando includeGroupingStandards = true: passa 1-2 parole di dominio generiche (ad es. "geometria") corrispondenti ai titoli delle categorie.

includeGroupingStandards

boolean

Facoltativo. Se true, restituisce le intestazioni delle categorie (non taggabili per i materiali del corso) i cui ID restringono le ricerche successive. Se è false (valore predefinito), restituisce gli standard che possono essere taggati nei materiali del corso.

Schema di output

Risposta contenente gli standard di apprendimento.

SearchCourseStandardsResponse

Rappresentazione JSON
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
Campi
learningStandards[]

object (LearningGoal)

L'elenco degli standard corrispondenti.

LearningGoal

Rappresentazione JSON
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
Campi
id

string

Solo output. ID dell'obiettivo di apprendimento. Per allegare uno standard, utilizza un id di search_course_standards (non standardCode).

type

enum (Type)

Solo output. Il tipo di obiettivo di apprendimento.

standardCode

string

Solo output. Codice standard (ad es. "NY-2.NBT.4"). Compilato solo per gli standard.

title

string

Solo output. Descrizione dell'istruzione per gli standard o titolo leggibile per le competenze.

documentTitle

string

Solo output. Nome del documento del programma. Compilato solo per gli standard.

Tipo

Il tipo di obiettivo di apprendimento.

Enum
TYPE_UNSPECIFIED Tipo di obiettivo di apprendimento non specificato.
STANDARD Uno standard di apprendimento di un programma accademico.
SKILL Una competenza che rappresenta un concetto o una competenza didattica. Solo un insegnante può aggiungere o rimuovere competenze in Classroom.

Annotazioni dello strumento

Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti come non attendibili, ma possono essere utilizzati per decidere quando inviare una richiesta di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se è impostato su false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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