Перейти до основного вмісту

Швидкий старт

Запустіть свого першого ШІ-агента за 5 хвилин.

Попередні вимоги​

  • API-ключ будь-якого підтримуваного провайдера LLM (OpenAI, Anthropic, Google, xAI або локальна модель)
  • macOS, Linux або Windows (WSL)

Встановлення​

Скрипт (рекомендовано):

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

Docker:

docker pull sinapticai/droid:latest

Завантаження бінарного файлу:

Завантажте бінарний файл для вашої платформи зі сторінки GitHub Releases.

ПлатформаАрхітектураЗавантаження
Linuxamd64droid-linux-amd64
Linuxarm64droid-linux-arm64
macOSApple Silicondroid-darwin-arm64
macOSInteldroid-darwin-amd64
Windowsamd64droid-windows-amd64.exe

Створення першого агента​

Варіант А: ШІ-конструктор (без коду)​

Запустіть Sinaptic® DROID+ та відкрийте візуальний конструктор:

droid up
# Відкрийте http://localhost:8081/builder/ у браузері

Візуальний конструктор дозволяє налаштовувати агента графічно: обирайте модель, пишіть системний промпт, додавайте інструменти та тестуйте все в реальному часі. Після завершення він створить для вас YAML-конфігурацію.

Варіант Б: YAML-конфігурація​

Створіть новий проєкт:

droid init my-agent
cd my-agent

Це створить директорію проєкту з такою структурою:

my-agent/
├── droid.yaml          # Конфігурація середовища (порти, ключі LLM, безпека)
├── configs/agents/
│   └── my-agent.yaml   # Визначення вашого агента
├── .env.example        # Шаблон для API-ключів
└── data/               # Дані виконання (RAG, логи)

Скопіюйте .env.example у .env та додайте свій API-ключ:

cp .env.example .env
# Відредагуйте .env та додайте свій OPENAI_API_KEY (або ключ іншого провайдера)

Запустіть систему:

droid up

Ви побачите повідомлення:

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

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/

Спілкування з агентом​

Sinaptic® DROID+ надає OpenAI-сумісний API, тож ви можете використовувати будь-який OpenAI SDK або просто curl:

curl:

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

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": "Привіт!"}]
)

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: 'Привіт!' }],
});

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

Поле model відповідає імені агента у вашій YAML-конфігурації. Для локальної розробки в api_key можна вказати будь-який рядок (якщо ви не налаштували автентифікацію в droid.yaml).

Пояснення конфігурації агента​

Ось мінімальна конфігурація агента (configs/agents/my-agent.yaml):

name: "my-agent"
description: "Помічник служби підтримки"

model:
  name: "gpt-4o-mini"       # Будь-яка модель вашого провайдера
  max_tokens: 1024
  temperature: 0.7

personality: |
  Ви — корисний помічник служби підтримки.
  Пишіть лаконічно та точно. Завжди будьте ввічливі.

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

sinaptic:
  enabled: true              # Увімкнути перевірки безпеки

Ключові поля:

  • name — унікальний ідентифікатор агента, використовується як model у викликах API.
  • model.name — модель LLM (наприклад, gpt-4o-mini, claude-sonnet-4-20250514, gemini-2.0-flash).
  • personality — системний промпт, що визначає поведінку агента.
  • tools — вбудовані інструменти, REST API ендпоінти або сервери MCP.
  • sinaptic.enabled — увімкнення безпеки SinapticAI (виявлення ін'єкцій, маскування PII).

Команди CLI​

droid up          # Запустити (завантажує всіх агентів)
droid down        # Коректно зупинити запущений екземпляр
droid init NAME   # Створити новий проєкт агента
droid agents      # Список завантажених агентів та їхній статус
droid health      # Перевірити стан сервера
droid version     # Вивести версію, комміт та дату збірки

Наступні кроки​