Question format

Getting questions out of your own AI

1. In the question collection, choose «With your own AI» and set topic, number and question type.
2. Open the finished request in an AI service, or copy it. It points at this page so the AI knows how the file is built.
3. Copy the result out of the chat and paste it into the same dialog — or save it as a file and read it in via «From file».
4. Read the questions in the collection before running an exam with them. Invented questions sometimes contain mistakes that look convincing.

How it is built

On the outside there is an identifier, a version number and the list of questions. Everything else belongs to the questions themselves. A field that carries its default value is left out — that is how the examples on this page look, and a file written by hand may look the same.

{
  "format": "tech-exam/questions",
  "formatVersion": 1,
  "questions": [
    {
      "topic": "Beispielfragen",
      "subtopic": "Fragetypen",
      "subsubtopic": "Multiple Choice",
      "title": "Aussagen über Listen",
      "contentType": "mc",
      "maxPoints": 4,
      "description": "Welche Aussagen über Listen in Python sind richtig?",
      "answerSpec": {
        "kind": "mc",
        "options": [
          {
            "id": "o1",
            "text": "Eine Liste ist veränderbar."
          },
          {
            "id": "o2",
            "text": "Eine Liste kann nur Zahlen enthalten."
          },
          {
            "id": "o3",
            "text": "Eine Liste behält die Reihenfolge der Einträge."
          },
          {
            "id": "o4",
            "text": "`len(zahlen)` gibt den grössten Wert der Liste zurück."
          }
        ],
        "multiple": true,
        "scoring": {
          "mode": "allOrNothing"
        }
      },
      "answerKey": {
        "kind": "mc",
        "correct": [
          "o1",
          "o3"
        ]
      }
    },
    {
      "topic": "Beispielfragen",
      "subtopic": "Fragetypen",
      "subsubtopic": "Langtext",
      "title": "Wann Liste, wann Dictionary?",
      "contentType": "langtext",
      "maxPoints": 6,
      "description": "Begründe in einem Abschnitt, wann sich eine Liste besser eignet als ein Dictionary – und wann umgekehrt. Nenne je ein Beispiel.",
      "solution": "Eine Liste passt, wenn die Reihenfolge zählt und alle Einträge der Reihe nach durchlaufen werden, etwa eine Rangliste.\n\nEin Dictionary passt, wenn ein Wert über einen Schlüssel gefunden werden soll, etwa die Note zu einem Namen: Der Zugriff bleibt gleich schnell, egal wie viele Einträge dazukommen.\n",
      "criteria": [
        {
          "text": "Die Begründung trifft das Entscheidende: Reihenfolge und Durchlaufen bei der Liste, Zugriff über den Schlüssel beim Dictionary.",
          "points": 3
        },
        {
          "text": "Zu beiden Fällen steht ein konkretes Beispiel, das das genannte Merkmal wirklich braucht.",
          "points": 3
        }
      ]
    }
  ]
}

The fields

A question must carry three fields: title, question type and points. All the others may be left out — then whatever stands in the third column applies. A file with three correct fields is worth more than one full of guessed ones.

Around the questions

On every question

Programming and drawing

«tigerpython», «tigerpython_robotik», «python» and «svg» are answered in an embedded environment. With «tigerpython_robotik» the device is switched on there: the environment shows the simulator of the micro:bit, and as soon as the program imports a robot library, that of the robot as well. «starterCode» puts there what is already present when the question is opened. «graderCode» awards the points itself: a Python function «grade(answer, task, run)» that returns points and feedback — «answer» is the submission, «task» the question with its points, «run» the run of the program with its output. «graderRules» takes over the two cases in which a program does not get through at all. Marking code is executed as soon as it is used for marking; the import points that out expressly, and it should be read before it is taken over.

