FlowModels

Dokumente für einen Endnutzer hochladen und als Kontext nutzen

Veröffentlicht am 11. November 2026

Wenn deine Anwendung Fragen zu den Unterlagen eines bestimmten Kunden beantworten soll, etwa zu seinem Vertrag oder seiner Preisliste, lädst du diese Dokumente für den Endnutzer hoch. Das Brain sucht bei späteren Anfragen derselben Person automatisch die passenden Stellen heraus und gibt sie dem Modell mit. Du musst dafür keine eigene Suche und keine eigenen Embeddings bauen.

Schritt 1: Den Endnutzer anlegen

Für den Upload brauchst du die id des Endnutzers, nicht deine eigene Kennung. Du bekommst sie mit POST /v1/end-users:

curl -X POST https://api.flowmodels.one/v1/end-users \
  -H "Authorization: Bearer at_dein_schluessel" \
  -H "Content-Type: application/json" \
  -d '{"external_identifier": "kunde-1042"}'

Gibt es den Endnutzer schon, bekommst du den vorhandenen Datensatz zurück. Die id in der Antwort verwendest du im nächsten Schritt.

Schritt 2: Die Datei hochladen

Achte auf den Pfad: Hier steht end_users mit Unterstrich, die Verwaltung der Endnutzer nutzt dagegen end-users mit Bindestrich.

curl -X POST https://api.flowmodels.one/v1/end_users/018f1234-5678-7abc-9def-0123456789ab/files \
  -H "Authorization: Bearer at_dein_schluessel" \
  -H "Accept: application/json" \
  -F "file=@angebot-2026.pdf" \
  -F "purpose=user_data"

purpose ist immer user_data. Den Content-Type mit Boundary setzt dein HTTP-Client bei multipart/form-data selbst.

Schritt 3: Warten, bis die Datei bereit ist

Der Upload antwortet mit HTTP 201 und status: "pending". Die Datei ist dann gespeichert, aber noch nicht nutzbar. Wir lesen den Text aus und bereiten ihn für die Suche auf. Erst danach finden spätere Anfragen die passenden Stellen. Den Stand siehst du mit:

curl https://api.flowmodels.one/v1/end_users/018f1234-5678-7abc-9def-0123456789ab/files \
  -H "Authorization: Bearer at_dein_schluessel"

Vorübergehende Fehler bei der Verarbeitung wiederholen wir selbst. Ein Dokument, aus dem sich kein Text lesen lässt, etwa ein reiner Scan ohne Textebene, kann dauerhaft scheitern.

Schritt 4: Fragen stellen

Schick deine Anfrage wie gewohnt mit derselben external_identifier. Das Brain zieht die passenden Abschnitte aus den Dateien dieser Person heran, siehe Brain nutzen: Unterhaltungen je Endnutzer speichern und fortsetzen. Die Dateien eines Endnutzers sieht nur dieser Endnutzer, nie ein anderer.

Dateitypen und Grenzen

  • PDF, Word (DOCX, DOC), RTF, Excel (XLSX), PowerPoint (PPTX), Text (TXT), Markdown und CSV
  • höchstens 32 MiB je Datei
  • höchstens 100 Dateien je Endnutzer
  • höchstens 5 GiB für alle Endnutzerdateien deines Teams zusammen
  • Dateinamen bis 255 Zeichen

Maßgeblich für den Typ ist die Dateiendung. Andere Endungen lehnt die API mit dem Hinweis unsupported_file_type ab, zu große Dateien mit file_too_large.

Dateien prüfen und einzeln löschen

Aufgabe Aufruf
alle Dateien eines Endnutzers, neueste zuerst GET /end_users/{id}/files
eine Datei, ohne Inhalt GET /end_users/{id}/files/{datei}
eine Datei löschen DELETE /end_users/{id}/files/{datei}

Beim Löschen entfernen wir die Datei und alle daraus gewonnenen Textabschnitte. Danach kann das Brain sie nicht mehr verwenden. Für die Abrechnung des bereits genutzten Speichers bleibt ein Eintrag ohne Dateiname und ohne Inhalt zurück, der in keiner Liste erscheint. Eine unbekannte oder fremde Datei beantworten wir mit 404 file_not_found.

In der Oberfläche siehst du die Dateien unter Endnutzer › Details anzeigen mit Name, Größe und Datum.

Was das kostet

Für das Speichern fällt derzeit keine monatliche Gebühr an. Die Verarbeitung beim Hochladen, zum Beispiel das Erzeugen der Embeddings, wird als Modellverbrauch berechnet. Bei späteren Anfragen kostet die Suche in den Dateien ebenfalls ein wenig, das steckt in usage.cost der jeweiligen Antwort.

Abgrenzung

Endnutzerdateien sind Wissen, auf das das Brain bei Bedarf zugreift. Sie sind getrennt von den Dateien unter /files, die du direkt als Anhang an eine einzelne Nachricht hängst. Eine Datei-ID der Endnutzerdateien funktioniert nicht als file_id in einer Nachricht. Mehr zu Anhängen steht in Bilder, PDFs und Audio an ein Modell schicken.

War dieser Artikel hilfreich?

Zurück zu Webhooks, Endnutzer & MCP