Ga naar hoofdinhoud

FAQ

Algemeen​

Wat is Sinaptic® DROID+?​

Sinaptic® DROID+ is een headless AI agent runtime engine. Zoals nginx websites serveert, serveert Sinaptic® DROID+ AI agents. Je definieert agents in YAML-configuraties, en Sinaptic® DROID+ stelt deze beschikbaar als een OpenAI-compatibele API. Eén binary, elke LLM-provider, ingebouwde beveiliging.

Is Sinaptic® DROID+ open source?​

Sinaptic® DROID+ Community Edition is bron-beschikbaar onder de Business Source License 1.1 (BSL 1.1). Het is gratis te gebruiken voor interne doeleinden met maximaal 2 agents. De licentie wordt na de wijzigingsdatum omgezet naar Apache 2.0. Pro en Enterprise edities zijn commercieel gelicenseerd.

Wat is het verschil tussen Community, Pro en Enterprise?​

Zie de Edities vergelijking voor een volledige functiematrix. In het kort: Community is gratis met maximaal 2 agents en op RegExp gebaseerde beveiliging. Pro verwijdert agentlimieten en voegt de volledige SinapticAI-beveiligingscascade toe. Enterprise voegt multi-tenancy, compliance-functies en SLA-ondersteuning toe.

Moet ik betalen voor Community Edition?​

Nee. Community Edition is voor altijd gratis voor intern gebruik met maximaal 2 agents. Geen registratie, geen telemetrie, geen gebruikslimieten op API-oproepen.

Installatie & configuratie​

Wat zijn de systeemeisen?​

Sinaptic® DROID+ is een enkele Go binary zonder externe afhankelijkheden. Het draait op Linux (amd64/arm64), macOS (Intel/Apple Silicon) en Windows. Geheugengebruik hangt af van je werklast, maar 128MB is voldoende voor basisopstellingen.

Kan ik Sinaptic® DROID+ draaien zonder Docker?​

Ja. Sinaptic® DROID+ is een op zichzelf staande binary. Download deze van de GitHub Releases, maak deze uitvoerbaar en draai droid up. Docker is optioneel.

Hoe update ik Sinaptic® DROID+?​

Voor binary-installaties: download de nieuwe versie en vervang de binary. Voor Docker: docker pull sinapticai/droid:latest && docker compose up -d. Je configuratiebestanden en data staan los van de binary, dus updates zijn niet destructief.

LLM-providers​

Welke LLM-providers worden ondersteund?​

Alle 7 providers zijn beschikbaar in elke editie: OpenAI, Anthropic (Claude), Google Gemini, xAI Grok, Ollama, LM Studio en llama.cpp. Cloudproviders vereisen API-sleutels. Lokale providers (Ollama, LM Studio, llama.cpp) vereisen geen sleutels.

Kan ik verschillende modellen gebruiken voor verschillende agents?​

Ja. Elke agent specificeert zijn eigen model.provider en model.name. Je kunt één agent draaien op GPT-4o, een andere op Claude Sonnet, en een derde op een lokaal Ollama-model — allemaal vanuit dezelfde Sinaptic® DROID+ instantie.

Kan ik Sinaptic® DROID+ gebruiken met mijn eigen fine-tuned modellen?​

Ja. Als je fine-tuned model wordt geserveerd via een OpenAI-compatibele API (wat de meeste providers ondersteunen), kan Sinaptic® DROID+ het gebruiken. Stel gewoon de juiste base_url en modelnaam in.

Stuurt Sinaptic® DROID+ mijn data ergens heen?​

Sinaptic® DROID+ stuurt je prompts alleen naar de LLM-provider die je configureert. Er is geen telemetrie, geen analyse en geen gegevensverzameling door Sinaptic® DROID+ zelf. Bij gebruik van lokale modellen (Ollama, LM Studio, llama.cpp) blijft alles op je eigen machine.

Beveiliging​

Wat is SinapticAI?​

SinapticAI is een AI intent firewall ingebed in Sinaptic® DROID+. Het inspecteert prompts en antwoorden in real-time om prompt-injectieaanvallen, jailbreak-pogingen en PII-lekken te detecteren en te blokkeren. Zie het SinapticAI overzicht voor details.

Welke aanvallen detecteert de Community Edition?​

