Skip to main content
Glama

scobees_create_aufgabe

Creates a worksheet, quiz, or info block inside a learning path, outline, or elective task, with configurable submission type, levels, and Markdown or Serlo content.

Instructions

Legt eine Aufgabe in einer Gliederung, einer Wahlpflichtaufgabe oder direkt im Lernpfad an. art bestimmt die Abgabe (nicht das Quiz): info, selbstkontrolle (Standard: Arbeitsblatt mit sich selbst prüfendem Quiz, keine Abgabe), abgabe_optional, abgabe_pflicht, abgabe_selbstkorrektur, abgabe_pflicht_selbstkorrektur. Das Arbeitsblatt kommt als Markdown (arbeitsblatt_markdown; Quiz-Blöcke quiz-sc, quiz-mc, quiz-input, quiz-blanks, quiz-blanks-dnd, quiz-text, dazu math, :::box, :::spoiler) oder als fertiges serlo_json. Liegt parent_id in einer Wahlpflichtaufgabe, setzt der Server den dafür nötigen Aufgabentyp selbst. Das Ergebnis kann warnungen[] enthalten (z. B. $…$ in einer Lückenantwort). Material und Musterlösungen danach mit scobees_upload_material anhängen.

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": {
      "parent_id": "<parent_id>",
      "name": "<name>"
    },
    "name": "scobees_create_aufgabe"
  }
}

Input Schema

