> ## Documentation Index > Fetch the complete documentation index at: https://documentation.go-lizard.com/llms.txt > Use this file to discover all available pages before exploring further. # Import mit KI-Agenten > Einen KI-Agenten den Import aus Bestellungen, Listen und Prüfzertifikaten vorbereiten lassen, den Entwurf prüfen und in ExpressImport übernehmen. Mit dem **Agenten-Import** überlässt du die Vorarbeit einem KI-Agenten wie Claude. Er liest deine Quelldateien, etwa eine Bestellung als Excel-Tabelle und die Prüfzertifikate als PDF, und baut daraus einen **Entwurf** mit Katalogen und Betriebsmitteln. Du prüfst den Entwurf in ExpressImport, übernimmst ihn und sendest ihn wie gewohnt an Lizard. Der Agent legt in Lizard nichts an. Er bekommt keinen Lizard-Token und kann in Lizard weder anlegen noch ändern noch löschen. An Lizard gesendet wird erst, wenn du in ExpressImport selbst auf **Senden** klickst. ## Zwei Wege Beide Wege erreichst du in der Katalog-Übersicht über die Schaltflächen neben **Neuer Katalog**. Der kürzere Weg. Dein Agent ist mit ExpressImport verbunden. Du gibst ihm einen Code, er holt sich die Stammdaten selbst, prüft seinen Entwurf und legt ihn ab. Prüfberichte kann er selbst hochladen. Schaltfläche **Übergabe starten**. Für Agenten ohne Verbindung zu ExpressImport. Du lädst die Stammdaten als ZIP herunter, gibst sie dem Agenten und ziehst seine Entwurfsdatei zurück in ExpressImport. Schaltflächen **Kontext exportieren** und **Entwurf importieren**. Die Prüfung, die Vorschau und die Übernahme sind auf beiden Wegen gleich. ## Voraussetzungen * Du bist in ExpressImport mit dem Token der Firma angemeldet, für die du importierst (siehe [Erste Schritte](/expressimport/getting-started)). Ein Entwurf gehört immer zu genau dieser Firma. * Kategorien, Standorte, Verantwortliche und Prüfkategorien, die der Agent verwenden soll, gibt es in Lizard bereits. Der Agent wählt nur aus dem, was vorhanden ist, und legt keine Stammdaten an. * Für die Übergabe mit Code: ein Agent, der sich mit einem MCP-Server verbinden kann, zum Beispiel Claude. ## Agenten mit ExpressImport verbinden Das richtest du einmal ein. Die Verbindung ist unabhängig vom Lizard-Connector aus [KI-Agenten mit Lizard verbinden](/ki-agenten/einfuehrung): Über ExpressImport greift der Agent nie auf Lizard zu. Die Adresse lautet `https://expressimport.go-lizard.com/mcp`. Arbeitest du mit einer anderen ExpressImport-Adresse, hängst du `/mcp` an diese Adresse an. Öffne Claude am Rechner unter **Customize → Connectors**, wähle **Add custom connector** und trage die Adresse ein. Führe im Terminal diesen Befehl aus: ```bash theme={null} claude mcp add --transport http expressimport https://expressimport.go-lizard.com/mcp ``` Eine Anmeldung gehört nicht dazu. Zugriff auf deine Daten bekommt der Agent erst mit dem Code einer laufenden Übergabe. ## Import per Übergabe Klicke in der Katalog-Übersicht auf **Übergabe starten**. ExpressImport zeigt einen Code der Form `7F3K-2M9P-XR`. Mit dem Kopier-Symbol daneben kopierst du ihn. Schreib dem Agenten, was er vorbereiten soll, und gib ihm den Code und die Quelldateien. Unter dem Code steht, solange du wartest: *Code an den Agenten geben. Warte auf seinen Entwurf...* Der Agent holt sich mit dem Code die Stammdaten deiner Firma, baut den Entwurf und prüft ihn so oft wie nötig. Lädt er Prüfberichte hoch, zählt die Zeile unter dem Code mit, zum Beispiel *· 10 Berichte hochgeladen*. Sobald der Agent seinen Entwurf abgelegt hat, öffnet sich das Fenster **Entwurf des Agenten**. ExpressImport hat ihn vorher gegen den aktuellen Stand deiner Stammdaten in Lizard geprüft. Was du dort siehst, steht unter [Den Entwurf prüfen](#den-entwurf-pr%C3%BCfen). Klicke auf **Übernehmen**. Die Schaltfläche nennt die Zahl der Items. Hat der Agent Prüfberichte hochgeladen, holt ExpressImport sie zuerst ab. Mit dem Übernehmen endet die Übergabe. Die Meldung nennt, wie viele Kataloge und Items übernommen wurden. Mit **Fertig** schließt du das Fenster. Die übernommenen Kataloge stehen in der Katalog-Übersicht wie jeder andere Katalog. Klappe in der Katalogkarte die Items auf und sende sie, wie unter [Batch-Import](/expressimport/batch-import#batch-senden) beschrieben. Ein Auftrag an den Agenten kann so aussehen: *„Bereite mit ExpressImport den Import aus der Bestellung und den Zertifikaten im Ordner Lieferung vor. Der Code ist 7F3K-2M9P-XR."* Soll ein Prüfergebnis mitgehen, nenne dem Agenten auch den Prüfer, bei Werksbescheinigungen etwa den Hersteller. Ohne Prüfer lehnt Lizard das Prüfergebnis beim Senden ab. ### Während die Übergabe läuft Neben dem Code stehen drei Schaltflächen: | Schaltfläche | Wirkung | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Kopier-Symbol | Kopiert den Code. | | Symbol mit den zwei Pfeilen | Liest die Stammdaten für den Agenten neu ein. Nutze es, wenn du während der Übergabe etwas in Lizard geändert hast, zum Beispiel eine Kategorie angelegt. Sag dem Agenten danach, dass er den Kontext neu laden soll. | | Kreuz | Beendet die Übergabe sofort. | Der Code bleibt sichtbar, solange die Übergabe läuft, auch wenn du die Seite neu lädst. Während das Katalog-Formular offen ist, blendet ExpressImport ihn aus und wartet nicht auf Entwürfe. Nach dem Schließen geht es weiter. Dein Browser merkt sich nur **eine** Übergabe. Startest du in einer anderen Firma eine neue, kannst du die erste in diesem Browser weder mehr ansehen noch übernehmen oder beenden. Sie verfällt dann nach 24 Stunden. Beende eine Übergabe deshalb mit dem Kreuz, bevor du eine neue startest. Schließt du das Fenster mit dem Entwurf über **Später ansehen**, bleibt der Entwurf erhalten. Unter dem Code steht dann *Ein Entwurf des Agenten liegt bereit* und daneben **Entwurf ansehen**. Bessert der Agent nach, während du einen Entwurf ansiehst, tauscht ExpressImport die Ansicht nicht unter dir aus. Stattdessen erscheint der Hinweis *Der Agent hat inzwischen nachgebessert.* Mit **Neuere Fassung laden** holst du die neue Fassung. ### Wann eine Übergabe endet Eine Übergabe endet, wenn * du den Entwurf übernimmst, * du sie mit dem Kreuz beendest, * 24 Stunden seit dem Start vergangen sind oder * der Agent fünfmal hintereinander einen Entwurf ablegen will, der sich gar nicht ablegen lässt, zum Beispiel einen für eine andere Firma. Danach steht in der Katalog-Übersicht wieder **Übergabe starten**. Brauchst du den Agenten noch, startest du eine neue Übergabe und gibst ihm den neuen Code. ## Import per Entwurfsdatei Klicke auf **Kontext exportieren**. ExpressImport lädt die Datei `expressimport-kontext.zip` herunter. Sie enthält die Stammdaten deiner Firma und die Regeln, nach denen der Agent den Entwurf aufbauen soll. Gib dem Agenten die ZIP-Datei zusammen mit deinen Quelldateien. Er liefert eine Entwurfsdatei im JSON-Format zurück. Klicke auf **Entwurf importieren** und ziehe die Entwurfsdatei in das Fenster oder klicke hinein, um sie auszuwählen. Lege genau eine Datei ab. ExpressImport prüft sie sofort gegen den aktuellen Stand deiner Stammdaten. Prüfe Befunde und Vorschau, wie unter [Den Entwurf prüfen](#den-entwurf-pr%C3%BCfen) beschrieben, und klicke auf **Übernehmen**. Mit **Andere Datei prüfen** kehrst du vorher zum Ablegen zurück. Lege eine Entwurfsdatei nach dem Übernehmen nicht ein zweites Mal ab. ExpressImport legt Kataloge und Items sonst noch einmal an. Auf diesem Weg lädt niemand Prüfberichte hoch. Wie du sie danach zuordnest, steht unter [Prüfberichte des Agenten](#pr%C3%BCfberichte-des-agenten). ## Den Entwurf prüfen Oben im Fenster stehen die Zahl der Kataloge und Items und die Zahl der Befunde, getrennt nach Stufe. ### Befunde | Stufe | Beispiele | Übernehmen | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **Fehler** | Eine Kategorie, ein Standort oder eine Prüfkategorie existiert in dieser Firma nicht. Ein Wert passt nicht zum Attribut, etwa eine Einheit im Zahlenfeld oder eine nicht erlaubte Auswahl. Der Entwurf gehört zu einer anderen Firma. | gesperrt | | **Warnungen** | Die Stammdaten haben sich geändert, seit der Agent sie geholt hat. Ein Pflichtattribut ist bei einigen Items leer. Eine Betriebsmittelnummer kommt mehrfach vor. Ein Prüfbericht fehlt oder ist nicht hochgeladen. | möglich | | **Hinweise** | Annahmen, die der Agent selbst meldet, zum Beispiel eine umgerechnete Einheit oder ein Wert, den er in der Quelle nicht sicher lesen konnte. Hinweise sind eingeklappt, die Zahl steht in der Kopfzeile. | möglich | Solange ein Fehler vorliegt, bleibt **Übernehmen** gesperrt. Bei einer Übergabe sagst du dem Agenten, was er korrigieren soll, und lädst seine neue Fassung. Beim Weg über die Entwurfsdatei lässt du dir eine korrigierte Datei geben und legst sie über **Andere Datei prüfen** neu ab. Lies die Hinweise vor dem Übernehmen. Dort meldet der Agent, wo er geraten, umgerechnet oder etwas nicht gefunden hat. Unter **Bericht des Agenten** fasst er zusätzlich zusammen, was er getan hat. ### Vorschau ExpressImport wählt die Vorschau für den ganzen Entwurf selbst: Wenn sich in jedem Katalog die Items nur in Nummer, DynTag und Prüfbericht unterscheiden und alle aus derselben Quelldatei stammen, etwa aus einer Bestellung. Die Zeile zeigt Anzahl, Name, die Attributwerte und den Katalognamen. Sobald ein Katalog das nicht erfüllt, typischerweise wenn jedes Item aus einem eigenen Zertifikat gelesen wurde. ExpressImport zeigt bis zu fünf Items vollständig, darunter das erste und das letzte, jeweils mit allen Attributen und der **Quelle**. Die Quelle nennt das Dokument oder die Tabellenzeile, aus der der Agent ein Item gelesen hat. Kommt dir ein Wert verdächtig vor, schlägst du dort nach. Bei einer Übergabe zeigt die Vorschau außerdem, ob die Prüfberichte angekommen sind: in der Stichprobe *bereit* oder *nicht hochgeladen* je Item, in der Zeile je Katalog zum Beispiel *8 von 10 Berichten*. ## Prüfberichte des Agenten Prüfberichte gibt der Agent im Entwurf mit ihrem Dateinamen an. Wie die Dateien selbst in ExpressImport ankommen, hängt davon ab, ob dein Agent Befehle auf deinem Rechner ausführen kann. Ein Agent, der Befehle ausführen kann, zum Beispiel Claude Code, lädt die Prüfberichte während der Übergabe selbst hoch. Die Dateien gehen dabei direkt von deinem Rechner an ExpressImport, nicht durch den Chat. Beim Übernehmen holt ExpressImport die hochgeladenen Berichte ab, die im Entwurf stehen, und hängt jeden an die Items oder den Katalog, für die der Agent ihn angegeben hat. Die Meldung nach dem Übernehmen nennt die Zahl der angehängten Prüfberichte. Fehlen einzelne Berichte, ordnest du sie danach selbst zu, wie im Tab daneben beschrieben. Das Abholen gilt ganz oder gar nicht: Lässt sich ein hochgeladener Bericht nicht abholen, legt ExpressImport keinen Katalog und kein Item an und meldet *Es wurde nichts übernommen.* mit dem Grund. Die Übergabe bleibt bestehen, du kannst es erneut versuchen. Kann dein Agent keine Befehle ausführen oder arbeitest du mit der Entwurfsdatei, lädt niemand die Berichte hoch. Bei einer Übergabe ist die Warnung, dass Prüfberichte nicht hochgeladen sind, dann erwartet. Nach dem Übernehmen listet die Meldung unter *Es fehlen noch Prüfberichte je Item:* je Katalog, wie viele fehlen, mit Beispielen für die Dateinamen. Klappe in der Katalogkarte die Items auf und ziehe die Dateien in den Bereich **Prüfberichte zuordnen**. Eine Datei mit dem Namen aus dem Entwurf geht direkt an ihr Item, den Ordnerpfad brauchst du dafür nicht. Details unter [Eigene Datei pro Item](/expressimport/pruefergebnisse#eigene-datei-pro-item). Gilt ein Bericht für mehrere Items, bitte den Agenten, ihn bei jedem dieser Items anzugeben. Dann legst du die Datei einmal ab, und jedes dieser Items bekommt sie. Einen Bericht, den der Agent für den ganzen Katalog angegeben hat, müsstest du dagegen im Katalog-Formular ablegen. Das lässt sich aber erst speichern, wenn alle Pflichtattribute im Katalog gefüllt sind, und die sind in einem übernommenen Katalog leer. Prüfberichte müssen PDF-, JPG- oder PNG-Dateien sein und dürfen höchstens 3 MB groß sein. ## Was der Agent sieht Mit dem Code oder der ZIP-Datei bekommt der Agent die Stammdaten deiner Firma: * Kategorien mit ihren Attributen * Standorte * Benutzer mit Vor- und Nachname, ohne E-Mail-Adresse * Prüfkategorien und Compliances * die Namen der Kataloge, die du in ExpressImport schon angelegt hast * den Firmennamen, den du in ExpressImport vergeben hast, und die interne Kennung deiner Firma in Lizard Dazu kommen die Quelldateien, die du ihm gibst. All das geht an die KI-Anwendung, die du einsetzt, und an den Anbieter des Sprachmodells dahinter. Solange eine Übergabe läuft, liegen die Stammdaten, der Entwurf und die hochgeladenen Prüfberichte auf dem Server von ExpressImport, höchstens 24 Stunden lang. Mit dem Ende der Übergabe werden sie gelöscht. Wer den Code kennt, kann während der Übergabe die Stammdaten deiner Firma lesen, einen Entwurf ablegen oder den abgelegten ersetzen und Prüfberichte hochladen oder ersetzen. Sieh dir Vorschau und Hinweise deshalb vor dem Übernehmen genau an. Gib den Code nur deinem Agenten und beende die Übergabe mit dem Kreuz, wenn du sie nicht mehr brauchst. Den abgelegten Entwurf und die Prüfberichte kann niemand mit dem Code allein abrufen, dafür braucht es den Lizard-Token, mit dem du die Übergabe gestartet hast. ## Häufige Fragen Der Entwurf enthält mindestens einen Fehler. Fehler stehen immer ausgeklappt oben in der Liste der Befunde. Steht statt der Vorschau *Keine Vorschau verfügbar*, konnte ExpressImport den Entwurf nicht lesen. Lass dir vom Agenten eine neue Fassung geben. Der Befund lautet *Dieser Entwurf gehört zu …, aktiv ist aber …*. Wähle oben in der Firmenauswahl die Firma, für die der Entwurf erstellt wurde, und lege die Entwurfsdatei dort erneut ab. Klicke neben dem Code auf das Symbol mit den zwei Pfeilen und sag dem Agenten, dass er den Kontext neu laden soll. Ein schon abgelegter Entwurf bleibt stehen. Er bekommt beim nächsten Prüfen die Warnung, dass sich die Stammdaten geändert haben. Lade außerdem die Seite in deinem Browser neu, bevor du übernimmst. ExpressImport liest die Kategorien für die Übernahme beim Öffnen der Seite ein. Verwendet der Entwurf eine Kategorie, die du erst danach angelegt hast, bricht **Übernehmen** sonst mit der Meldung ab, die Kategorie sei im aktiven Mandanten nicht gefunden worden. Die Übergabe bleibt beim Neuladen erhalten. Ja. Übernommene Items bearbeitest, löschst und sendest du wie selbst angelegte. Übernommene Kataloge haben aber keine fortlaufende Nummer und leere Attributwerte im Katalog. Weitere Kopien, die du dort erstellst, bekommen deshalb alle dieselbe Nummer, und das Katalog-Formular lässt sich erst speichern, wenn du die Pflichtattribute ausgefüllt hast. Für die Übergabe jeder Agent, der sich über HTTP mit einem MCP-Server verbinden kann. Für den Weg über die Entwurfsdatei jeder Agent, der die ZIP-Datei und deine Quelldateien lesen und eine JSON-Datei schreiben kann. ## Nächste Schritte Prüfberichte je Item zuordnen, auch per Drag-and-Drop vieler Dateien auf einmal. Übernommene Items an Lizard senden.