De Community Edition bevat de RegExp-beveiligingslaag, die ongeveer 70% van de bekende aanvalsvectoren opvangt: veelvoorkomende prompt-injectiepatronen, bekende jailbreak-sjablonen, pogingen tot extractie van systeemprompts en PII-patronen (e-mails, telefoonnummers, creditcards).

Kan ik SinapticAI uitschakelen voor specifieke agents?​

Ja. Stel sinaptic.enabled: false in de YAML-configuratie van de agent in. De globale instelling in droid.yaml bepaalt de standaardwaarde.

Worden mijn gegevens lokaal verwerkt voor beveiligingscontroles?​

Ja. Alle SinapticAI-controles worden lokaal uitgevoerd binnen je Sinaptic® DROID+ instantie. Er worden geen gegevens naar externe diensten gestuurd voor beveiligingsanalyse.

API & integratie​

Is de API echt OpenAI-compatibel?​

Ja. Sinaptic® DROID+ implementeert het /v1/chat/completions endpoint met hetzelfde verzoek/antwoord-formaat als de API van OpenAI. Je kunt de officiële OpenAI SDK in elke taal gebruiken — verander gewoon de base_url naar je Sinaptic® DROID+ instantie.

Hoe authenticeer ik API-verzoeken?​

Standaard is geen authenticatie vereist (lokale ontwikkelmodus). Configureer voor productie een API-sleutel in droid.yaml:

server:
  api_key: "jouw-geheime-sleutel"

Geef deze vervolgens door in verzoeken via de Authorization: Bearer jouw-geheime-sleutel header, net als bij OpenAI.

Kan ik Sinaptic® DROID+ gebruiken als een drop-in vervanging voor OpenAI?​

Ja. Stel base_url in op je Sinaptic® DROID+ instantie en gebruik een willekeurige agentnaam als de model parameter. Het antwoordformaat is identiek aan dat van OpenAI.

Agents​

Wat is de agentlimiet in Community Edition?​

Community Edition ondersteunt maximaal 2 agents. Als je er meer nodig hebt, upgrade dan naar Pro (onbeperkt aantal agents). De limiet geldt voor gelijktijdig geladen agents, niet voor het totale aantal configuraties.

Kan ik agents hot-reloaden zonder te herstarten?​

Ja. Sinaptic® DROID+ houdt de agents-map in de gaten voor wijzigingen. Wanneer je de YAML-configuratie van een agent wijzigt, wordt deze automatisch opnieuw geladen zonder de server te herstarten of actieve verbindingen te verbreken.

Welke tools kunnen agents gebruiken?​

Agents kunnen ingebouwde tools gebruiken (current_time, enz.), REST API tools (roep elk HTTP-endpoint aan) en MCP-tools (Model Context Protocol voor uitbreidbare integraties zoals zoeken op het web, bestandstoegang, databases). Zie de MCP-gids.

Implementatie​

Welke poorten gebruikt Sinaptic® DROID+?​

Poort 8080 voor de OpenAI-compatibele API en poort 8081 voor de Management API en Agent Builder UI. Beide zijn configureerbaar in droid.yaml.

Moet ik de Management API publiekelijk blootstellen?​

Nee. Poort 8081 biedt admin-functionaliteit en de Agent Builder UI. Houd deze op een intern netwerk of achter authenticatie in productie.

Kan ik meerdere Sinaptic® DROID+ instanties draaien?​

Ja. Elke instantie is stateless (behalve de configuratiebestanden en datamap). Je kunt meerdere instanties draaien achter een load balancer. Voor gecoördineerde implementaties met meerdere instanties biedt de Enterprise editie clustering en HA-functies.

Probleemoplossing​

Sinaptic® DROID+ start op maar agents worden niet geladen​

Controleer of je agent YAML-bestanden in de map staan die is opgegeven door agents_dir in droid.yaml (standaard: ./configs/agents/). Draai droid agents om geladen agents te zien.

"Connection refused" bij het aanroepen van de API​

Zorg ervoor dat Sinaptic® DROID+ draait (droid health) en dat je de juiste poort gebruikt (standaard 8080). Bij gebruik van Docker, zorg ervoor dat de poorten correct zijn gemapt.

LLM-oproepen mislukken met authenticatiefouten​

Controleer of je API-sleutel correct is ingesteld. Controleer dit met echo $OPENAI_API_KEY (of de relevante variabele). De configuratie ondersteunt ${VAR} syntaxis — zorg ervoor dat de omgevingsvariabele beschikbaar is voor het Sinaptic® DROID+ proces.