Przejdź do głównej zawartości

FAQ

Ogólne​

Czym jest Sinaptic® DROID+?​

Sinaptic® DROID+ to bezgłowy (headless) silnik środowiska wykonawczego dla agentów AI. Podobnie jak nginx serwuje strony internetowe, Sinaptic® DROID+ serwuje agentów AI. Definiujesz agentów w konfiguracjach YAML, a Sinaptic® DROID+ udostępnia ich poprzez API kompatybilne z OpenAI. Jeden plik binarny, dowolny dostawca LLM, wbudowane bezpieczeństwo.

Czy Sinaptic® DROID+ jest open source?​

Sinaptic® DROID+ Community Edition jest dostępny na licencji Business Source License 1.1 (BSL 1.1). Jest darmowy do użytku wewnętrznego z maksymalnie 2 agentami. Licencja zmienia się na Apache 2.0 po dacie zmiany. Edycje Pro i Enterprise są licencjonowane komercyjnie.

Jaka jest różnica między Community, Pro i Enterprise?​

Zobacz Porównanie edycji dla pełnej macierzy funkcji. W skrócie: Community jest darmowa z limitem do 2 agentów i bezpieczeństwem opartym na RegExp. Pro usuwa limity agentów i dodaje pełną kaskadę bezpieczeństwa SinapticAI. Enterprise dodaje multi-tenancy, funkcje zgodności i wsparcie SLA.

Czy muszę płacić za edycję Community?​

Nie. Edycja Community jest darmowa na zawsze do użytku wewnętrznego z maksymalnie 2 agentami. Bez rejestracji, bez telemetrii, bez limitów użycia wywołań API.

Instalacja i konfiguracja​

Jakie są wymagania systemowe?​

Sinaptic® DROID+ to pojedynczy plik binarny Go bez zewnętrznych zależności. Działa na Linuxie (amd64/arm64), macOS (Intel/Apple Silicon) i Windowsie. Zużycie pamięci zależy od obciążenia, ale 128MB wystarcza dla podstawowych konfiguracji.

Czy mogę uruchomić Sinaptic® DROID+ bez Dockera?​

Tak. Sinaptic® DROID+ to samodzielny plik binarny. Pobierz go z GitHub Releases, nadaj uprawnienia do wykonywania i uruchom droid up. Docker jest opcjonalny.

Jak zaktualizować Sinaptic® DROID+?​

Dla instalacji binarnych: pobierz nową wersję i zastąp plik binarny. Dla Dockera: docker pull sinapticai/droid:latest && docker compose up -d. Twoje pliki konfiguracyjne i dane są oddzielone od pliku binarnego, więc aktualizacje nie niszczą danych.

Dostawcy LLM​

Którzy dostawcy LLM są wspierani?​

Wszystkich 7 dostawców jest dostępnych w każdej edycji: OpenAI, Anthropic (Claude), Google Gemini, xAI Grok, Ollama, LM Studio i llama.cpp. Dostawcy chmurowi wymagają kluczy API. Dostawcy lokalni (Ollama, LM Studio, llama.cpp) nie wymagają kluczy.

Czy mogę używać różnych modeli dla różnych agentów?​

Tak. Każdy agent określa własnego dostawcę (model.provider) i nazwę modelu (model.name). Możesz uruchomić jednego agenta na GPT-4o, innego na Claude Sonnet, a trzeciego na lokalnym modelu Ollama — wszystko w ramach tej samej instancji Sinaptic® DROID+.

Czy mogę używać Sinaptic® DROID+ z moimi własnymi dotrenowanymi modelami?​

Tak. Jeśli Twój dotrenowany model jest serwowany przez API kompatybilne z OpenAI (co wspiera większość dostawców), Sinaptic® DROID+ może go używać. Po prostu ustaw poprawny base_url i nazwę modelu.

Czy Sinaptic® DROID+ wysyła moje dane gdziekolwiek?​

Sinaptic® DROID+ wysyła Twoje prompty tylko do skonfigurowanego dostawcy LLM. Sinaptic® DROID+ nie posiada telemetrii, analityki ani nie zbiera żadnych danych. Przy użyciu lokalnych modeli (Ollama, LM Studio, llama.cpp) wszystko zostaje na Twojej maszynie.

Bezpieczeństwo​

Czym jest SinapticAI?​

SinapticAI to firewall intencji AI wbudowany w Sinaptic® DROID+. Sprawdza prompty i odpowiedzi w czasie rzeczywistym, aby wykrywać i blokować ataki typu prompt injection, próby jailbreaku i wycieki danych osobowych (PII). Zobacz przegląd SinapticAI po szczegóły.

Jakie ataki wykrywa edycja Community?​

