Zum Hauptinhalt springen

FAQ

Allgemeines​

Was ist Sinaptic® DROID+?​

Sinaptic® DROID+ ist eine Headless-KI-Agenten-Laufzeitumgebung. So wie nginx Websites bereitstellt, stellt Sinaptic® DROID+ KI-Agenten bereit. Sie definieren Agenten in YAML-Konfigurationen, und Sinaptic® DROID+ stellt sie als OpenAI-kompatible API zur Verfügung. Eine Binärdatei, jeder LLM-Anbieter, integrierte Sicherheit.

Ist Sinaptic® DROID+ Open Source?​

Die Sinaptic® DROID+ Community Edition ist unter der Business Source License 1.1 (BSL 1.1) verfügbar. Sie ist für interne Zwecke mit bis zu 2 Agenten kostenlos nutzbar. Die Lizenz wird nach dem Änderungsdatum in Apache 2.0 umgewandelt. Die Pro- und Enterprise-Editionen sind kommerziell lizenziert.

Was ist der Unterschied zwischen Community, Pro und Enterprise?​

Siehe den Editionen-Vergleich für eine vollständige Funktionsmatrix. Kurz gesagt: Community ist kostenlos mit bis zu 2 Agenten und RegExp-basierter Sicherheit. Pro hebt die Agenten-Limits auf und fügt die vollständige SinapticAI-Sicherheitskaskade hinzu. Enterprise fügt Multi-Tenancy, Compliance-Funktionen und SLA-Support hinzu.

Muss ich für die Community Edition bezahlen?​

Nein. Die Community Edition ist für die interne Nutzung mit bis zu 2 Agenten dauerhaft kostenlos. Keine Registrierung, keine Telemetrie, keine Nutzungsbeschränkungen für API-Aufrufe.

Installation & Einrichtung​

Was sind die Systemanforderungen?​

Sinaptic® DROID+ ist eine einzelne Go-Binärdatei ohne externe Abhängigkeiten. Sie läuft unter Linux (amd64/arm64), macOS (Intel/Apple Silicon) und Windows. Die Speichernutzung hängt von Ihrer Arbeitslast ab, aber 128 MB reichen für Basis-Setups aus.

Kann ich Sinaptic® DROID+ ohne Docker betreiben?​

Ja. Sinaptic® DROID+ ist eine eigenständige Binärdatei. Laden Sie sie von den GitHub Releases herunter, machen Sie sie ausführbar und führen Sie droid up aus. Docker ist optional.

Wie aktualisiere ich Sinaptic® DROID+?​

Bei Binärinstallationen laden Sie die neue Version herunter und ersetzen die Binärdatei. Bei Docker führen Sie docker pull sinapticai/droid:latest && docker compose up -d aus. Ihre Konfigurationsdateien und Daten sind von der Binärdatei getrennt, sodass Updates zerstörungsfrei sind.

LLM-Anbieter​

Welche LLM-Anbieter werden unterstützt?​

Alle 7 Anbieter sind in jeder Edition verfügbar: OpenAI, Anthropic (Claude), Google Gemini, xAI Grok, Ollama, LM Studio und llama.cpp. Cloud-Anbieter erfordern API-Keys. Lokale Anbieter (Ollama, LM Studio, llama.cpp) erfordern keine Keys.

Kann ich verschiedene Modelle für verschiedene Agenten verwenden?​

Ja. Jeder Agent spezifiziert seinen eigenen model.provider und model.name. Sie können einen Agenten auf GPT-4o, einen anderen auf Claude Sonnet und einen dritten auf einem lokalen Ollama-Modell laufen lassen – alle in derselben Sinaptic® DROID+-Instanz.

Kann ich Sinaptic® DROID+ mit meinen eigenen fein abgestimmten (fine-tuned) Modellen verwenden?​

Ja. Wenn Ihr fein abgestimmtes Modell über eine OpenAI-kompatible API bereitgestellt wird (was die meisten Anbieter unterstützen), kann Sinaptic® DROID+ es verwenden. Setzen Sie einfach die korrekte base_url und den Modellnamen.

Sendet Sinaptic® DROID+ meine Daten irgendwohin?​

Sinaptic® DROID+ sendet Ihre Prompts nur an den von Ihnen konfigurierten LLM-Anbieter. Es gibt keine Telemetrie, keine Analysen und keine Datenerfassung durch Sinaptic® DROID+ selbst. Wenn Sie lokale Modelle verwenden (Ollama, LM Studio, llama.cpp), bleibt alles auf Ihrem Rechner.

Sicherheit​

Was ist SinapticAI?​

SinapticAI ist eine in Sinaptic® DROID+ eingebettete KI-Intent-Firewall. Sie prüft Prompts und Antworten in Echtzeit, um Prompt-Injection-Angriffe, Jailbreak-Versuche und PII-Leaks (personenbezogene Daten) zu erkennen und zu blockieren. Siehe die SinapticAI-Übersicht für Details.

Welche Angriffe erkennt die Community Edition?​

