Edumaps für KI-Agenten und Skripte

Diese Seite richtet sich an KI-Agenten, Browser-Agenten und Skripte, die im Auftrag einer angemeldeten Lehrkraft Maps in Edumaps erstellen. Der vorgesehene Weg: Die Map entsteht als eine JSON-Datei, die Lehrkraft importiert sie einmal.

Ein solcher Agent läuft auf dem Gerät der Lehrkraft und arbeitet in deren eigener Sitzung mit deren Rechten. Er sieht, was die Lehrkraft sieht. Bei diesem Weg überträgt Edumaps selbst keine Daten an einen KI-Anbieter. Welche Inhalte ein Agent lesen darf, entscheidet die Lehrkraft, die ihn einsetzt.

So entsteht eine Map

Bauen Sie die Map als ein JSON-Dokument nach der Dokumentation des JSON-Formats auf, mit "formatversion": 2. Dort stehen alle Felder und Regeln.
Die angemeldete Lehrkraft lädt die Datei auf der Seite „Edumaps-Datei importieren“ (/import/json) hoch, auf dem Server ihres eigenen Kontos: www.edumaps.de, he.edumaps.de, nds.edumaps.de, nrw.edumaps.de oder www.edumaps.ch. Die Seite nimmt nur eine Datei mit der Endung .json an, keinen eingefügten Text. Der Import setzt eine Anmeldung voraus, Konten von Schülern können ihn nicht nutzen.
Der Import legt eine neue, unveröffentlichte Map im Konto der Lehrkraft an und leitet danach zu ihr weiter. Eine bestehende Map wird nie überschrieben. Wurden Inhalte weggelassen oder gekürzt, nennt die Meldung nach dem Import ihre Anzahl. Öffnen Sie die Map und prüfen Sie sie.

Bilder, PDFs und andere Dateien

Ein Link auf eine Datei, die bereits auf Edumaps liegt, auch auf einem anderen Edumaps-Server, wird beim Import in das Konto der Lehrkraft kopiert. Der Link zeigt danach auf die Kopie, die Kopie belegt Speicherplatz dieses Kontos. Eine gelöschte Datei wird nicht kopiert. Schlägt eine Kopie fehl, bleibt der ursprüngliche Link stehen.
Links auf andere Websites, auch auf Bilder und PDFs, lädt der Import nicht herunter, sie bleiben Links. Steht ein Link als erstes Wort eines Absatzes, zeigt die Box ein Vorschaubild.
Die JSON-Datei kann keine Dateien selbst enthalten. Eine Datei, die noch nicht auf Edumaps liegt, lädt die Lehrkraft in der Map hoch.

Beispiel

