# 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

1. N8N öffnen → **Workflows → Import from File** → `assist-workflow.json` aus diesem Ordner.
2. 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 |

3. 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):

```bash
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.