Ga naar hoofdinhoud

Snelstart

Laat uw eerste AI-agent binnen 5 minuten draaien.

Voorvereisten​

  • Een API-sleutel van een ondersteunde LLM-provider (OpenAI, Anthropic, Google, xAI of een lokaal model)
  • macOS, Linux of Windows (WSL)

Installatie​

Script (aanbevolen):

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

Docker:

docker pull sinapticai/droid:latest

Binary download:

Download de binary voor uw platform via GitHub Releases.

PlatformArchitectuurDownload
Linuxamd64droid-linux-amd64
Linuxarm64droid-linux-arm64
macOSApple Silicondroid-darwin-arm64
macOSInteldroid-darwin-amd64
Windowsamd64droid-windows-amd64.exe

Maak uw eerste agent​

Optie A: AI Builder UI (geen code)​

Start Sinaptic® DROID+ en open de visuele builder:

droid up
# Open http://localhost:8081/builder/ in uw browser

Met de AI Builder UI kunt u uw agent visueel configureren — kies een model, schrijf een systeem-prompt, voeg tools toe en test het live. Als u klaar bent, genereert het de YAML-configuratie voor u.

Optie B: YAML-configuratie​

Initialiseer een nieuw project:

droid init mijn-agent
cd mijn-agent

Dit maakt een projectmap aan met:

mijn-agent/
├── droid.yaml          # Runtime-configuratie (poorten, LLM-sleutels, beveiliging)
├── configs/agents/
│   └── mijn-agent.yaml # Uw agent-definitie
├── .env.example        # API-sleutel sjabloon
└── data/               # Runtime-gegevens (RAG, logs)

Bewerk .env.example → .env met uw API-sleutel:

cp .env.example .env
# Bewerk .env en voeg uw OPENAI_API_KEY (of een andere provider-sleutel) toe

Start de runtime:

droid up

U ziet het volgende:

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

Sinaptic.AI DROID+ v0.5.0
Agent runtime engine starting...
✓ Loaded 1 agent: mijn-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/

Praat met uw agent​

Sinaptic® DROID+ biedt een OpenAI-compatibele API, dus u kunt elke OpenAI SDK gebruiken of gewoon curl:

curl:

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mijn-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="mijn-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: 'mijn-agent',
  messages: [{ role: 'user', content: 'Hallo!' }],
});

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

Het veld model komt overeen met de agentnaam in uw YAML-configuratie. De api_key kan elke willekeurige tekenreeks zijn voor lokale ontwikkeling (tenzij u authenticatie hebt geconfigureerd in droid.yaml).

Agent-configuratie uitgelegd​

Hier is een minimale agent-configuratie (configs/agents/mijn-agent.yaml):

name: "mijn-agent"
description: "Klantenservice-assistent"

model:
  name: "gpt-4o-mini"       # Elk model van uw geconfigureerde provider
  max_tokens: 1024
  temperature: 0.7

personality: |
  U bent een behulpzame klantenservice-assistent.
  Wees beknopt en nauwkeurig. Wees altijd beleefd.

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

sinaptic:
  enabled: true              # Schakel beveiligingscontroles in

Belangrijkste velden:

  • name — unieke agent-identificatie, gebruikt als model in API-aanroepen.
  • model.name — het te gebruiken LLM-model (bijv. gpt-4o-mini, claude-sonnet-4-20250514, gemini-2.0-flash).
  • personality — systeem-prompt die het gedrag van de agent definieert.
  • tools — ingebouwde tools, REST API-eindpunten of MCP-servers die de agent kan gebruiken.
  • sinaptic.enabled — SinapticAI-beveiliging aan/uitzetten (prompt-injectie detectie, PII-maskering).

CLI-commando's​

droid up          # Start de runtime (laadt alle agents)
droid down        # Stop een draaiende instantie op een nette manier
droid init NAAM   # Maak een nieuw agent-project aan
droid agents      # Toon geladen agents en hun status
droid health      # Controleer de status van de server
droid version     # Toon versie, commit en build-datum

Volgende stappen​