Eine Map mit zwei Spalten und drei Boxen: Überschrift, Aufzählung, fetter Text, zwei Links in der Form {Linktext}{https://...} und eine Plakette über dem Box-Titel (Feld subject). Es ist dieselbe Datei wie das Beispiel zum JSON-Format, sie lässt sich ohne Fehler importieren.

{
	"formatversion": 2,
	"format": "Edumaps map export. Box content uses the Edumaps text markup (Markdown-like, raw HTML is shown literally). Documentation: https://www.edumaps.de/docs/json",
	"mapdata": {
		"title": "Wasserkreislauf",
		"subtitle": null,
		"tags": "Erdkunde Klasse5",
		"mapbg": "i10",
		"mapfont": "0",
		"mapformat": "0",
		"maptype": "0",
		"flags": "0",
		"language": "de",
		"extras": null
	},
	"paths": [
		{
			"title": "Grundlagen",
			"visiblefrom": null,
			"visibleuntil": null,
			"annotation": null,
			"color": null,
			"flags": "0",
			"widthmode": "1",
			"extras": null,
			"boxes": [
				{
					"title": "Was ist der Wasserkreislauf?",
					"content": "## Kurz erklärt\n\nWasser ist ständig in Bewegung.\n\n- Verdunstung\n- Kondensation\n- Niederschlag",
					"subject": "Erdkunde",
					"booktime": null,
					"booklimit": "0",
					"color": null,
					"flags": "0",
					"ratingmode": "1",
					"position": null,
					"visiblefrom": null,
					"visibleuntil": null,
					"extras": null
				},
				{
					"title": "Weiterlesen",
					"content": "**Tipp:** Eine Übersicht bietet {der Artikel auf Wikipedia}{https://de.wikipedia.org/wiki/Wasserkreislauf}.",
					"subject": null,
					"booktime": null,
					"booklimit": "0",
					"color": "#3a86ff",
					"flags": "16",
					"ratingmode": "0",
					"position": null,
					"visiblefrom": null,
					"visibleuntil": null,
					"extras": null
				}
			]
		},
		{
			"title": "Vertiefung",
			"visiblefrom": null,
			"visibleuntil": null,
			"annotation": null,
			"color": null,
			"flags": "0",
			"widthmode": "0",
			"extras": null,
			"boxes": [
				{
					"title": "Regen, Schnee und Hagel",
					"content": "Wie Wasser aus den Wolken fällt, erklärt der Artikel {Niederschlag}{https://de.wikipedia.org/wiki/Niederschlag}.",
					"subject": null,
					"booktime": null,
					"booklimit": "0",
					"color": null,
					"flags": "0",
					"ratingmode": "0",
					"position": null,
					"visiblefrom": null,
					"visibleuntil": null,
					"extras": null
				}
			]
		}
	]
}

Text in Boxen

Der Inhalt einer Box ist reiner Text im Edumaps-Textformat (Markdown-ähnlich), nie HTML. HTML-Tags erscheinen in der Box als sichtbarer Text. Links schreiben Sie als {Linktext}{https://...}. Eine Zeile, die mit „1.“ beginnt, bleibt normaler Text, nummerierte Listen beginnen mit -- . Alle Schreibweisen stehen in der Tabelle zum Textformat.

Bestehende Maps lesen

Die JSON-Datei einer Map erhält die Lehrkraft über „Map-Optionen“ → „Exportieren“ → „Edumaps-Datei (json)“. Der Eintrag erscheint bei Maps, die ihr gehören oder die sie bearbeiten darf. Die Datei hat dasselbe Format wie der Import.
Ein Leselink hat die Form https://<Server>/<Mapid>/<Userid>/<Lesecode>. Steht an dieser Stelle der Bearbeitungscode der Map, öffnet derselbe Link die Map zum Bearbeiten. Mit angehängtem Zugangscode für anonymes Lesen lautet er https://<Server>/<Mapid>/<Userid>/<Lesecode>/<Zugangscode> und öffnet die Map ohne Anmeldung. Ist die Map mit einem Passwort geschützt, erscheint zuerst das Passwortformular.
Das Handbuch für KI-Systeme: llms.txt (Übersicht, Englisch), llms-full.txt (vollständig, Deutsch) und handbook-en.md (vollständig, Englisch).

Was keine Schnittstelle ist

Die Anfragen, die der Editor im Hintergrund an den Server sendet, sind interne Funktionen von Edumaps. Sie ändern sich ohne Ankündigung und werden für die Nutzung durch Dritte nicht unterstützt. Agenten und Skripte erstellen Maps über den JSON-Import, wie oben beschrieben.

Eine REST-API bietet Edumaps nicht an, siehe die häufigen Fragen.

Grenzen beim Import

Die JSON-Datei ist höchstens 2 MB groß.
Wie viele Maps ein Konto anlegen kann, hängt vom Tarif ab, siehe Preise.
Höchstens 5 Importe pro Minute je Benutzerkonto.
Der Speicherplatz des Kontos darf nicht voll sein.
Mit mehr als 100 Spalten wird der Import abgelehnt.
Höchstens 500 Boxen, 300 Pfeile und 300 Textfelder je Map. Was darüber liegt, wird weggelassen, die Meldung nach dem Import nennt die Anzahl.
Die Höchstlängen der Texte stehen in den Tabellen zum JSON-Format.