53 lines
2.4 KiB
Markdown
53 lines
2.4 KiB
Markdown
# 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.
|