> ## Documentation Index
> Fetch the complete documentation index at: https://docs.varios-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n-Node installieren
> Die VARIOS AI n8n-Node in n8n installieren, Zugangsdaten einrichten und als Sprachmodell in Workflows nutzen
Die VARIOS AI n8n-Node stellt die Chat-Modelle und Assistenten Ihrer VARIOS-AI-Installation in [n8n](https://n8n.io) als Sprachmodell bereit. Sie verbindet sich über den OpenAI-kompatiblen Endpunkt Ihrer Instanz und liefert am Ausgang **Model** ein Sprachmodell, das Sie an einen AI Agent oder eine Chain anschließen. So laufen Automatisierungen in n8n über die in VARIOS AI freigegebenen Modelle, mit den dort konfigurierten Budgets und DLP-Regeln.
Das Paket ist als Community-Node unter [`@varios-ai/n8n-nodes-varios-ai`](https://www.npmjs.com/package/@varios-ai/n8n-nodes-varios-ai) veröffentlicht, der Quellcode liegt unter [github.com/varios-ai/n8n](https://github.com/varios-ai/n8n) (MIT).
## Voraussetzungen
* Eine aktuelle n8n-Installation. Die Node setzt eine Mindestversion voraus und lässt sich in älteren n8n-Versionen nicht installieren; die jeweils geforderte Version steht in der [Paketbeschreibung auf npm](https://www.npmjs.com/package/@varios-ai/n8n-nodes-varios-ai).
* Rechte, in n8n Community-Nodes zu installieren. In n8n Cloud ist die Installation eigener Community-Nodes eingeschränkt, nutzen Sie dort eine selbst betriebene Instanz.
* Einen [API-Key](/de/extended-support/admin/apikeys) aus VARIOS AI, dem die gewünschten Chat-Modelle bzw. Assistenten zugewiesen sind.
* Die VARIOS-AI-Instanz muss vom n8n-Server aus über HTTPS erreichbar sein.
Jeder API-Key benötigt eine eigene Lizenz. Planen Sie die Lizenz für die n8n-Anbindung mit ein.
## Installation
Öffnen Sie in n8n **Settings → Community nodes → Install** und tragen Sie den Paketnamen ein:
```text theme={null}
@varios-ai/n8n-nodes-varios-ai
```
Bestätigen Sie die Nutzungsbedingungen für Community-Nodes und schließen Sie die Installation ab. Nach der Installation steht die Node **VARIOS AI** in der Node-Suche unter **AI → Language Models** zur Verfügung.
Legen Sie unter Administration → [API-Keys](/de/extended-support/admin/apikeys) einen Key für n8n an, etwa mit dem Namen „n8n“. Weisen Sie dem Key die Chat-Modelle zu, die in n8n nutzbar sein sollen, und setzen Sie ein Kostenlimit. Kopieren Sie den Key sofort, er wird nur einmal angezeigt.
Erstellen Sie in n8n Zugangsdaten des Typs **VARIOS AI API** mit diesen beiden Werten:
| Feld | Wert |
| -------- | --------------------------------- |
| Base URL | `https:///api/v1` |
| API Key | Der in VARIOS AI erzeugte API-Key |
Ersetzen Sie `` durch die Domain Ihrer Installation, also den Wert von `PROJECT_DOMAIN` aus der `.env`; der Pfad `/api/v1` bleibt unverändert. Beispiel für die Domain `ki.example.com`: `https://ki.example.com/api/v1`.
Mit **Test** prüft n8n die Zugangsdaten gegen `/models`. Der Key wird bei jeder Anfrage als Bearer-Token im Header `Authorization` übergeben.
Fügen Sie die Node **VARIOS AI** hinzu und wählen Sie die Zugangsdaten aus. Unter **Model** wählen Sie entweder **From List** – n8n lädt dann die diesem Key zugewiesenen Modelle – oder tragen über **Name** eine ID manuell ein. Optional hinterlegen Sie unter **System Prompt** eine Systemnachricht, die jeder Unterhaltung vorangestellt wird.
Verbinden Sie anschließend den Ausgang **Model** mit einem **AI Agent** oder einer anderen Node, die ein Sprachmodell erwartet. Die Node hat selbst keinen Dateneingang.
Als ID akzeptiert die API die **Chat-Modell-ID** eines vorkonfigurierten Modells oder die **Assistenten-ID**. Nutzbar sind nur Assistenten und Modelle, die dem verwendeten API-Key zugewiesen sind, siehe [API-Keys](/de/extended-support/admin/apikeys).
## Optionen der Node
Unter **Options** ergänzen Sie bei Bedarf einzelne Parameter. Ohne Eintrag gelten die Standardwerte.
| Option | Standard | Bedeutung |
| ----------------- | -------- | --------------------------------------------------------------------- |
| Temperature | `0.7` | Streuung der Antworten, `0` ist deterministisch, `2` sehr zufällig |
| Top P | `1` | Nucleus Sampling, Wahrscheinlichkeitsmasse der berücksichtigten Token |
| Maximum Tokens | `2048` | Obergrenze der erzeugten Token |
| Frequency Penalty | `0` | Abschlag für häufig wiederholte Token, `-2` bis `2` |
| Presence Penalty | `0` | Abschlag für bereits verwendete Token, `-2` bis `2` |
| Streaming | aktiv | Antwort Token für Token ausgeben |
| Timeout (Ms) | `60000` | Zeitlimit einer Anfrage in Millisekunden |
| Max Retries | `2` | Wiederholungen bei fehlgeschlagener Anfrage |
## Fehlersuche
| Symptom | Prüfen |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Test der Zugangsdaten schlägt fehl | Base URL endet auf `/api/v1`, Instanz vom n8n-Server aus erreichbar, gültiges HTTPS-Zertifikat |
| 401 oder 403 bei jeder Anfrage | API-Key gültig und nicht gelöscht, Key vollständig kopiert |
| Modellliste bleibt leer | Dem API-Key sind Chat-Modelle zugewiesen, die die Chat-Completions-API unterstützen |
| Ein Modell fehlt in der Liste | Modell in den [Modelleinstellungen](/de/extended-support/admin/modelle) mit Chat-Completions-Unterstützung konfiguriert und dem Key zugewiesen |
| Anfragen werden abgewiesen, obwohl der Key stimmt | Monatliches Kostenlimit des Keys erreicht, siehe [API-Keys](/de/extended-support/admin/apikeys) |
| Antworten brechen bei langen Aufgaben ab | `Timeout (Ms)` und `Maximum Tokens` erhöhen |
| Node erscheint nicht in der Node-Suche | n8n-Version erfüllt die Mindestanforderung der Paketbeschreibung, Installation der Community-Node erfolgreich, n8n neu gestartet |