Die Community Edition enthält die RegExp-Sicherheitsebene, die etwa 70 % der bekannten Angriffsvektoren abdeckt: gängige Prompt-Injection-Muster, bekannte Jailbreak-Templates, Versuche zur Extraktion des System-Prompts und PII-Muster (E-Mails, Telefonnummern, Kreditkarten).

Kann ich SinapticAI für bestimmte Agenten deaktivieren?​

Ja. Setzen Sie sinaptic.enabled: false in der YAML-Konfiguration des Agenten. Die globale Einstellung in droid.yaml steuert den Standardwert.

Werden meine Daten lokal für Sicherheitsprüfungen verarbeitet?​

Ja. Alle SinapticAI-Prüfungen laufen lokal innerhalb Ihrer Sinaptic® DROID+-Instanz. Es werden keine Daten zur Sicherheitsanalyse an externe Dienste gesendet.

API & Integration​

Ist die API wirklich OpenAI-kompatibel?​

Ja. Sinaptic® DROID+ implementiert den Endpunkt /v1/chat/completions mit demselben Anfrage-/Antwortformat wie die API von OpenAI. Sie können das offizielle OpenAI SDK in jeder Sprache verwenden – ändern Sie einfach die base_url auf Ihre Sinaptic® DROID+-Instanz.

Wie authentifiziere ich API-Anfragen?​

Standardmäßig ist keine Authentifizierung erforderlich (lokaler Entwicklungsmodus). Konfigurieren Sie für die Produktion einen API-Key in droid.yaml:

server:
  api_key: "ihr-geheimer-key"

Übergeben Sie diesen dann in Anfragen über den Header Authorization: Bearer ihr-geheimer-key, genau wie bei OpenAI.

Kann ich Sinaptic® DROID+ als direkten Ersatz für OpenAI verwenden?​

Ja. Setzen Sie die base_url auf Ihre Sinaptic® DROID+-Instanz und verwenden Sie einen beliebigen Agentennamen als model-Parameter. Das Antwortformat ist identisch mit dem von OpenAI.

Agenten​

Was ist das Agenten-Limit in der Community Edition?​

Die Community Edition unterstützt bis zu 2 Agenten. Wenn Sie mehr benötigen, führen Sie ein Upgrade auf Pro durch (unbegrenzte Agenten). Das Limit bezieht sich auf gleichzeitig geladene Agenten, nicht auf die Gesamtzahl der Konfigurationen.

Kann ich Agenten ohne Neustart im laufenden Betrieb neu laden?​

Ja. Sinaptic® DROID+ überwacht das Agentenverzeichnis auf Änderungen. Wenn Sie die YAML-Konfiguration eines Agenten ändern, wird dieser automatisch neu geladen, ohne den Server neu zu starten oder aktive Verbindungen zu trennen.

Welche Tools können Agenten verwenden?​

Agenten können integrierte Tools (current_time usw.), REST-API-Tools (Aufruf beliebiger HTTP-Endpunkte) und MCP-Tools verwenden (Model Context Protocol für erweiterbare Integrationen wie Websuche, Dateizugriff, Datenbanken). Siehe den MCP-Leitfaden.

Bereitstellung​

Welche Ports verwendet Sinaptic® DROID+?​

Port 8080 für die OpenAI-kompatible API und Port 8081 für die Management-API und die Agent-Builder-UI. Beide sind in droid.yaml konfigurierbar.

Sollte ich die Management-API öffentlich zugänglich machen?​

Nein. Port 8081 bietet Admin-Funktionalität und die Agent-Builder-UI. Belassen Sie ihn im internen Netzwerk oder sichern Sie ihn in der Produktion durch Authentifizierung ab.

Kann ich mehrere Sinaptic® DROID+-Instanzen betreiben?​

Ja. Jede Instanz ist zustandslos (abgesehen von ihren Konfigurationsdateien und dem Datenverzeichnis). Sie können mehrere Instanzen hinter einem Load Balancer betreiben. Für koordinierte Multi-Instanz-Bereitstellungen bietet die Enterprise-Edition Clustering- und HA-Funktionen (Hochverfügbarkeit).

Fehlerbehebung​

Sinaptic® DROID+ startet, aber Agenten werden nicht geladen​

Überprüfen Sie, ob sich Ihre Agent-YAML-Dateien in dem Verzeichnis befinden, das in droid.yaml unter agents_dir angegeben ist (Standard: ./configs/agents/). Führen Sie droid agents aus, um geladene Agenten zu sehen.

"Connection refused" beim Aufruf der API​

Stellen Sie sicher, dass Sinaptic® DROID+ läuft (droid health) und Sie den richtigen Port verwenden (Standard 8080). Wenn Sie Docker verwenden, stellen Sie sicher, dass die Ports korrekt gemappt sind.

LLM-Aufrufe schlagen mit Authentifizierungsfehlern fehl​

Überprüfen Sie, ob Ihr API-Key korrekt gesetzt ist. Prüfen Sie dies mit echo $OPENAI_API_KEY (oder der entsprechenden Variable). Die Konfiguration unterstützt die ${VAR}-Syntax – stellen Sie sicher, dass die Umgebungsvariable für den Sinaptic® DROID+-Prozess verfügbar ist.