{
  "format": "tech-exam/questions",
  "formatVersion": 1,
  "questions": [
    {
      "topic": "Beispielfragen",
      "subtopic": "Programmieren",
      "subsubtopic": "TigerPython",
      "title": "Quadrat mit repeat",
      "contentType": "tigerpython",
      "maxPoints": 6,
      "description": "Zeichne mit der Turtle ein Quadrat mit Seitenlänge 100. Nutze dafür die `repeat`-Schleife von TigerPython.",
      "solution": "from gturtle import *\n\nmakeTurtle()\nrepeat 4:\n    forward(100)\n    right(90)\n",
      "criteria": [
        {
          "text": "`repeat 4:` wiederholt den eingerückten Block viermal – für ein Quadrat braucht es genau vier Durchgänge.",
          "points": 3
        },
        {
          "text": "Im Schleifenkörper gehören `forward(100)` und `right(90)` zusammen; ohne die Drehung entsteht eine Linie statt eines Quadrats.",
          "points": 3
        },
        {
          "text": "Ohne `makeTurtle()` gibt es nichts, was zeichnen könnte – das Programm bleibt gleich zu Beginn stehen.",
          "points": -1
        }
      ]
    },
    {
      "topic": "Beispielfragen",
      "subtopic": "Programmieren",
      "subsubtopic": "Roboter",
      "title": "Zwei Sekunden geradeaus",
      "contentType": "tigerpython_robotik",
      "maxPoints": 3,
      "description": "Lass den Roboter zwei Sekunden geradeaus fahren und danach anhalten.",
      "solution": "from mbrobot import *\n\nforward()\ndelay(2000)\nstop()\n",
      "criteria": [
        {
          "text": "`forward()` setzt den Roboter in Bewegung, `stop()` hält ihn wieder an.",
          "points": 2
        },
        {
          "text": "`delay(2000)` lässt dazwischen zwei Sekunden verstreichen – ohne die Wartezeit steht er, bevor er losgefahren ist.",
          "points": 1
        }
      ]
    },
    {
      "topic": "Beispielfragen",
      "subtopic": "Programmieren",
      "subsubtopic": "Python",
      "title": "Summe zweier Zahlen",
      "contentType": "python",
      "maxPoints": 10,
      "description": "Schreibe eine Funktion `add(a, b)`, die die Summe der beiden Argumente zurückgibt.",
      "solution": "def add(a, b):\n    return a + b\n",
      "starterCode": "def add(a, b):\n    # Gib hier die Summe von a und b zurück.\n    pass\n",
      "graderCode": "def grade(answer, task, run):\n    # Die Abgabe ausführen und die Funktion aus der Musterlösung holen. Ob sie\n    # sich überhaupt ausführen lässt, entscheiden die Regeln über diesem Feld.\n    umgebung = {}\n    exec(answer[\"value\"], umgebung)\n\n    funktion = umgebung.get(\"add\")  # Name aus der Musterlösung\n    if not callable(funktion):\n        return {\"points\": 0, \"feedback\": \"Die Funktion «add» fehlt.\"}\n\n    faelle = [((1, 2), 3), ((-1, 1), 0), ((0, 0), 0)]  # (Argumente, erwartet)\n    treffer = 0\n    for argumente, erwartet in faelle:\n        try:\n            if funktion(*argumente) == erwartet:\n                treffer += 1\n        except Exception:\n            pass\n\n    return {\n        \"points\": round(task[\"maxPoints\"] * treffer / len(faelle), 2),\n        \"feedback\": f\"{treffer} von {len(faelle)} Testfällen bestanden.\",\n    }\n",
      "graderRules": {
        "error": {
          "points": 0,
          "feedback": "Das Programm läuft nicht."
        },
        "timeout": {
          "points": 0,
          "feedback": "Das Programm wird nicht fertig."
        }
      }
    },
    {
      "topic": "Beispielfragen",
      "subtopic": "Programmieren",
      "subsubtopic": "SVG",
      "title": "Roter Kreis",
      "contentType": "svg",
      "maxPoints": 10,
      "description": "Zeichne mit SVG einen roten Kreis mit Radius 50 in der Mitte einer Zeichenfläche von $200 * 200$.",
      "solution": "<svg viewBox=\"0 0 200 200\">\n  <circle cx=\"100\" cy=\"100\" r=\"50\" fill=\"red\" />\n</svg>\n",
      "starterCode": "<svg viewBox=\"0 0 200 200\">\n  <!-- Zeichne den Kreis hier hinein. -->\n</svg>\n",
      "criteria": [
        {
          "text": "`cx` und `cy` liegen bei `100`, also in der Mitte der Zeichenfläche, und `r` bei `50`.",
          "points": 6
        },
        {
          "text": "`fill=\"red\"` füllt den Kreis rot – ohne `fill` zeichnet der Browser schwarz.",
          "points": 4
        }
      ]
    }
  ]
}

