Часті запитання (FAQ)
Загальне
Що таке Sinaptic® DROID+?
Sinaptic® DROID+ — це безголовий (headless) двигун середовища виконання ШІ-агентів. Подібно до того, як nginx обслуговує веб-сайти, Sinaptic® DROID+ обслуговує ШІ-агентів. Ви визначаєте агентів у конфігураціях YAML, а Sinaptic® DROID+ надає їх через API, сумісний з OpenAI. Один бінарний файл, будь-який постачальник LLM, вбудована безпека.
Чи є Sinaptic® DROID+ відкритим кодом?
Sinaptic® DROID+ Community Edition доступний за ліцензією Business Source License 1.1 (BSL 1.1). Його можна безкоштовно використовувати для внутрішніх потреб з кількістю агентів до 2. Після дати зміни ліцензія конвертується в Apache 2.0. Видання Pro та Enterprise ліцензуються комерційно.
Яка різниця між Community, Pro та Enterprise?
Дивіться Порівняння видань для отримання повної матриці функцій. Коротко: Community безкоштовне з обмеженням до 2 агентів та безпекою на основі RegExp. Pro знімає обмеження на кількість агентів та додає повний каскад безпеки SinapticAI. Enterprise додає мультитенінтність (багатокористувацький режим), функції відповідності стандартам та підтримку SLA.
Чи потрібно платити за Community Edition?
Ні. Community Edition є безкоштовним назавжди для внутрішнього використання з кількістю агентів до 2. Без реєстрації, без телеметрії, без обмежень на кількість викликів API.
Встановлення та налаштування
Які системні вимоги?
Sinaptic® DROID+ — це єдиний бінарний файл Go без зовнішніх залежностей. Він працює на Linux (amd64/arm64), macOS (Intel/Apple Silicon) та Windows. Використання пам'яті залежить від вашого навантаження, але 128 МБ достатньо для базових налаштувань.
Чи можу я запустити Sinaptic® DROID+ без Docker?
Так. Sinaptic® DROID+ — це автономний бінарний файл. Завантажте його з GitHub Releases, зробіть виконуваним та запустіть droid up. Docker є опціональним.
Як оновити Sinaptic® DROID+?
Для встановлення бінарним файлом: завантажте нову версію та замініть файл. Для Docker: docker pull sinapticai/droid:latest && docker compose up -d. Ваші конфігураційні файли та дані відокремлені від бінарного файлу, тому оновлення є безпечним для даних.
Постачальники LLM
Які постачальники LLM підтримуються?
Усі 7 постачальників доступні в кожному виданні: OpenAI, Anthropic (Claude), Google Gemini, xAI Grok, Ollama, LM Studio та llama.cpp. Хмарні постачальники потребують API-ключів. Локальні постачальники (Ollama, LM Studio, llama.cpp) не потребують ключів.
Чи можу я використовувати різні моделі для різних агентів?
Так. Кожен агент вказує власні model.provider та model.name. Ви можете запустити одного агента на GPT-4o, іншого на Claude Sonnet, а третього на локальній моделі Ollama — і все це в межах одного екземпляра Sinaptic® DROID+.
Чи можу я використовувати Sinaptic® DROID+ з моїми власними донавченими моделями?
Так. Якщо ваша донавчена модель обслуговується через API, сумісний з OpenAI (що підтримує більшість постачальників), Sinaptic® DROID+ може її використовувати. Просто вкажіть правильний base_url та назву моделі.
Чи надсилає Sinaptic® DROID+ мої дані кудись?
Sinaptic® DROID+ надсилає ваші промпти лише тому постачальнику LLM, якого ви налаштували. У Sinaptic® DROID+ немає телеметрії, аналітики чи збору даних самим двигуном. При використанні локальних моделей (Ollama, LM Studio, llama.cpp) все залишається на вашій машині.
Безпека
Що таке SinapticAI?
SinapticAI — це фаєрвол намірів ШІ, вбудований у Sinaptic® DROID+. Він інспектує промпти та відповіді в реальному часі для виявлення та блокування атак промпт-ін'єкцій, спроб джейлбрейку та витоків PII (персональних даних). Дивіться огляд SinapticAI для деталей.
Які атаки виявляє Community Edition?
Community Edition включає рівень безпеки RegExp, який виявляє приблизно 70% відомих векторів атак: поширені патерни промпт-ін'єкцій, відомі шаблони джейлбрейків, спроби вилучення системного промпту та патерни PII (електронні адреси, номери телефонів, кредитні картки).
Чи можу я вимкнути SinapticAI для певних агентів?
Так. Встановіть sinaptic.enabled: false у конфігурації YAML відповідного агента. Глобальне налаштування в droid.yaml керує значенням за замовчуванням.
Чи обробляються мої дані локально для перевірок безпеки?
Так. Усі перевірки SinapticAI виконуються локально всередині вашого екземпляра Sinaptic® DROID+. Жодні дані не надсилаються зовнішнім сервісам для аналізу безпеки.
API та інтеграція
Чи дійсно API сумісний з OpenAI?
Так. Sinaptic® DROID+ реалізує кінцеву точку /v1/chat/completions з тим самим форматом запиту/відповіді, що й API OpenAI. Ви можете використовувати офіційний OpenAI SDK будь-якою мовою — просто змініть base_url на адресу вашого екземпляра Sinaptic® DROID+.
Як автентифікувати запити до API?
За замовчуванням автентифікація не потрібна (режим локальної розробки). Для продакшну налаштуйте API-ключ у droid.yaml:
server:
api_key: "ваш-секретний-ключ"
Потім передавайте його в запитах через заголовок Authorization: Bearer ваш-секретний-ключ, так само, як з OpenAI.
Чи можу я використовувати Sinaptic® DROID+ як пряму заміну OpenAI?
Так. Встановіть base_url на адресу вашого екземпляра Sinaptic® DROID+ і використовуйте будь-яке ім'я агента як параметр model. Формат відповіді ідентичний формату OpenAI.
Агенти
Яке обмеження на кількість агентів у Community Edition?
Community Edition підтримує до 2 агентів. Якщо вам потрібно більше, перейдіть на Pro (необмежена кількість агентів). Обмеження стосується одночасно завантажених агентів, а не загальної кількості конфігурацій.
Чи можу я гаряче перезавантажувати агентів без перезапуску?
Так. Sinaptic® DROID+ стежить за директорією агентів на предмет змін. Коли ви змінюєте конфігурацію YAML агента, він автоматично перезавантажується без перезапуску сервера та розриву активних з'єднань.
Які інструменти можуть використовувати агенти?
Агенти можуть використовувати вбудовані інструменти (current_time тощо), інструменти REST API (виклик будь-якої кінцевої точки HTTP) та інструменти MCP (Model Context Protocol для розширюваних інтеграцій, таких як веб-пошук, доступ до файлів, бази даних). Дивіться довідник MCP.
Розгортання
Які порти використовує Sinaptic® DROID+?
Порт 8080 для API, сумісного з OpenAI, та порт 8081 для Management API та інтерфейсу Agent Builder. Обидва порти можна налаштувати в droid.yaml.
Чи варто відкривати Management API для публічного доступу?
Ні. Порт 8081 надає функціональність адміністратора та інтерфейс Agent Builder. Тримайте його у внутрішній мережі або за автентифікацією у продакшні.
Чи можу я запустити кілька екземплярів Sinaptic® DROID+?
Так. Кожен екземпляр не зберігає стан (окрім своїх конфігураційних файлів та директорії даних). Ви можете запустити кілька екземплярів за балансувальником навантаження. Для скоординованих розгортань з кількома екземплярами видання Enterprise надає функції кластеризації та високої доступності (HA).
Усунення несправностей
Sinaptic® DROID+ запускається, але агенти не завантажуються
Перевірте, чи знаходяться ваші YAML-файли агентів у директорії, вказаній у параметрі agents_dir в droid.yaml (за замовчуванням: ./configs/agents/). Запустіть droid agents, щоб побачити завантажених агентів.
"Connection refused" при виклику API
Переконайтеся, що Sinaptic® DROID+ запущено (droid health) і ви використовуєте правильний порт (за замовчуванням 8080). Якщо ви використовуєте Docker, переконайтеся, що порти прокинуті правильно.
Виклики LLM завершуються помилками автентифікації
Перевірте, чи правильно встановлено ваш API-ключ. Перевірте за допомогою echo $OPENAI_API_KEY (або відповідної змінної). Конфігурація підтримує синтаксис ${VAR} — переконайтеся, що змінна оточення доступна процесу Sinaptic® DROID+.