Schnellstart

Starten Sie Ihren ersten KI-Agenten in nur 5 Minuten.

Voraussetzungen

• Ein API-Key von einem unterstützten LLM-Anbieter (OpenAI, Anthropic, Google, xAI oder ein lokales Modell)
• macOS, Linux oder Windows (WSL)

Installation

Skript (empfohlen):

curl -fsSL https://get.droid.plus | sh

Docker:

docker pull sinapticai/droid:latest

Binärdatei-Download:

Laden Sie die Binärdatei für Ihre Plattform von den GitHub Releases herunter.

Plattform	Architektur	Download
Linux	amd64	droid-linux-amd64
Linux	arm64	droid-linux-arm64
macOS	Apple Silicon	droid-darwin-arm64
macOS	Intel	droid-darwin-amd64
Windows	amd64	droid-windows-amd64.exe

Erstellen Sie Ihren ersten Agenten

Option A: KI-Builder UI (kein Code erforderlich)

Starten Sie Sinaptic® DROID+ und öffnen Sie den visuellen Builder:

droid up
# Öffnen Sie http://localhost:8081/builder/ in Ihrem Browser

Mit der KI-Builder UI können Sie Ihren Agenten visuell konfigurieren: Wählen Sie ein Modell, schreiben Sie einen System-Prompt, fügen Sie Tools hinzu und testen Sie alles live. Wenn Sie fertig sind, wird die YAML-Konfiguration automatisch für Sie erstellt.

Option B: YAML-Konfiguration

Initialisieren Sie ein neues Projekt:

droid init mein-agent
cd mein-agent

Dies erstellt ein Projektverzeichnis mit folgendem Inhalt:

mein-agent/
├── droid.yaml          # Laufzeitkonfiguration (Ports, LLM-Keys, Sicherheit)
├── configs/agents/
│   └── mein-agent.yaml # Ihre Agenten-Definition
├── .env.example        # API-Key-Vorlage
└── data/               # Laufzeitdaten (RAG, Logs)

Kopieren Sie .env.example nach .env und fügen Sie Ihren API-Key ein:

cp .env.example .env
# Bearbeiten Sie .env und fügen Sie Ihren OPENAI_API_KEY (oder den Key eines anderen Anbieters) hinzu

Starten Sie die Laufzeitumgebung:

droid up

Sie werden folgendes sehen:

 ____  ____   ___  ___ ____
|  _ \|  _ \ / _ \|_ _|  _ \  _
| | | | |_) | | | || || | | |(_)_
| |_| |  _ <| |_| || || |_| |  _|
|____/|_| \_\\___/|___|____/  (_)

Sinaptic.AI DROID+ v0.5.0
Agent runtime engine starting...
✓ Loaded 1 agent: mein-agent
✓ SinapticAI security: enabled (community mode)
✓ OpenAI-compatible API: http://localhost:8080/v1
✓ Management API: http://localhost:8081
✓ Agent Builder UI: http://localhost:8081/builder/

Sprechen Sie mit Ihrem Agenten

Sinaptic® DROID+ stellt eine OpenAI-kompatible API bereit, sodass Sie jedes OpenAI-SDK oder einfach curl verwenden können:

curl:

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mein-agent",
    "messages": [{"role": "user", "content": "Hallo!"}]
  }'

Python (OpenAI SDK):

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8080/v1", api_key="any")

response = client.chat.completions.create(
    model="mein-agent",
    messages=[{"role": "user", "content": "Hallo!"}]
)

print(response.choices[0].message.content)

Node.js (OpenAI SDK):

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'http://localhost:8080/v1',
  apiKey: 'any',
});

const response = await client.chat.completions.create({
  model: 'mein-agent',
  messages: [{ role: 'user', content: 'Hallo!' }],
});

console.log(response.choices[0].message.content);

Das Feld model entspricht dem Agentennamen in Ihrer YAML-Konfiguration. Der api_key kann für die lokale Entwicklung eine beliebige Zeichenfolge sein (außer Sie haben eine Authentifizierung in der droid.yaml konfiguriert).

Agenten-Konfiguration erklärt

Hier ist eine minimale Agenten-Konfiguration (configs/agents/mein-agent.yaml):

name: "mein-agent"
description: "Kundensupport-Assistent"

model:
  name: "gpt-4o-mini"       # Ein beliebiges Modell Ihres konfigurierten Anbieters
  max_tokens: 1024
  temperature: 0.7

personality: |
  Du bist ein hilfreicher Kundensupport-Assistent.
  Antworte präzise und genau. Sei immer höflich.

tools:
  - name: "current_time"
    type: "builtin"

sinaptic:
  enabled: true              # Sicherheitsprüfungen aktivieren

Wichtige Felder:

• name — eindeutige Kennung des Agenten, wird als model in API-Aufrufen verwendet.
• model.name — das zu verwendende LLM-Modell (z. B. gpt-4o-mini, claude-sonnet-4-20250514, gemini-2.0-flash).
• personality — System-Prompt, der das Verhalten des Agenten definiert.
• tools — integrierte Tools, REST-API-Endpunkte oder MCP-Server, die der Agent nutzen kann.
• sinaptic.enabled — SinapticAI-Sicherheit umschalten (Prompt-Injection-Erkennung, PII-Maskierung).

CLI-Befehle

droid up          # Startet die Laufzeitumgebung (lädt alle Agenten)
droid down        # Stoppt eine laufende Instanz ordnungsgemäß
droid init NAME   # Erstellt ein neues Agenten-Projekt
droid agents      # Listet geladene Agenten und deren Status auf
droid health      # Überprüft den Serverstatus
droid version     # Gibt Version, Commit und Build-Datum aus

Nächste Schritte

• LLM-Anbieter — Konfigurieren Sie OpenAI, Anthropic, Gemini, Grok oder lokale Modelle.
• MCP-Tools — Fügen Sie externe Tools über das Model Context Protocol hinzu.
• SinapticAI-Sicherheit — Verstehen Sie die integrierte Sicherheitsebene.
• Docker-Bereitstellung — Führen Sie Sinaptic® DROID+ produktiv mit Docker aus.
• Editionen — Vergleichen Sie die Funktionen von Community, Pro und Enterprise.