Kontext – Anweisungen, Wissen & Anhänge
Anweisungen und Wissen im Kontext-Tab
Im Workspace findest du den Tab Kontext mit zwei Bereichen für alle Chats deines Projekts:
- Anweisungen sind projektweite Vorgaben für Agentful zu Sprache, Gestaltung oder Zusammenarbeit.
- Wissen enthält Referenzdateien wie Markenrichtlinien, Produktbeschreibungen oder technische Dokumentation. Agentful kann sie bei passenden Aufgaben heranziehen.
Eine Vorgabe gehört unter Anweisungen, Referenzmaterial unter Wissen. Für Material zu einer konkreten Aufgabe kannst du eine Datei direkt an deine Chat-Nachricht anhängen.
Deine Projektanweisungen
Beschreibe, worauf Agentful bei der Arbeit an deinem Projekt achten soll. Zum Beispiel:
- Schreibe alle Texte der App auf Deutsch und verwende die Du-Ansprache.
- Verwende vorhandene Farben und Komponenten auch für neue Ansichten.
- Frage nach, bevor du bestehende Funktionen entfernst.
Das Feld ist Freitext mit bis zu 8.000 Zeichen. Du kannst Absätze oder Listen verwenden; eine Anweisung pro Zeile ist keine Voraussetzung. Die aufklappbaren Beispiele sind Hilfetexte und werden nicht in deine Anweisungen übernommen.
Mit Anweisungen speichern übernimmst du deine Änderungen. Bis dahin zeigt die Oberfläche Ungespeicherte Änderungen. Gespeichert bestätigt erfolgreich geladene oder gespeicherte Anweisungen. Bei einem Speicherfehler bleibt dein Entwurf erhalten, damit du es erneut versuchen kannst. Um deine Anweisungen zu entfernen, leere das Feld und speichere es.
Agentful erhält deine Anweisungen bei Planungs- und Build-Aufgaben. Das ist keine technisch erzwungene Garantie, dass jede Vorgabe in jeder Ausgabe umgesetzt wird. Bei einem direkten Widerspruch hat die ausdrückliche Anweisung in deiner aktuellen Nachricht Vorrang.
Tipp: Speichern allein ändert deine App nicht und startet keinen Build. Bei späteren Aufgaben können die Anweisungen auch Anpassungen an bestehenden Bereichen auslösen, selbst wenn deine aktuelle Aufgabe einen anderen Bereich betrifft.
Was ist Wissen?
Wissen ist die dauerhafte Referenzbibliothek deines Projekts. Die Dateien stehen in allen Chats dieses Projekts zur Verfügung, bis du sie löschst.
Kleine Dateien können innerhalb der Größen- und Kontextgrenzen direkt bereitgestellt werden. Weitere Inhalte kann Agentful bei Bedarf durchsuchen. Es wird also weder jede Datei automatisch vollständig gelesen, noch gelangt ihr Inhalt ausschließlich über die Suche in den Kontext. Welche Informationen in eine Antwort oder Umsetzung einfließen, hängt von der Aufgabe ab.
Bereit bedeutet, dass eine Datei verarbeitet wurde und verfügbar ist. Der Status belegt nicht, dass Agentful sie in einer bestimmten Aufgabe verwendet hat.
Anweisungen und Wissen zusammen nutzen
Hinterlege deine Markenrichtlinien unter Wissen und ergänze unter Anweisungen: „Orientiere dich bei neuen Ansichten an den Markenrichtlinien im Wissen“.
So stehen die Vorgabe und das passende Referenzmaterial an ihrem jeweiligen Platz. Wissensdateien ersetzen keine Projektanweisungen: Ihr Inhalt wird als Referenzmaterial behandelt; direkte Nutzer- und Systemanweisungen haben Vorrang. Markenfarben, Gestaltungsvorgaben und andere Inhalte aus Richtlinien können trotzdem bei der Umsetzung helfen.
| Anweisungen | Wissen |
|---|---|
| Schreibe alle Texte der App auf Deutsch und verwende die Du-Ansprache. | Produktbeschreibungen und Fachbegriffe |
| Verwende vorhandene Farben und Komponenten auch für neue Ansichten. | Markenrichtlinien und Design-Dokumentation |
| Frage nach, bevor du bestehende Funktionen entfernst. | Technische Dokumentation und API-Referenz |
Wann Wissen, wann Anhang?
Ein Anhang wird mit einer konkreten Nachricht übergeben und bleibt vom Projektwissen getrennt. Er wird nicht automatisch in neue Chats übernommen. Hänge beispielsweise einen Screenshot oder eine kurze Beschreibung an, auf die sich deine aktuelle Aufgabe bezieht.
| An Nachricht anhängen | Unter Wissen hinzufügen | |
|---|---|---|
| Geltungsbereich | konkrete Nachricht im aktuellen Chat | alle Chats des Projekts |
| Bereitstellung | mit der Nachricht für die aktuelle Aufgabe | kleine Dateien gegebenenfalls direkt, weitere Inhalte per Suche |
| Typischer Inhalt | Screenshot, Mockup, kurze Feature-Beschreibung | Markenrichtlinien, Produktbeschreibungen, API-Referenz |
Die Faustregel: Eine Datei für jetzt → Anhängen. Referenzdateien fürs ganze Projekt → Wissen.
Grenzen und Dateiformate
- Pro Projekt: bis zu 10 Dateien und 20 MB insgesamt, einzelne Dateien bis 10 MB.
- Der Dateidialog bietet Text- und Codeformate wie Markdown, TXT, JSON, CSV und YAML sowie PNG, JPG/JPEG und WebP an. PDF gehört derzeit nicht zur Auswahl.
- Deine Wissensdateien werden in der EU (Frankfurt) verarbeitet und gespeichert und für dein Projekt bereitgestellt.
Wissen verwalten
Unter Kontext → Wissen fügst du Dateien über Dateien hinzufügen hinzu. Die Liste zeigt ihren Status, etwa Wird vorbereitet, Bereit oder Fehlgeschlagen. Bereite Dateien kannst du herunterladen, fehlgeschlagene erneut verarbeiten lassen und Dateien löschen. Anzahl und Speicherverbrauch stehen beim Upload-Bereich; den Vergleich mit Anhängen kannst du über Wann Wissen, wann Anhang? aufklappen.
Dateien, die du im Chat über Zu Projektwissen hinzufügen hochlädst, erscheinen unter Wissen.
Kontext mit Anweisungen und Wissen ist in allen kostenpflichtigen Tarifen verfügbar.