Prüfen, ohne die Tokens deines Agenten zu verbrauchen.

Zwei verschiedene Dinge bleiben in diesem Ablauf günstig: was der Agent vom Werkzeugaufruf zurückbekommt und was es braucht, um zu bestätigen, dass das Ergebnis stimmt.

Der Werkzeugaufruf liefert ein kleines JSON-Objekt, nicht die gerenderte Seite, und die gerenderte Seite selbst prüft ein Mensch in MarsDawn. Sie wird nie in den Kontext des Agenten zurückgelesen.

Der Werkzeugaufruf selbst ist günstig

Ruf marsdawn export auf, über die CLI, den Skill oder den MCP-Server, und zurück kommt ein kompaktes JSON-Objekt: ok, output, pages, theme, paper und diagramErrors. Das vollständige Schema ist export.v1.json. Nichts davon ist das gerenderte Dokument. Ein PDF mit 50 Seiten und einem Dutzend Mermaid-Diagrammen liefert dieselben paar Felder wie eine Notiz mit einer Seite.

Geprüft wird nebenan

Sobald das PDF existiert, öffnet es ein Mensch, in MarsDawn oder einem beliebigen PDF-Programm, und liest Diagramme, Formeln und Layout gerendert. Der Agent muss diese gerenderte Ausgabe nie in sein eigenes Kontextfenster zurücklesen, um zu bestätigen, dass sie stimmt: Geprüft wird in einem eigenen Fenster, auf einem eigenen Bildschirm, nicht in einer weiteren Runde von Tokens, die beschreiben, wie ein Diagramm aussieht.

Was das vermeidet

Gerendertes Markdown, einen Screenshot oder die Beschreibung davon in die Unterhaltung zurückzukopieren, nur damit der Agent bestätigen kann, dass der Export geklappt hat.
Einen Agenten, der rekonstruieren muss, wie ein Mermaid-Diagramm oder eine KaTeX-Formel gerendert aussieht, statt dass ein Mensch einfach hinschaut.
Einen zweiten Werkzeugaufruf, um den Inhalt des PDFs zu holen, nachdem der erste schon Erfolg gemeldet hat.

Weiter

Die drei Wege, marsdawn aufzurufen, CLI, Skill-Datei, MCP-Server: drei Zugänge.
Jedes Feld im JSON-Ergebnis: marsdawn für Agenten.
Warum ein Mensch trotzdem lesen muss, was ein Agent geschrieben hat: Warum Prüfen nötig ist.
Die ausführlichere Begründung, Agentenausgaben zu lesen, mit einer Checkliste: Lesen, was dein Agent zurückgibt.