Skip to main content
Glama

scobees_create_lernpfad

Creates a new learning path in a subject as an inactive draft that appears in the school library, ready to be filled with structures and tasks and assigned to a class by a teacher.

Instructions

Legt einen neuen Lernpfad in einem Fach an (Wurzel). Danach Gliederungen und Aufgaben mit den anderen Werkzeugen hinzufügen. Der Pfad erscheint in der schuleigenen Bib (published) und hat Status INACTIVE, bis eine Lehrkraft ihn in der Weboberfläche einer Lerngruppe zuweist.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "subject_id": "<subject_id>",
      "name": "<name>"
    },
    "name": "scobees_create_lernpfad"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameYes
jahrgaengeNoz. B. ["Jg 1"] oder Tag-IDs
subject_idYesFach-ID aus scobees_list_subjects
descriptionNoBeschreibung als reiner Text – scobees zeigt sie hier nicht als HTML gerendert, mitgeschicktes HTML würde als sichtbarer Tag-Text erscheinen und wird deshalb automatisch entfernt.
solve_orderNoAufgabenwahl am Lernpfad selbst. Achtung: Sie sperrt Aufgaben in Gliederungen nicht (mit Dummy-Konto geprüft); die Bearbeitungsreihenfolge wird an der Gliederung gesetzt (scobees_create_gliederung, solve_order)none
stichwoerterNoFreie Schlagworte
cover_image_pathNoLokaler Pfad zu einem Kachelbild (PNG oder JPG; live geprüft mit PNG bis 1,3 MB). Quadratisch anlegen – scobees beschneidet die Kachel quadratisch – und ein Motiv wählen, das klein noch erkennbar ist.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.1.13
    • changedInput schema / properties / solve_order / description
      Previous value: -"Aufgabenwahl: none = frei; after_solving = nach Reihenfolge; after_selfcorrection = nach Reihenfolge mit Selbstkorrektur; after_teacher_correction = nach Reihenfolge mit Feedback der Lehrkraft"New value: +"Aufgabenwahl am Lernpfad selbst. Achtung: Sie sperrt Aufgaben in Gliederungen nicht (mit Dummy-Konto geprüft); die Bearbeitungsreihenfolge wird an der Gliederung gesetzt (scobees_create_gliederung, solve_order)"
  2. Changed2 schema fields changedv0.1.10
    • changedInput schema / properties / cover_image_path / description
      Previous value: -"Lokaler Pfad zu einem Titelbild (png/jpg), optional"New value: +"Lokaler Pfad zu einem Kachelbild (PNG oder JPG; live geprüft mit PNG bis 1,3 MB). Quadratisch anlegen – scobees beschneidet die Kachel quadratisch – und ein Motiv wählen, das klein noch erkennbar ist."
    • changedInput schema / properties / description / description
      Previous value: -"Beschreibung (Klartext oder einfaches HTML)"New value: +"Beschreibung als reiner Text – scobees zeigt sie hier nicht als HTML gerendert, mitgeschicktes HTML würde als sichtbarer Tag-Text erscheinen und wird deshalb automatisch entfernt."
  3. Changed2 schema fields changedv0.1.4
    • changedInput schema / properties / solve_order / description
      Previous value: -"none = frei, after_solving = Reihenfolge einhalten"New value: +"Aufgabenwahl: none = frei; after_solving = nach Reihenfolge; after_selfcorrection = nach Reihenfolge mit Selbstkorrektur; after_teacher_correction = nach Reihenfolge mit Feedback der Lehrkraft"
    • changedInput schema / properties / solve_order / enum
      Previous value: -[
      -  "none",
      -  "after_solving"
      -]New value: +[
      +  "none",
      +  "after_solving",
      +  "after_selfcorrection",
      +  "after_teacher_correction"
      +]
  4. First observedv0.1.0

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does disclose a genuinely non-obvious side effect: the path becomes visible in the school library (published) but stays INACTIVE until a teacher assigns it to a learning group in the web UI. Remaining gaps: no statement of required permissions and no indication of what the call returns (e.g., the new path ID needed for the follow-up tool calls).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three compact sentences, front-loaded with the create action, then the workflow hint, then the lifecycle/visibility note. No filler; only the lifecycle sentence could be slightly tightened.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 7-parameter mutation tool with no annotations and no output schema, the definition covers lifecycle and workflow well but omits the return value and how the created path is referenced by subsequent create_gliederung/create_aufgabe calls. That missing link matters for correct multi-step usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 86%, so the schema already explains name, subject_id, jahrgaenge, solve_order, stichwoerter and cover_image_path in detail, including the solve_order caveat. The description body adds no parameter-level meaning beyond that, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb and resource ("Legt einen neuen Lernpfad in einem Fach an (Wurzel)") and pins the scope to the root level of a subject, which is exactly what distinguishes it from the sibling update/create-child tools. It also states the follow-up workflow (add Gliederungen and Aufgaben with other tools), so an agent can place it in a sequence without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clear positive guidance: use this to create the top-level path, then use the other tools to add structure and tasks. It does not explicitly name when not to use it (e.g., vs. scobees_update_lernpfad for existing paths), but the create-vs-modify boundary is unambiguous from the wording.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.