Data

Was sind Datenelemente?

Datenelemente sind die Dateien, die du in deinen Agenten hochlädst — Bilder, Dokumente und andere Medien. Nach dem Hochladen befinden sie sich in der Dateibibliothek deines Agenten und können von anderen Stellen referenziert werden: als Produktbilder im Katalog, als Screenshots von Widgets oder als Wissensbasis-Inhalte, auf die der KI-Agent im Gespräch zurückgreifen kann.

Jedes Datenelement wird sicher gespeichert und ist über eine signierte URL zugänglich. Der Agent kennt die Dateien, die du hochlädst, und kann sie bei Bedarf einsetzen.

Datei hochladen

Öffne Daten in der linken Seitenleiste. Klicke rechts oben auf Hochladen.

Wähle eine Datei von deinem Computer. Sobald der Upload abgeschlossen ist, erscheint die Datei in deiner Datenbibliothek — Name, Typ und Größe werden automatisch ausgefüllt.

Optional kannst du direkt nach dem Hochladen eine Beschreibung hinzufügen. Beschreibungen sind intern — nutze sie, um festzuhalten, wofür die Datei gedacht ist, zu welchem Produkt sie gehört oder um dir und deinem Team das spätere Auffinden zu erleichtern.

Unterstützte Dateitypen

Datenelemente unterstützen eine Reihe von Dateiformaten:

| Kategorie | Formate | |-----------|---------| | Bilder | JPEG, PNG, WebP, GIF, SVG | | Dokumente | PDF | | Sonstiges | Jeder Dateityp kann hochgeladen werden, die Anzeige variiert je nach Typ |

Der MIME-Typ wird beim Hochladen automatisch erkannt. Du musst ihn nicht manuell angeben.

Dateidetails

Jedes Datenelement enthält folgende Angaben:

| Feld | Beschreibung | |------|--------------| | Name | Der Anzeigename der Datei. Beim Upload automatisch aus dem Dateinamen übernommen — jederzeit änderbar | | MIME-Typ | Wird beim Upload automatisch aus dem Dateiinhalt ermittelt | | Größe | Dateigröße, wird automatisch berechnet | | URL | Eine signierte URL für den Zugriff auf die Datei, ein Jahr gültig | | Beschreibung | Optionale interne Notiz zu Zweck oder Kontext der Datei |

Signierte URLs

Die URL eines Datenelements ist ein signierter Link — er enthält ein Sicherheitstoken, das nach einem Jahr abläuft. Die Datei ist daher nicht über eine einfache URL öffentlich zugänglich; nur Anfragen mit einem gültigen signierten Link erhalten Zugang.

Wenn eine URL abläuft, kannst du über die Detailseite des Datenelements eine neue generieren.

Wo Datenelemente verwendet werden

Datenelemente werden aus anderen Teilen von emercai referenziert:

Produktattribute — Wenn du einem Produkt ein Bildattribut hinzufügst, verknüpfst du es mit einem Datenelement aus deiner Bibliothek. So bleiben deine Produktbilder an einem zentralen Ort und Duplikate werden vermieden.

Widget-Screenshots — Jedes Widget kann einen Screenshot haben. Dieser wird als Datenelement gespeichert und auf der Detailseite des Widgets zur internen Referenz angezeigt.

Wissensbasis — Datenelemente wie PDFs und Dokumente können als Wissensbasis-Inhalt dienen und dem Agenten Zugang zu bestimmten Informationen geben, die du bereitstellst.

Einstellungen im Überblick

| Einstellung | Beschreibung | |-------------|--------------| | Name | Anzeigename der Datei, jederzeit änderbar | | Beschreibung | Interne Notiz zum Zweck der Datei | | MIME-Typ | Automatisch beim Upload gesetzt, nicht änderbar | | Größe | Automatisch beim Upload berechnet, nicht änderbar | | URL | Signierte Zugriffs-URL, ein Jahr gültig |

Daten verwalten

Suchen

Die Datenliste zeigt alle Dateien in der Bibliothek deines Agenten. Mit dem Suchfeld oben kannst du nach Name filtern.

Datei umbenennen oder Beschreibung aktualisieren

Klicke in der Liste auf ein Datenelement, um die Detailseite zu öffnen. Dort kannst du den Namen ändern und die Beschreibung bearbeiten. Die Umbenennung ist intern — die Datei auf dem Server behält ihren ursprünglichen Speicherpfad, sodass bestehende Links weiterhin funktionieren.

Datei löschen

Öffne die Detailseite des Datenelements und nutze die Lösch-Option am unteren Ende der Seite.

Das Löschen eines Datenelements entfernt die Datei aus dem Speicher und den Eintrag aus deiner Bibliothek. Wenn die Datei von einem Produktattribut oder Widget referenziert wird, bricht diese Verbindung. Prüfe vorher, wo eine Datei verwendet wird, bevor du sie löschst.

Das Löschen ist endgültig. Die Datei kann danach nicht wiederhergestellt werden.

Häufige Fragen

Wie lange sind signierte URLs gültig? Ein Jahr ab dem Zeitpunkt der Generierung. Danach läuft die URL ab und du musst über die Detailseite des Datenelements eine neue erstellen.

Kann ich eine Datei ersetzen, ohne den Link zu verlieren? Nicht direkt — das Hochladen einer neuen Datei erstellt ein neues Datenelement mit einer neuen URL. Wenn du eine Datei aktualisieren möchtest, die bereits von einem Produkt oder Widget referenziert wird, lade die neue Version hoch und aktualisiere dann den Link im Produktattribut oder Widget auf das neue Datenelement.

Gibt es eine Dateigrößenbegrenzung? Die Speicherlimits richten sich nach deinem Tarif. Die aktuellen Grenzen findest du in deinen Account-Einstellungen. Sehr große Dateien wie hochauflösendes Video eignen sich nicht — der Agent kann sie nicht direkt verarbeiten.

Werden Dateien zwischen Agenten geteilt? Nein. Jeder Agent hat seine eigene Datenbibliothek. Dateien, die für einen Agenten hochgeladen wurden, sind in anderen Agenten weder sichtbar noch zugänglich.

Was passiert mit Dateien, wenn ich ein Produkt lösche? Die Datenelemente selbst werden beim Löschen eines Produkts nicht entfernt. Lediglich die Verbindung zwischen dem Produktattribut und dem Datenelement wird aufgehoben. Die Datei bleibt in deiner Bibliothek und kann weiterhin verwendet werden.