AutohausPilot Hilfe

Problemlösung · KI und Integrationen

Codex: Dateien, Freigaben und Zugriff

Prüfe Bestätigungen in Codex, Dokumentgrenzen und Zugriffsrechte und behebe abgelaufene Vorschauen oder fehlende Berechtigungen.

Eine Vorschau ist noch keine gespeicherte Änderung

Codex zeigt dir die vorbereiteten Werte und öffnet mit confirm_change einen persönlichen Bestätigungsdialog. Prüfe die konkrete Vorschau, setze die Bestätigung und nimm den Dialog an. Erst dann darf die Änderung gespeichert werden. Ein „ja“ oder „passt“ im Chat ersetzt diesen Dialog nicht; Codex darf die Bestätigung nicht für dich setzen.

Lehnst du ab, brichst du ab oder nimmst du ohne gesetzte Bestätigung an, wird nichts gespeichert und die Vorschau verworfen. Möchtest du die Änderung später doch übernehmen, lass sie neu vorbereiten.

Unterstützt dein Codex-Zugang den Dialog nicht, erhältst du einen persönlichen Freigabelink (approval_url). Öffne ihn selbst, melde dich bei Bedarf an, prüfe die Vorschau und speichere. Codex darf diese Freigabe nicht durch Browserautomation stellvertretend ausführen. Anmeldung und Zustimmung zu den Zugriffsrechten bei der Einrichtung bleiben ebenfalls im Browser.

Danach liest get_change den Vorgang erneut. Die Zustände bedeuten:

Mit cancel_change lässt sich eine offene Vorschau verwerfen. Das macht bereits gespeicherte Änderungen nicht rückgängig. Die Vorschau ist 30 Minuten gültig und kann nicht nachträglich verändert werden. Ein geöffneter Codex-Bestätigungsdialog gilt höchstens zehn Minuten, jedoch nie länger als die Vorschau. Ist er abgelaufen, lass die Änderung neu vorbereiten. Für andere Werte wird eine neue Vorschau vorbereitet. Wiederholtes Bestätigen derselben Vorschau erzeugt keine zweite Anlage; eine neue Vorschau ist dagegen ein eigener Vorgang. Bei unklarem Ausgang deshalb zuerst den bestehenden Vorgang prüfen.

Ändern sich relevante Ausgangsdaten zwischen Vorschau und Bestätigung, stoppt die App die Übernahme. Lass Codex den aktuellen Datensatz lesen und neu vorbereiten, statt dieselbe veraltete Vorschau wiederholt zu bestätigen.

Welche Rechte gebraucht werden

get_workspace zeigt die tatsächlich gewährten Rechte. Lesen und Schreiben sind getrennt:

Bei Kunden, Rechnungsentwürfen, Vorgängen, Terminen und der erweiterten Aufgabenpflege benötigen Änderungen auch das zugehörige Leserecht. Kunden-, Fahrzeug- und Vorgangsbezüge erfordern zusätzlich die Leserechte dieser Akten. Dokumentzugriffe benötigen das passende Dokumentrecht und das Leserecht der betroffenen Akte; bei einer Datei mit Kunden- und Fahrzeugbezug können beide Aktenrechte erforderlich sein. Feedback hat den eigenen Schreibzugriff.

Bestehende Verbindungen bekommen neue Rechte nicht automatisch. Verbinde erneut, bestätige die benötigten Bereiche und prüfe sie anschließend mit get_workspace. Eine sichtbare Werkzeugliste beweist keine Freigabe für jedes Werkzeug.

Dokumente gezielt lesen

  1. Lass das Fahrzeug oder den Kunden eindeutig suchen.
  2. list_vehicle_files oder list_customer_files listet zugängliche Dokumentmetadaten der Akte, höchstens 100 Einträge. Das ist noch kein Abruf des Dateiinhalts und kein vollständiger Datei-Export.
  3. Wähle das konkret benötigte Dokument. read_document ruft dessen Inhalt gezielt ab.

PDF, JPEG, PNG und WebP bis 2 MiB kommen als eingebettete Datei an den KI-Client. Ob er die Datei darstellen oder auswerten kann, hängt vom Client ab. Bei größeren unterstützten Dateien bis 10 MiB wird ausschließlich ein fünf Minuten gültiger Browserdownload angeboten, der eine Anmeldung verlangt. Ein Downloadlink bedeutet nicht, dass Codex den Inhalt bereits gelesen hat. Dateien über 10 MiB werden abgelehnt.

Zugelassene Dokumentarten sind Zulassungsbescheinigung Teil I/II, Ankaufs-/Verkaufsvertrag, Kommissionsvertrag, Rechnung, TÜV-Bericht, COC, Serviceheft, Übergabeprotokoll und sonstige Dokumente. Archivierte Dokumente werden nicht angeboten. Ausweise, SEPA-Mandate, Vollmachten, E-Mails und Zugangsdaten gehören nicht in diesen MCP-Dateiablauf; eine falsche Einstufung als „Sonstiges“ macht sie nicht geeignet.

Die sichere Fahrzeugfeldliste filtert keine Inhalte einer bewusst ausgewählten Datei. Eine Rechnung oder ein Vertrag kann Einkaufspreise, Adressen und andere Kundendaten enthalten. Nach dem gezielten Abruf kann der verbundene KI-Client diese Inhalte verarbeiten. Die Typprüfung ersetzt weder eine Inhaltsprüfung noch eine Virenprüfung.

Datei hochladen und einer Akte zuordnen

prepare_file_upload bereitet einen 30 Minuten gültigen Uploadlink für genau eine Fahrzeug- oder Kundenakte vor. Gib Zielakte, Dateiart und Titel vor; bei einem Dokument auch die Dokumentart. Fahrzeuge können Dokumente oder Fotos erhalten, Kunden ausschließlich Dokumente.

Öffne den Link und wähle die Datei bewusst im Browser aus. Unterstützt sind PDF, JPEG, PNG und WebP mit maximal 10 MiB; Fotos brauchen ein unterstütztes Bildformat. Prüfe danach die konkrete Dateivorschau. Du kannst die Zuordnung direkt dort selbst bestätigen oder die angezeigte Vorgangs-ID an Codex übergeben und den Bestätigungsdialog für diese Datei öffnen lassen (confirm_change mit kind: file). Bestätige die angezeigte Datei und Zielakte persönlich. Vor dieser Bestätigung ist die Datei noch nicht dauerhaft der Akte zugeordnet. Anschließend kann Codex das Ergebnis und die Dokumentliste prüfen.

Der MCP übernimmt keine lokalen Dateipfade und lädt keine beliebigen Internetadressen herunter. Die Dateien bleiben privat in AutohausPilot; es entsteht keine öffentliche Storage-Adresse.

Wenn der Zugriff scheitert

Bleibt das Problem bestehen, notiere die betroffene Aktion und die verständliche Fehlermeldung für hilfe@autohauspilot.de. Teile keine Zugangstokens, Passwörter oder privaten Freigabelinks.