KI-Assistent¶
Teilweise verfügbar
Der KI-Assistent ist als eigene Seite KI-Assistent (/ki-assistent) nutzbar: Wissensfragen und ein kontextloser Chat funktionieren bereits. Die auf dieser Seite ebenfalls beschriebenen Tipp-Karten, der Tipp des Tages und die „Warum?"-Buttons sind als Bausteine im Frontend bereits gebaut, aber noch auf keiner Pflanzen-, Pflanzdurchlauf- oder Aufgabenseite eingebunden — sie erscheinen dort noch nirgends. Die folgenden zwei Abschnitte beschreiben den heutigen Stand im Präsens, die Abschnitte danach das geplante Verhalten im Futur.
Der KI-Assistent beantwortet Wissensfragen zur Pflanzenpflege auf Basis einer kuratierten Wissensbasis — klar als KI-generiert gekennzeichnet und mit Quellenangaben. An das Sprachmodell geht dabei nur der Text deiner Frage, keine Daten deiner Pflanzen.
Wissensfragen stellen¶
Öffne im Menü KI-Assistent. Trage deine Frage in das Textfeld ein — zum Beispiel „Was ist VPD und warum ist es wichtig?" — und klicke auf Frage stellen (oder sende mit Strg/Cmd + Enter). Die Antwort erscheint darunter, mit KI-Kennzeichnung und aufklappbaren Quellen.
Diese Wissensfragen sind rein sachbezogen — sie beziehen sich nicht auf deine konkreten Pflanzen, sondern auf allgemeines Pflanzenwissen aus der Wissensbasis.
- Im Light-Modus brauchst du dafür weder Anmeldung noch Einwilligung: Die Instanz arbeitet ohne Login als System-Nutzer, und es gibt dort keine Einwilligungsverwaltung.
- Im Voll-Modus stellst du die Frage in deinem Garten. Weil dein frei formulierter Text dabei — deinem Konto zugeordnet — an die Wissensbasis und ihr Sprachmodell geht, brauchst du die Einwilligung KI-Wissensfrage an die Wissensbasis (
ai_knowledge_question), außerdem die KI-Freischaltung deines Gartens und mindestens die Rolle Gärtner. Gibst du zur Frage selbst Pflanzenwerte an (Art, Phase, Substrat, EC, pH), ist zusätzlich die Einwilligung KI-Zugriff auf deine Pflanzendaten (ai_tenant_data_access) nötig.
Beispielfragen
- „Was ist VPD?"
- „Wie senke ich den pH-Wert der Nährlösung?"
- „Was bedeutet Karenzzeit?"
Einwilligung direkt auf der Seite: Fehlt dir im Voll-Modus die Einwilligung für Wissensfragen, erscheint nach dem Absenden direkt unter dem Textfeld ein Hinweis, was übertragen wird. Mit Einwilligen und Frage senden erteilst du sie, und deine Frage wird gleich gesendet. Mit Nicht jetzt bleibt alles, wie es war, und die Frage wird nicht beantwortet. Jede Frage im Voll-Modus zählt zu deinem Tageskontingent. Widerrufen kannst du die Einwilligung jederzeit unter Datenschutz im Tab Einwilligungen mit Widerrufen; der Widerruf gilt ab der nächsten Frage.
Kontextbewusster Chat¶
Im Voll-Modus (angemeldet) öffnet die Schaltfläche Chat öffnen oben auf der Seite ein Chat-Fenster. Deine Nachricht wird Wort für Wort gestreamt beantwortet; jede Antwort erscheint in derselben KI-Hülle wie die Wissensfragen. Ein Abbrechen-Button stoppt eine laufende Antwort.
Aktivierung durch eine Administratorin oder einen Administrator nötig
Der Chat nutzt — anders als die reine Wissensfrage — den Kontext deines Gartens (Mandant) und erfordert deshalb zwei Freischaltungen, bevor er tatsächlich antwortet: Der Betreiber der Instanz muss KI-Funktionen aktiviert haben, und dein Garten (Mandant) muss KI-Funktionen zusätzlich freigeschaltet haben. Ist eine der beiden Stufen aus, erscheint beim Öffnen des Chats die Meldung „Die KI-Funktionen sind für diesen Garten aktuell deaktiviert." Es gibt aktuell noch keine Klickstrecke, mit der eine Administratorin oder ein Administrator diese Garten-Freischaltung selbst vornehmen kann — siehe Für technische Nutzer / Self-Hoster.
Fehlt zusätzlich deine Einwilligung, dass der Assistent Stammwerte deiner Pflanzen als Kontext nutzen darf, erscheint stattdessen der Hinweis „Für diese KI-Funktion fehlt deine Einwilligung …". Wie du diese Einwilligung erteilst, steht unter Einwilligung erteilen.
So ist der KI-Assistent aufgebaut (Drei-Stufen-Freischaltung)¶
Eine KI-Funktion antwortet nur, wenn alle relevanten Stufen zustimmen:
| Stufe | Wer entscheidet | Betrifft |
|---|---|---|
| 1. Instanz-weit | Plattformbetreiber (Umgebungsvariable) | Alle KI-Funktionen der gesamten Instanz |
| 2. Garten (Mandant) | Administratorin/Administrator deines Gartens | Alle KI-Funktionen, die deinen Pflanzenkontext nutzen (Chat, künftig auch Tipp-Karten) |
| 3. Deine Einwilligung | Du selbst | Ob deine Pflanzendaten als Kontext gesendet werden dürfen, und ob ein Cloud-Provider statt eines lokalen Modells verwendet werden darf |
Reine Wissensfragen ohne Pflanzenbezug (siehe oben) benötigen im Light-Modus nur Stufe 1 und funktionieren dort ohne Login. Im Voll-Modus brauchen sie alle drei Stufen; Stufe 3 ist dort die eigene Einwilligung ai_knowledge_question.
Einwilligung erteilen¶
Drei Einwilligungen sind für den KI-Assistenten relevant:
| Einwilligung | Wofür nötig |
|---|---|
| KI-Wissensfrage an die Wissensbasis | Für Wissensfragen auf der Seite KI-Assistent im Voll-Modus. Du kannst sie direkt auf der Seite erteilen, wenn du die erste Frage stellst |
| KI-Zugriff auf deine Pflanzendaten | Für Chat, Tipp-Karten, Tipp des Tages und „Warum?"-Erklärungen — überall dort, wo die Antwort deinen konkreten Pflanzenkontext (Art, Phase, Substrat, EC-/pH-Werte) nutzt |
| KI-Verarbeitung über Cloud-Provider | Zusätzlich nur nötig, wenn deine Instanz einen Cloud-Provider (statt eines lokalen Modells) einsetzt |
Alle drei erscheinen im Bereich Datenschutz im Tab Einwilligungen. Eine erteilte Einwilligung widerrufst du dort mit Widerrufen. Erteilen lässt sich dort keine: Die Wissensfrage-Einwilligung erteilst du auf der Seite KI-Assistent, die beiden anderen bislang nur über die API. Details und den Wortlaut der Einwilligungstexte findest du in Datenschutz & DSGVO.
Transparenz: Woran du eine KI-Antwort erkennst¶
Jede Antwort des KI-Assistenten trägt sichtbare Kennzeichnungen:
- KI-Badge („KI-generiert") — erscheint über jeder Antwort, mit Modell- und Provider-Name im Tooltip.
- Quellen-Footer — aufklappbare Liste der zitierten Wissensbasis-Einträge mit Relevanz-Wert und Sprache. Bei der Erfahrungsstufe Experte ist er standardmäßig aufgeklappt, sonst zugeklappt.
- „Nutzt deine Pflanzendaten"-Indikator — erscheint nur, wenn die Antwort auf Basis deines Pflanzenkontexts erzeugt wurde. Ein Klick darauf führt zu den Datenschutz-Einstellungen.
- „Cloud-Verarbeitung"-Indikator — erscheint nur, wenn die Antwort über einen externen Cloud-Provider statt lokal verarbeitet wurde.
- „Allgemeine Information"-Hinweis — erscheint, wenn deine Pflanze eine selbst angelegte Art/Sorte ist, zu der die Wissensbasis keine spezifischen Informationen hat; die Antwort bezieht sich dann auf die nächstliegende bekannte Gattung oder Familie.
- Disclaimer — unterhalb jeder Antwort: „KI-Antworten können fehlerhaft sein. Bei kritischen Entscheidungen bitte die Quellen prüfen."
Cloud vs. lokal
Ob ein Cloud-Provider (z. B. Anthropic, OpenAI) oder ein lokal betriebenes Modell (Ollama) antwortet, legt der Plattformbetreiber fest. Lokale Provider senden keine Daten nach außen und benötigen keine gesonderte Einwilligung; Cloud-Provider erfordern zusätzlich deine Einwilligung zur „KI-Verarbeitung über Cloud-Provider" (siehe oben).
Datensparsamkeit¶
Der KI-Assistent sendet nie deinen Namen, deine E-Mail-Adresse oder Freitext aus deinem Pflanztagebuch an das Sprachmodell. An Kontext werden ausschließlich Stammwerte übermittelt: wissenschaftlicher Pflanzenname, aktuelle Phase, Substrat sowie numerische Messwerte (EC, pH). Diary-Einträge fließen — falls überhaupt — nur als anonymisierte Kennzahl ein (z. B. „zuletzt vor 5 Tagen gegossen"), nie als Originaltext. Jeder KI-Aufruf wird intern protokolliert, allerdings nur als Hash-Wert der Frage und deren Länge — nie im Klartext.
Geplante Funktionen im Überblick¶
Die folgenden Funktionen sind als Baustein bereits implementiert, aber noch nicht in eine Pflanzen-, Pflanzdurchlauf- oder Aufgabenseite eingebunden — sie sind also noch nirgends sichtbar. Diese Abschnitte beschreiben das geplante Verhalten im Futur.
Tipp-Karten¶
Tipp-Karten werden als kompakte Pflegehinweise auf der Detailseite einer Pflanze oder eines Pflanzdurchlaufs erscheinen. Das System wird den aktuellen Zustand analysieren und 2 bis 4 priorisierte Empfehlungen anzeigen (Titel, Erklärung, Empfehlung, Priorität) — bei der Erfahrungsstufe Anfänger maximal 2, kompakter und mit zugeklappten Quellen. Karten werden sich als erledigt oder nicht relevant markieren lassen.
Tipp des Tages¶
Beim ersten Öffnen des Dashboards an einem Tag wird ein einzelner, für dich relevanter Tipp erscheinen — etwa ein Warnhinweis zu einem auffälligen Messwert, ein Hinweis auf einen anstehenden Phasenwechsel oder ein allgemeiner Pflegetipp. Der Tipp lässt sich für den Rest des Tages wegklicken.
„Warum?"-Buttons¶
Auf Aufgabenkarten, Pflegeerinnerungen, Phasenwechsel-Vorschlägen und Düngeempfehlungen wird ein kleiner „Warum?"-Button erscheinen. Ein Klick öffnet ein Seitenpanel mit einer kurzen, KI-generierten Begründung auf Basis deiner aktuellen Pflanzendaten.
Erfahrungsstufen und KI-Funktionen (geplant)¶
Die verfügbaren KI-Funktionen sollen sich künftig an die eingestellte Erfahrungsstufe anpassen.
| Funktion | Beginner | Intermediate | Expert |
|---|---|---|---|
| Wissensfragen | Ja | Ja | Ja |
| Tipp-Karten (vereinfacht, max. 2) | Ja | Ja | Ja |
| Tipp des Tages | Ja | Ja | Ja |
| „Warum?"-Buttons | Ja | Ja | Ja |
| Chat-Funktion | — | Ja | Ja |
| Quellen standardmäßig aufgeklappt | — | — | Ja |
Schon heute passt sich die Quellen-Darstellung (auf-/zugeklappt) an deine Erfahrungsstufe an; die übrigen Einschränkungen dieser Tabelle sind noch nicht umgesetzt — insbesondere ist der Chat aktuell für alle Erfahrungsstufen sichtbar.
Für technische Nutzer / Self-Hoster¶
Der KI-Assistent wird über drei Ebenen freigeschaltet — Details und Umgebungsvariablen stehen unter Umgebungsvariablen — KI-Assistent.
Stufe 1 (Betreiber): AI_FEATURES_ENABLED=true am Backend. Ist die Variable nicht gesetzt, antworten sämtliche KI-Endpunkte mit HTTP 404 — die KI-API existiert für die Instanz dann faktisch nicht.
Stufe 2 (Mandant): Das Feld tenant.settings.ai_features_enabled steuert, ob KI-Funktionen für einen konkreten Garten (Mandanten) aktiv sind (Standard: false). Es gibt hierfür aktuell weder eine Oberfläche noch einen eigenen API-Endpunkt — das Feld lässt sich nur durch direkten Zugriff auf das Mandanten-Dokument in ArangoDB setzen. Ohne diesen Schritt bleiben alle mandantengebundenen KI-Funktionen (Chat, künftig Tipp-Karten) deaktiviert, selbst wenn Stufe 1 aktiv ist.
Stufe 3 (Einwilligung): POST /api/v1/privacy/consents mit purpose: ai_knowledge_question (Wissensfrage), purpose: ai_tenant_data_access (Pflanzendaten als Kontext) bzw. purpose: ai_cloud_processing (Cloud-Provider) (siehe Datenschutz & DSGVO).
Die Wissensfrage hat je Modus einen eigenen Endpunkt:
| Endpunkt | Modus | Zweck |
|---|---|---|
POST /api/v1/t/{tenant_slug}/ai/knowledge/ask | Voll-Modus | Freie Wissensfrage im Garten: ab Gärtner, Stufe 1 + 2, Einwilligung ai_knowledge_question (mit Pflanzenwerten im context zusätzlich ai_tenant_data_access), KI-Tagesbudget |
POST /api/v1/public/ai/ask | nur Light-Modus | Freie Wissensfrage ohne Pflanzenkontext als System-Nutzer (kein Login, IP-ratenbegrenzt); im Voll-Modus 404 |
GET /api/v1/public/ai/health | nur Light-Modus | Prüft, ob die Wissensbasis erreichbar ist; im Voll-Modus 404 |
Details zu allen KI-Endpunkten (inkl. Chat, Tipps, Erklärungen) stehen in der API-Referenz.
Tageskontingent für KI-Anfragen¶
Jede Anfrage, die ein Sprachmodell anspricht — eine Wissensfrage im Voll-Modus, Tipps oder den Tipp des Tages erzeugen, „Warum?“, eine Chat-Nachricht, eine Glossar-Erklärung erzeugen, eine KI-Diagnose —, zählt zu einem Tageskontingent. Es gibt drei Grenzen, alle pro Kalendertag (UTC):
- Dein Kontingent in einem Garten — standardmäßig 50 Anfragen. Bist du Mitglied in mehreren Gärten, hast du in jedem ein eigenes.
- Das Kontingent des Gartens — standardmäßig 500 Anfragen aller Mitglieder zusammen. Wer an seinem eigenen Kontingent abgewiesen wird, verbraucht das des Gartens nicht.
- Die Textmenge des Gartens — eine Obergrenze für die vom Sprachmodell verarbeiteten Tokens.
Ist eine Grenze erreicht, erklärt dir die Oberfläche, welche — ab Mitternacht (UTC) kannst du wieder fragen. Zusätzlich gilt pro Konto eine Grenze von 20 Anfragen pro Minute. Das Lesen bereits erzeugter Tipps und Erklärungen zählt nicht.
Für Betreiber
Die Grenzen sind über AI_BUDGET_USER_CALLS_PER_DAY, AI_BUDGET_TENANT_CALLS_PER_DAY und AI_BUDGET_TENANT_TOKENS_PER_DAY einstellbar (0 schaltet eine Grenze ab), die Minutengrenze über RATE_LIMIT_INFERENCE — siehe Umgebungsvariablen. Die Zähler liegen in Valkey; ist Valkey nicht erreichbar, läuft keine KI-Anfrage.
Verhalten ohne erreichbare Wissensbasis¶
Ist die zugrunde liegende Wissensbasis (Knowledge Service) nicht erreichbar, liefert der KI-Assistent statt eines Fehlers eine regelbasierte Antwort ohne Sprachmodell — die Anwendung bleibt nutzbar, die Qualität der Antwort ist dann aber geringer.
Die Wissensfrage auf der Seite KI-Assistent hat keine solche Ersatzantwort: Ist die Wissensbasis nicht erreichbar, zeigt die Seite den Hinweis, dass die Antwort nicht geladen werden konnte.
Häufige Fragen¶
Werden meine Pflanzdaten für das Training von KI-Modellen verwendet?
Nein. Kamerplanter sendet Daten ausschließlich zur Beantwortung deiner konkreten Anfrage. Eine Nutzung für Modell-Training hängt von den vertraglichen Bedingungen des vom Betreiber gewählten Providers ab — bei lokal betriebenen Modellen (Ollama) verlassen deine Daten dein Netzwerk grundsätzlich nie.
Warum antwortet der Chat mit „Die KI-Funktionen sind für diesen Garten aktuell deaktiviert"?
Stufe 1 (Betreiber) ist zwar aktiv, aber Stufe 2 (dein Garten/Mandant) noch nicht. Das lässt sich derzeit nur über einen direkten Eingriff des Betreibers beheben — siehe Für technische Nutzer / Self-Hoster.
Warum sehe ich beim Chat den Hinweis auf eine fehlende Einwilligung?
Der Chat nutzt deinen Pflanzenkontext und benötigt deshalb deine Einwilligung „KI-Zugriff auf deine Pflanzendaten". Wie du sie erteilst, steht unter Einwilligung erteilen.
Warum fragt mich die KI-Seite nach einer Einwilligung, obwohl ich nichts über meine Pflanzen frage?
Auch eine reine Wissensfrage geht als Text an ein Sprachmodell. Im Voll-Modus willigst du deshalb einmal in „KI-Wissensfrage an die Wissensbasis“ ein. Daten deiner Pflanzen gehen dabei nur mit, wenn du sie selbst zur Frage angibst.
Kann ich den KI-Assistenten vollständig lokal betreiben?
Das entscheidet der Plattformbetreiber bei der Konfiguration der Wissensbasis. Mit einem lokalen Modell (Ollama) verlassen keine Daten das eigene Netzwerk und es ist keine Einwilligung zur Cloud-Verarbeitung nötig. Details für Selbsthoster: KI-Provider einrichten.