Szybki start

Uruchom swojego pierwszego agenta AI w 5 minut.

Wymagania wstępne

• Klucz API od dowolnego wspieranego dostawcy LLM (OpenAI, Anthropic, Google, xAI lub model lokalny).
• macOS, Linux lub Windows (WSL).

Instalacja

Skrypt (zalecane):

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

Docker:

docker pull sinapticai/droid:latest

Pobieranie pliku binarnego:

Pobierz plik binarny dla swojej platformy ze strony GitHub Releases.

Platforma	Architektura	Pobierz
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

Stwórz swojego pierwszego agenta

Opcja A: Kreator AI (bez kodu)

Uruchom Sinaptic® DROID+ i otwórz kreator wizualny:

droid up
# Otwórz http://localhost:8081/builder/ w przeglądarce

Kreator AI pozwala skonfigurować agenta wizualnie — wybierz model, napisz prompt systemowy, dodaj narzędzia i przetestuj go na żywo. Po zakończeniu kreator wygeneruje dla Ciebie konfigurację YAML.

Opcja B: Konfiguracja YAML

Zainicjuj nowy projekt:

droid init my-agent
cd my-agent

To spowoduje utworzenie katalogu projektu o następującej strukturze:

my-agent/
├── droid.yaml          # Konfiguracja środowiska uruchomieniowego (porty, klucze LLM, bezpieczeństwo)
├── configs/agents/
│   └── my-agent.yaml   # Definicja Twojego agenta
├── .env.example        # Szablon kluczy API
└── data/               # Dane wykonawcze (RAG, logi)

Skopiuj .env.example do .env i dodaj swój klucz API:

cp .env.example .env
# Edytuj .env i dodaj swój OPENAI_API_KEY (lub klucz innego dostawcy)

Uruchom środowisko:

droid up

Zobaczysz komunikat:

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

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

Rozmawiaj ze swoim agentem

Sinaptic® DROID+ udostępnia API zgodne з OpenAI, więc możesz użyć dowolnego SDK OpenAI lub po prostu polecenia curl:

curl:

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

Python (OpenAI SDK):

from openai import OpenAI

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

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

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: 'my-agent',
  messages: [{ role: 'user', content: 'Witaj!' }],
});

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

Pole model odpowiada nazwie agenta w Twojej konfiguracji YAML. Jako api_key w lokalnym środowisku programistycznym możesz podać dowolny ciąg znaków (chyba że skonfigurowałeś uwierzytelnianie w droid.yaml).

Wyjaśnienie konfiguracji agenta

Oto minimalna konfiguracja agenta (configs/agents/my-agent.yaml):

name: "my-agent"
description: "Asystent wsparcia klienta"

model:
  name: "gpt-4o-mini"       # Dowolny model od skonfigurowanego dostawcy
  max_tokens: 1024
  temperature: 0.7

personality: |
  Jesteś pomocnym asystentem wsparcia klienta.
  Odpowiadaj zwięźle i dokładnie. Zawsze bądź uprzejmy.

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

sinaptic:
  enabled: true              # Włącz testy bezpieczeństwa

Kluczowe pola:

• name — unikalny identyfikator agenta, używany jako model w wywołaniach API.
• model.name — model LLM (np. gpt-4o-mini, claude-sonnet-4-20250514, gemini-2.0-flash).
• personality — prompt systemowy definiujący zachowanie agenta.
• tools — wbudowane narzędzia, punkty końcowe REST API lub serwery MCP, z których może korzystać agent.
• sinaptic.enabled — przełącznik bezpieczeństwa SinapticAI (wykrywanie prompt injection, maskowanie danych PII).

Polecenia CLI

droid up          # Uruchom środowisko (ładuje wszystkich agentów)
droid down        # Bezpiecznie zatrzymaj działającą instancję
droid init NAZWA  # Utwórz nowy projekt agenta
droid agents      # Lista załadowanych agentów i ich status
droid health      # Sprawdź status serwera
droid version     # Wyświetl wersję, commit i datę kompilacji

Następne kroki

• Dostawcy LLM — Skonfiguruj OpenAI, Anthropic, Gemini, Grok lub modele lokalne.
• Narzędzia MCP — Dodaj zewnętrzne narzędzia poprzez Model Context Protocol.
• Bezpieczeństwo SinapticAI — Zrozum działanie wbudowanej warstwy bezpieczeństwa.
• Wdrożenie Docker — Uruchom Sinaptic® DROID+ produkcyjnie z Dockerem.
• Edycje — Porównaj funkcje wersji Community, Pro i Enterprise.