KI-Assistent (v1.37) – Einrichtung N8N + Kimi

Der Assistent läuft so: Portal-Chat → N8N-Webhook → Kimi (Moonshot API) mit 6 Portal-Tools → Antwort zurück ins Portal.

1. Voraussetzungen

N8N läuft auf dem VPS (Container n8n).
Kimi-API-Key von https://platform.moonshot.ai (Aufladung ab ~5 $; Verbrauch des Assistenten liegt typisch unter 5 €/Monat bei 20 Fragen/Tag, Modell kimi-k2.6: ~0,4 US-Cent pro Frage).

2. N8N-Workflow importieren

N8N öffnen → Workflows → Import from File → assist-workflow.json aus diesem Ordner.
Nach dem Import drei Platzhalter anpassen:

Wo	Was
Webhook-Node → Credentials	Header Auth anlegen: Name `x-assist-secret`, Wert = `ASSIST_SHARED_SECRET`
Kimi-Node → Credentials	OpenAI API-Credential anlegen: API Key = Moonshot-Key, Base URL `https://api.moonshot.ai/v1`
Alle 6 Tool-Nodes	Im Header `x-assist-key` den Wert `ASSIST_API_KEY` durch das echte Geheimnis ersetzen

Workflow aktivieren (Toggle oben rechts). Die Webhook-URL steht dann im Webhook-Node, z. B. https://n8n.hocks.eu/webhook/mp-assist – sie wird in Schritt 3 gebraucht.

3. Portal-Env auf dem Server ergänzen

In /opt/mieterportal/portal.env (Datei auf dem VPS):

N8N_ASSIST_WEBHOOK=https://n8n.hocks.eu/webhook/mp-assist
ASSIST_SHARED_SECRET=<langes-zufaelliges-geheimnis-1>
ASSIST_API_KEY=<langes-zufaelliges-geheimnis-2>

Danach: cd /opt/mieterportal && docker compose up -d (nimmt die neuen Env-Variablen mit).

4. Test

Im Portal als Verwaltung: KI-Assistent in der Navigation → „Welche Wohnungen stehen leer?“ Der erste Aufruf dauert ggf. 10–30 s (Agent lädt Tools).

Fehlerbilder

Fehlermeldung im Chat	Ursache
„noch nicht konfiguriert (N8N_ASSIST_WEBHOOK fehlt)"	Env-Variable fehlt / Container nicht neu gestartet
„Assistent antwortet nicht (N8N Status …)"	Webhook-URL falsch, Workflow nicht aktiv, oder Header-Secret passt nicht
„Assistent hat keine Antwort geliefert"	N8N liefert kein JSON `{ "antwort": "…" }` – Respond-Node prüfen
„braucht zu lange"	Kimi-Timeout > 90 s – Modell/Credential prüfen

Datenschutz-Hinweis

Das Tool mieter_kontakt liefert personenbezogene Daten an Kimi (Serverstandort Singapur, Training laut Anbieter-AGB möglich). Wer das vermeiden will, entfernt das Tool einfach aus dem AI-Agenten – alle anderen Tools liefern nur Bestands- und Zahlen-Daten.

2.4 KiB Raw Blame History Unescape Escape