NameRequiredDescriptionDefault
artNoAbgabeform. info = Infobaustein ohne Abgabe; selbstkontrolle = Arbeitsblatt mit Serlo-Quiz, prüft sich selbst, keine Abgabe (Standard für Theorie + Quiz); abgabe_optional = Lernende geben ein Ergebnis ab (Datei/Stift-PDF/Link); abgabe_pflicht = Abgabe zwingend; abgabe_selbstkorrektur = Abgabe (optional), danach Vergleich mit der Musterlösung; abgabe_pflicht_selbstkorrektur = Abgabe zwingend + Musterlösungs-Vergleich (scobees-„Selbstkorrektur“; Musterlösung per scobees_upload_material als_musterloesung). Hinweis: selbstkontrolle trägt in scobees bewusst KEIN Selbstkorrektur-Kennzeichen – das Quiz prüft sich im Arbeitsblatt. Wenn ein Ergebnis erwartet wird, abgabe_* wählen und in description_html sagen, WAS abzugeben ist.selbstkontrolle
nameYes
linksNo
parent_idYes
serlo_jsonNoAlternativ: fertiges Serlo-Dokument (JSON-String, Wurzel plugin rows)
aufgabentypNopflicht = zählt zum Fortschritt; extra = freiwillige Zusatzaufgabe; training = freiwillige Übung; info = reiner Informationsbausteinpflicht
abgabeformenNoNur für abgabe_*: file (Datei hochladen), pen (PDF mit Stift bearbeiten), link (Videolink). Standard ["file"]; mehrere = eine reicht.
interne_notizNoNur für Lehrkräfte sichtbar
estimated_timeNoMinuten
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.
description_htmlNoKurzbeschreibung (HTML), erscheint über dem Arbeitsblatt
differenzierungenNoNiveaus der Schule (scobees_list_tags), z. B. ["Hauptschulabschluss","Realschulabschluss"]. Leer = alle aktuellen Niveaus der Schule werden explizit eingetragen (scobees kennt kein eigenes „für alle“ – beim Zurücklesen stehen deshalb alle einzeln da, das ist kein Fehler). Kommt später ein neues Niveau hinzu, erscheint es nicht automatisch bei alten Aufgaben; dann erneut mit leerem differenzierungen aktualisieren. Lernende sehen nur Aufgaben ihres Niveaus.
arbeitsblatt_markdownNoInhalt des interaktiven Arbeitsblatts als Markdown

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.1.10
    • addedInput schema / properties / cover_image_path
      Added value: +{
      +  "description": "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.",
      +  "type": "string"
      +}
    • changedInput schema / properties / differenzierungen / description
      Previous value: -"Niveaus der Schule (scobees_list_tags), z. B. [\"Hauptschulabschluss\",\"Realschulabschluss\"]. Leer = alle Niveaus (Aufgabe für alle sichtbar). Lernende sehen nur Aufgaben ihres Niveaus."New value: +"Niveaus der Schule (scobees_list_tags), z. B. [\"Hauptschulabschluss\",\"Realschulabschluss\"]. Leer = alle aktuellen Niveaus der Schule werden explizit eingetragen (scobees kennt kein eigenes „für alle“ – beim Zurücklesen stehen deshalb alle einzeln da, das ist kein Fehler). Kommt später ein neues Niveau hinzu, erscheint es nicht automatisch bei alten Aufgaben; dann erneut mit leerem differenzierungen aktualisieren. Lernende sehen nur Aufgaben ihres Niveaus."
  2. Changed6 schema fields changedv0.1.4
    • addedInput schema / properties / abgabeformen
      Added value: +{
      +  "description": "Nur für abgabe_*: file (Datei hochladen), pen (PDF mit Stift bearbeiten), link (Videolink). Standard [\"file\"]; mehrere = eine reicht.",
      +  "items": {
      +    "enum": [
      +      "file",
      +      "pen",
      +      "link"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / art / default
      Previous value: -"info"New value: +"selbstkontrolle"
    • addedInput schema / properties / art / description
      Added value: +"Abgabeform. info = Infobaustein ohne Abgabe; selbstkontrolle = Arbeitsblatt mit Serlo-Quiz, prüft sich selbst, keine Abgabe (Standard für Theorie + Quiz); abgabe_optional = Lernende geben ein Ergebnis ab (Datei/Stift-PDF/Link); abgabe_pflicht = Abgabe zwingend; abgabe_selbstkorrektur = Abgabe (optional), danach Vergleich mit der Musterlösung; abgabe_pflicht_selbstkorrektur = Abgabe zwingend + Musterlösungs-Vergleich (scobees-„Selbstkorrektur“; Musterlösung per scobees_upload_material als_musterloesung). Hinweis: selbstkontrolle trägt in scobees bewusst KEIN Selbstkorrektur-Kennzeichen – das Quiz prüft sich im Arbeitsblatt. Wenn ein Ergebnis erwartet wird, abgabe_* wählen und in description_html sagen, WAS abzugeben ist."
    • changedInput schema / properties / art / enum
      Previous value: -[
      -  "info",
      -  "selbstkontrolle",
      -  "abgabe_optional",
      -  "abgabe_pflicht",
      -  "abgabe_optional_sc"
      -]New value: +[
      +  "info",
      +  "selbstkontrolle",
      +  "abgabe_optional",
      +  "abgabe_pflicht",
      +  "abgabe_selbstkorrektur",
      +  "abgabe_pflicht_selbstkorrektur"
      +]
    • addedInput schema / properties / aufgabentyp
      Added value: +{
      +  "default": "pflicht",
      +  "description": "pflicht = zählt zum Fortschritt; extra = freiwillige Zusatzaufgabe; training = freiwillige Übung; info = reiner Informationsbaustein",
      +  "enum": [
      +    "pflicht",
      +    "extra",
      +    "training",
      +    "info"
      +  ],
      +  "type": "string"
      +}
    • removedInput schema / properties / wahlaufgabe
      Removed value: -{
      -  "default": false,
      -  "description": "true = Wahl- statt Pflichtaufgabe",
      -  "type": "boolean"
      -}
  3. First observedv0.1.0

TDQS

A4.3/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 add real behavioral context: the server auto-sets the required Aufgabentyp when parent_id sits in a Wahlpflichtaufgabe, the response may contain warnungen[] (e.g. $…$ in a blank answer), and material/Musterlösungen must be attached in a separate call. It stops short of stating whether the created Aufgabe id is returned, or any permission/idempotency constraints.

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?

Front-loaded with the purpose and action, then the decision rules, then the follow-up step — a logical order. It is dense but every clause carries information; the only waste is the art value list, which restates what the enum description already provides.

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

Completeness4/5

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

For a 13-parameter mutation tool with no annotations and no output schema, the description covers the main pitfalls (art semantics, Wahlpflicht parent handling, warnungen, separate material upload). It is slightly incomplete on the return value — the agent does not learn whether an id comes back for the subsequent upload_material call, where parent_id must be supplied.

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

Parameters4/5

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

Schema coverage is 77%, so the baseline would be 3, but the description adds genuine meaning beyond the schema: parent_id placement semantics, the markdown block vocabulary (quiz-sc, quiz-mc, quiz-input, quiz-blanks, quiz-text, math, :::box, :::spoiler), and the serlo_json alternative. The art enumeration largely duplicates the enum description already in the schema.

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?

States a specific verb and resource ('Legt eine Aufgabe ... an') and enumerates the three placement contexts (Gliederung, Wahlpflichtaufgabe, Lernpfad). It also distinguishes the follow-up step from the creation step by naming scobees_upload_material for material and Musterlösungen.

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?

Gives clear guidance on the core decision — which 'art' to pick and why, including that 'selbstkontrolle' is the default for theory plus quiz and that abgabe_* should be chosen when a result is expected. It also tells the agent to attach material afterwards via scobees_upload_material, but it never explains when to use this tool versus scobees_update_aufgabe or scobees_patch_arbeitsblatt.

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