Anleitung für KI-Agenten

Gib deinem KI-Agenten die Adresse dieser Website. Er kann hier eine Mindmap erstellen, dir den Link geben und sie später weiter bearbeiten.

Du bist ein KI-Agent? Nutze die folgenden HTTP-Aufrufe. Du brauchst weder ein Konto noch eine MCP-Installation. Alle Antworten sind direkt lesbare HTML-Seiten; das Ergebnis steht als JSON im Element <pre id="result">.

Vom Auftrag zur fertigen Mindmap

Recherchiere und strukturiere das gewünschte Thema selbst. Mind stellt die Mindmap dar; die Inhalte lieferst du.
Erzeuge eine neue zufällige UUID als request_id. Rufe auf derselben Domain /agent/mind_create?title=DEIN_TITEL&request_id=NEUE_UUID ab.
Lies writer_key und share_url aus der Antwort. Bewahre den Schlüssel für weitere Aufrufe auf.
Ergänze mit mind_add_node einen Hauptgedanken und anschließend Untergedanken. Die Antwort enthält jeweils node.id; verwende diese als parent. Für jede neue Änderung eine neue UUID.
Kontrolliere das Ergebnis mit mind_read. Gib dem Menschen den erhaltenen share_url als anklickbaren Link.

Beispielauftrag: „Untersuche die Genealogie der Dinosaurier und erstelle mit dieser Website eine Mindmap.“ Nach deiner Recherche könnte der erste Hauptgedanke „Dinosauria“ heißen; darunter ordnest du die recherchierten Gruppen ein. Formuliere Unsicherheiten und Quellen in deinen Inhalten und deiner Antwort.

Alle Aktionen

Basis ist immer die Domain, auf der du diese Anleitung liest. Strings als UTF-8 URL-kodieren, beispielsweise mit URLSearchParams oder urllib.parse.urlencode. Jeden Parameter genau einmal angeben. Platzhalter in den Beispielen durch tatsächliche Werte ersetzen.

GET-Pfad	Parameter
`/agent/mind_create`	`title` optional; `request_id` erforderlich. Liefert eine neue leere Mindmap, `writer_key` und `share_url`.
`/agent/mind_read`	`writer_key`. Liefert `document`, `clock` und `conflicts`.
`/agent/mind_add_node`	`writer_key`, `request_id`, `label`; optional `parent`, `x`, `y`. Ohne parent entsteht ein Hauptgedanke. Die Antwort enthält `node.id`.
`/agent/mind_update_node`	`writer_key`, `request_id`, `id` und mindestens eines von `label`, `parent`, `x`, `y`, `done`. `parent=null` macht einen Hauptgedanken, `done=true` oder `false` setzt den Status.
`/agent/mind_delete_node`	`writer_key`, `request_id`, `id`. Löscht diesen Gedanken und seine Untergedanken.
`/agent/mind_replace`	`writer_key`, `request_id`, `document` als URL-kodiertes JSON im unten beschriebenen Format. Ersetzt die gesamte Mindmap.
`/agent/mind_delete_session`	`writer_key`, `request_id`. Plant die Löschung für alle Teilnehmer. Fünf Minuten lang lässt sie sich in der Web-App abbrechen.

Beispiel: Schritt für Schritt per GET

/agent/mind_create?title=Dinosaurier&request_id=NEUE_UUID_1
/agent/mind_add_node?writer_key=WRITER_KEY&request_id=NEUE_UUID_2&label=Dinosauria&x=0&y=0
/agent/mind_add_node?writer_key=WRITER_KEY&request_id=NEUE_UUID_3&label=Ornithischia&parent=ID_AUS_SCHRITT_2&x=-260&y=180
/agent/mind_read?writer_key=WRITER_KEY

Platziere Gedanken mit Abstand, etwa 260 Einheiten horizontal und 140 vertikal. Titel: höchstens 100 Zeichen; Labels: höchstens 240 Zeichen; maximal 500 Gedanken. Koordinaten müssen endlich sein und zwischen −1.000.000 und 1.000.000 liegen.

Eine ganze Mindmap in einem Schritt füllen

Erstelle zunächst die Session. Sende dann dieses Format als document an mind_replace. IDs legst du beim Ersetzen selbst fest, jede ID eindeutig, jeder parent entweder eine existierende ID oder null. Zyklen sind ungültig.

{
  "format": "kideon-mind",
  "version": 1,
  "title": "Dinosaurier",
  "nodes": [
    {"id": "root", "label": "Dinosauria", "parent": null, "x": 0, "y": 0, "done": false},
    {"id": "ornithischia", "label": "Ornithischia", "parent": "root", "x": -260, "y": 180, "done": false}
  ]
}

GET-Querys dürfen maximal 7.500 Bytes lang sein. Bei längeren Inhalten ergänze Gedanken einzeln oder nutze POST /agent/mind_replace mit Content-Type: application/json und denselben Parametern als JSON-Objekt (maximal 256 KB). document ist darin ein Objekt. POST funktioniert für jede Aktion; Antworten bleiben HTML. Mit HTTP-Headern kannst du Authorization: Bearer WRITER_KEY anstelle des Query-Parameters verwenden. Der bestehende MCP-Endpunkt bleibt unter /mcp verfügbar.

Weiterarbeiten, Wiederholungen und Fehler

Für eine vorhandene Mindmap brauchst du ihren vollständigen Writer-Schlüssel (km2.…). Er steht im Fragment ihres Bearbeitungslinks nach #session=. Lies zuerst mind_read und verwende die gelieferten IDs. Bei paralleler Bearbeitung bevorzuge einzelne Änderungen; mind_replace ersetzt den gesamten Inhalt. Offene Konflikte können die Teilnehmer in der Web-App auflösen.

Ändernde GET-Aufrufe sind ausdrücklich Aktionen. Führe sie nur im Rahmen des Auftrags aus. Teile mit dem Menschen den Mindmap-Link; Aktions-URLs gehören ausschließlich in deine Werkzeugaufrufe. Neue Aktion: neue zufällige UUID. Identischer Retry: dieselbe request_id und exakt dieselben Parameter. Der laufende Server merkt sich Antworten eine Stunde im Arbeitsspeicher. Nach Ablauf oder Neustart besteht dieser Wiederholungsschutz nicht mehr. Prüfe bei unklarer Antwort erst mit mind_read, ob deine Änderung schon angekommen ist; starte keine blinden Wiederholungen.

HTTP 400: Parameter oder die in der Fehlerseite genannte Session prüfen. 401/403: Writer-Schlüssel und Origin prüfen. 404: Aktion unbekannt. 409: neue Aktion mit neuer request_id senden. 410: Session endgültig gelöscht. 413/414: kleinere Aufrufe verwenden. 429: später versuchen. 503: vor einer erneuten Änderung den Stand prüfen. Die Fehlerseite erklärt den konkreten Fehler.

Teilen und Speichern

Wer den Bearbeitungslink besitzt, kann die Mindmap lesen, bearbeiten und löschen. Gib ihn gezielt weiter. Bei Agent-Aufrufen verarbeitet der Server Schlüssel und Inhalte kurzzeitig im Arbeitsspeicher und speichert die Mindmap verschlüsselt. GET-Parameter sind für das aufrufende Werkzeug und dessen URL-Verlauf sichtbar. Die Antworten werden nicht gecacht. In der Web-App kannst du separat einen Nur-Lesen-Link erstellen und deine Mindmap als Datei sichern. Online-Mindmaps laufen nach 18 Monaten ohne Aktivität ab.