Zum Hauptinhalt springen
Artefakte sind die Dateien, die KI-Agenten während Gesprächen erstellen — Bilder, HTML-Seiten, Code-Dateien, Dokumente und andere Ausgaben. Die Seite Artefakte ist eine gesprächsübergreifende Galerie, mit der Sie alles finden, in der Vorschau anzeigen und herunterladen können, was Ihre Agenten erstellt haben.

​
Wie Artefakte erstellt werden

Jedes Tool, das ein ToolResult mit einer artifacts-Liste zurückgibt, generiert herunterladbare Dateien. Der Agent benötigt keine speziellen Anweisungen — die Artefakterstellung ist eine natürliche Nebenwirkung der Tool-Ausführung. Häufige Produzenten:
ToolArtefakttypBeispiel
python_execBilder, HTML, CSV, JSONEin matplotlib-Diagramm gespeichert als PNG
template_renderHTMLEin formatierter Bericht
Code-Ausführungs-ToolsBeliebige DateiGenerierter Code, exportierte Daten
BildgenerierungBilderKI-generierte Illustrationen
Wenn ein Tool ein Artefakt erzeugt, wird es inline in der Konversation als herunterladbare Anlage angezeigt. Alle Artefakte werden auch in der Artefaktgalerie für konversationsübergreifendes Durchsuchen gesammelt.

​
Die Galerie

Die Seite Artefakte (/artifacts) bietet eine einheitliche Ansicht aller Dateien, die Sie in allen Gesprächen generiert haben.

​
Filterung

Vier Typfilter grenzen die Ansicht ein:
FilterDateitypen
AlleAlles
BilderPNG, JPG, GIF, SVG, WebP
HTMLHTML-Seiten und Berichte
CodePython, JavaScript, TypeScript, JSON, YAML, XML, CSS, SQL, Markdown, Shell-Skripte
DateienAlles andere — CSV, PDF, Nur-Text, Binärdateien

​
Vorschau

Klicken Sie auf ein beliebiges Artefakt, um eine Inline-Vorschau zu öffnen:
  • Bilder — werden in voller Auflösung angezeigt
  • HTML — wird in einem isolierten Iframe angezeigt (Skripte isoliert)
  • Code — syntaxhervorgehoben mit automatischer Spracherkennung
  • Markdown — wird als formatierter Text angezeigt
  • Sonstiges — wird als Klartext angezeigt oder als Download-Aufforderung
Verwenden Sie die Pfeiltasten, um zwischen Artefakten zu navigieren. Drücken Sie Escape, um die Vorschau zu schließen.

​
Metadaten

Jedes Artefakt zeigt:
  • Dateiname und Größe
  • Erstellungszeitstempel
  • Quellkonversation (klicken Sie, um zur Konversation zurückzukehren, in der es generiert wurde)

​
Speicher

Artefakte werden im Server-Dateisystem unter uploads/conversations/{conversation_id}/artifacts/ gespeichert. Jedes Artefakt erhält einen UUID-basierten Dateinamen, wodurch URLs nicht zu erraten sind. Dateien werden direkt bereitgestellt – es gibt keine Datenbankeinträge für einzelne Artefakte, was die Speicherschicht einfach und schnell hält.

​
API

EndpointDescription
GET /api/artifactsListet alle Artefakte für den aktuellen Benutzer auf. Unterstützt ?page=, ?size=, ?type= Filter
GET /api/conversations/{id}/artifactsListet Artefakte für ein bestimmtes Gespräch auf
GET /api/conversations/{id}/artifacts/{artifact_id}Lädt ein bestimmtes Artefakt herunter