Edycja Community zawiera warstwę bezpieczeństwa RegExp, która wyłapuje około 70% znanych wektorów ataków: powszechne wzorce prompt injection, znane szablony jailbreaku, próby wyciągnięcia promptu systemowego oraz wzorce PII (emaile, numery telefonów, karty kredytowe).

Czy mogę wyłączyć SinapticAI dla konkretnych agentów?​

Tak. Ustaw sinaptic.enabled: false w konfiguracji YAML agenta. Ustawienie globalne w droid.yaml kontroluje wartość domyślną.

Czy moje dane są przetwarzane lokalnie w celu sprawdzenia bezpieczeństwa?​

Tak. Wszystkie kontrole SinapticAI odbywają się lokalnie wewnątrz Twojej instancji Sinaptic® DROID+. Żadne dane nie są wysyłane do zewnętrznych usług w celu analizy bezpieczeństwa.

API i integracja​

Czy API jest naprawdę kompatybilne z OpenAI?​

Tak. Sinaptic® DROID+ implementuje punkt końcowy /v1/chat/completions z tym samym formatem żądania/odpowiedzi co API OpenAI. Możesz używać oficjalnego OpenAI SDK w dowolnym języku — po prostu zmień base_url na adres swojej instancji Sinaptic® DROID+.

Jak uwierzytelniać żądania API?​

Domyślnie uwierzytelnianie nie jest wymagane (tryb lokalny). W produkcji skonfiguruj klucz API w droid.yaml:

server:
  api_key: "twój-sekretny-klucz"

Następnie przesyłaj go w żądaniach w nagłówku Authorization: Bearer twój-sekretny-klucz, tak jak w przypadku OpenAI.

Czy mogę używać Sinaptic® DROID+ jako bezpośredniego zamiennika OpenAI?​

Tak. Ustaw base_url na adres swojej instancji Sinaptic® DROID+ i użyj dowolnej nazwy agenta jako parametru model. Format odpowiedzi jest identyczny z OpenAI.

Agenci​

Jaki jest limit agentów w edycji Community?​

Edycja Community wspiera do 2 agentów. Jeśli potrzebujesz więcej, przejdź na Pro (nielimitowana liczba agentów). Limit dotyczy jednocześnie załadowanych agentów, nie całkowitej liczby konfiguracji.

Czy mogę przeładowywać agentów bez restartu?​

Tak. Sinaptic® DROID+ monitoruje katalog agentów pod kątem zmian. Gdy zmodyfikujesz konfigurację YAML agenta, zostanie on automatycznie przeładowany bez restartowania serwera i zrywania aktywnych połączeń.

Jakich narzędzi mogą używać agenci?​

Agenci mogą używać narzędzi wbudowanych (current_time itp.), narzędzi REST API (wywołanie dowolnego punktu końcowego HTTP) oraz narzędzi MCP (Model Context Protocol dla rozszerzalnych integracji, takich jak wyszukiwanie w sieci, dostęp do plików, bazy danych). Zobacz przewodnik MCP.

Wdrożenie​

Jakich portów używa Sinaptic® DROID+?​

Port 8080 dla API kompatybilnego z OpenAI oraz port 8081 dla Management API i UI Kreatora Agenta. Oba można skonfigurować w droid.yaml.

Czy powinienem udostępniać Management API publicznie?​

Nie. Port 8081 zapewnia funkcjonalność administracyjną i UI Kreatora Agenta. W środowisku produkcyjnym trzymaj go w sieci wewnętrznej lub za uwierzytelnianiem.

Czy mogę uruchomić wiele instancji Sinaptic® DROID+?​

Tak. Każda instancja jest bezstanowa (poza plikami konfiguracyjnymi i katalogiem danych). Możesz uruchomić wiele instancji za load balancerem. W przypadku skoordynowanych wdrożeń wieloinstancyjnych edycja Enterprise zapewnia funkcje klastrowania i HA.

Rozwiązywanie problemów​

Sinaptic® DROID+ uruchamia się, ale agenci się nie ładują​

Sprawdź, czy pliki YAML agentów znajdują się w katalogu określonym przez agents_dir w droid.yaml (domyślnie: ./configs/agents/). Uruchom droid agents, aby zobaczyć załadowanych agentów.

"Connection refused" przy wywoływaniu API​

Upewnij się, że Sinaptic® DROID+ działa (droid health) i używasz poprawnego portu (domyślnie 8080). Jeśli używasz Dockera, upewnij się, że porty są poprawnie zmapowane.

Wywołania LLM kończą się błędami uwierzytelniania​

Upewnij się, że Twój klucz API jest ustawiony poprawnie. Sprawdź za pomocą echo $OPENAI_API_KEY (lub odpowiedniej zmiennej). Konfiguracja wspiera składnię ${VAR} — upewnij się, że zmienna środowiskowa jest dostępna dla procesu Sinaptic® DROID+.