Gap text

The gap text is the only type whose question text is not in «description»: its text lives entirely in the segments. A gap without choices is typed, one with choices is clicked — and every gap needs the same identifier on both sides.

{
  "format": "tech-exam/questions",
  "formatVersion": 1,
  "questions": [
    {
      "topic": "Beispielfragen",
      "subtopic": "Fragetypen",
      "subsubtopic": "Lückentext",
      "title": "Klammern in Python",
      "contentType": "lueckentext",
      "maxPoints": 2,
      "answerSpec": {
        "kind": "cloze",
        "segments": [
          {
            "type": "text",
            "text": "Eine Liste wird mit "
          },
          {
            "type": "gap",
            "id": "g1",
            "choices": null
          },
          {
            "type": "text",
            "text": " erzeugt, ein Dictionary mit "
          },
          {
            "type": "gap",
            "id": "g2",
            "choices": [
              {
                "id": "g2c1",
                "text": "geschweiften Klammern"
              },
              {
                "id": "g2c2",
                "text": "runden Klammern"
              },
              {
                "id": "g2c3",
                "text": "spitzen Klammern"
              }
            ]
          },
          {
            "type": "text",
            "text": "."
          }
        ],
        "compare": {
          "caseSensitive": false,
          "normalizeWhitespace": true,
          "numericTolerance": null
        }
      },
      "answerKey": {
        "kind": "cloze",
        "gaps": {
          "g1": {
            "type": "text",
            "accepted": [
              "eckigen Klammern"
            ]
          },
          "g2": {
            "type": "choice",
            "correct": [
              "g2c1"
            ]
          }
        }
      }
    }
  ]
}

Questions with sub-questions

Where several parts share one question text, the sub-questions take the place of question type and points. The shared text then stands at the top and everything else with them. In the question collection each part becomes a single question that carries the shared text along. — which is why those same three also stand separately further up this page. Here they carry only title, question type and points, because a sub-question needs no more.

{
  "format": "tech-exam/questions",
  "formatVersion": 1,
  "questions": [
    {
      "title": "Robotik mit dem micro:bit",
      "description": "Die beiden Teilfragen programmieren dasselbe Gerät: zuerst sein Display, dann den Roboter, auf dem es sitzt.\n\nZum Ausprobieren braucht es keine Hardware – die Programmierumgebung zeigt beides im Simulator.",
      "subQuestions": [
        {
          "title": "Ein blinkendes Herz",
          "contentType": "tigerpython_robotik",
          "maxPoints": 4
        },
        {
          "title": "Zwei Sekunden geradeaus",
          "contentType": "tigerpython_robotik",
          "maxPoints": 3
        }
      ]
    }
  ]
}

What else applies

• Points are at least 0.5 and have at most 2 decimal places.
• Every identifier in «answerKey» must exist in «answerSpec», otherwise the question cannot be opened.
• A choice question needs at least two answers and at least one correct one.
• The file does not carry images. They are added afterwards in the editor.
• The file contains nothing but the questions — no sentence before it, no explanation after it.