자주 묻는 질문 (FAQ)
일반
Sinaptic® DROID+란 무엇입니까?
Sinaptic® DROID+는 헤드리스(headless) AI 에이전트 런타임 엔진입니다. nginx가 웹사이트를 서비스하는 것처럼, Sinaptic® DROID+는 AI 에이전트를 서비스합니다. YAML 설정에서 에이전트를 정의하면 Sinaptic® DROID+가 이를 OpenAI 호환 API로 노출합니다. 단일 바이너리, 모든 LLM 제공업체 지원, 보안 기능 내장 등이 특징입니다.
Sinaptic® DROID+는 오픈 소스입니까?
Sinaptic® DROID+ Community Edition은 BSL 1.1(Business Source License 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에서 실행됩니다. 메모리 사용량은 작업 부하에 따라 다르지만 기본 설정의 경우 128MB면 충분합니다.
Docker 없이 Sinaptic® DROID+를 실행할 수 있습니까?
예. 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을 지정합니다. 동일한 Sinaptic® DROID+ 인스턴스에서 하나의 에이전트는 GPT-4o를, 다른 에이전트는 Claude Sonnet을, 세 번째 에이전트는 로컬 Ollama 모델을 사용하도록 실행할 수 있습니다.
직접 미세 조정(fine-tuned)한 모델을 Sinaptic® DROID+와 함께 사용할 수 있습니까?
예. 미세 조정된 모델이 OpenAI 호환 API(대부분의 제공업체 지원)를 통해 서비스되는 경우 Sinaptic® DROID+에서 사용할 수 있습니다. 정확한 base_url과 모델 이름을 설정하기만 하면 됩니다.
Sinaptic® DROID+가 내 데이터를 어딘가로 전송합니까?
Sinaptic® DROID+는 사용자가 설정한 LLM 제공업체로만 프롬프트를 전송합니다. Sinaptic® DROID+ 자체에 의한 텔레메트리, 분석 또는 데이터 수집은 없습니다. 로컬 모델(Ollama, LM Studio, llama.cpp)을 사용하는 경우 모든 데이터는 사용자의 장치에만 머뭅니다.
보안
SinapticAI란 무엇입니까?
SinapticAI는 Sinaptic® DROID+에 내장된 AI 의도 방화벽입니다. 프롬프트와 응답을 실시간으로 검사하여 프롬프트 인젝션 공격, 탈옥(jailbreak) 시도 및 PII(개인 식별 정보) 유출을 탐지하고 차단합니다. 자세한 내용은 SinapticAI 개요를 참조하세요.
Community Edition은 어떤 공격을 탐지합니까?
Community Edition에는 알려진 공격 벡터의 약 70%를 걸러내는 RegExp 보안 레이어가 포함되어 있습니다. 여기에는 일반적인 프롬프트 인젝션 패턴, 알려진 탈옥 템플릿, 시스템 프롬프트 추출 시도, PII 패턴(이메일, 전화번호, 신용카드) 등이 포함됩니다.
특정 에이전트에 대해 SinapticAI를 비활성화할 수 있습니까?
예. 에이전트의 YAML 설정에서 sinaptic.enabled: false로 설정하세요. droid.yaml의 전역 설정이 기본값을 제어합니다.
보안 검사를 위해 내 데이터가 로컬에서 처리됩니까?
예. 모든 SinapticAI 검사는 Sinaptic® DROID+ 인스턴스 내부에서 로컬로 실행됩니다. 보안 분석을 위해 외부 서비스로 데이터가 전송되지 않습니다.
API 및 통합
API가 정말로 OpenAI와 호환됩니까?
예. Sinaptic® DROID+는 OpenAI API와 동일한 요청/응답 형식을 갖는 /v1/chat/completions 엔드포인트를 구현합니다. 모든 언어에서 공식 OpenAI SDK를 사용할 수 있습니다. base_url만 Sinaptic® DROID+ 인스턴스로 변경하면 됩니다.
API 요청을 어떻게 인증합니까?
기본적으로 인증이 필요하지 않습니다(로컬 개발 모드). 프로덕션 환경의 경우 droid.yaml에서 API 키를 설정하세요.
server:
api_key: "your-secret-key"
그런 다음 OpenAI와 마찬가지로 Authorization: Bearer your-secret-key 헤더를 통해 요청에 키를 전달하세요.
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+는 어떤 포트를 사용합니까?
OpenAI 호환 API에는 8080 포트를, 관리 API 및 에이전트 빌더 UI에는 8081 포트를 사용합니다. 두 포트 모두 droid.yaml에서 변경 가능합니다.
관리 API를 공개적으로 노출해야 합니까?
아니요. 8081 포트는 관리 기능과 에이전트 빌더 UI를 제공합니다. 프로덕션 환경에서는 내부 네트워크에 두거나 인증 장치 뒤에 두는 것이 좋습니다.
여러 개의 Sinaptic® DROID+ 인스턴스를 실행할 수 있습니까?
예. 각 인스턴스는 (설정 파일과 데이터 디렉토리를 제외하고) 상태를 저장하지 않습니다. 로드 밸런서 뒤에서 여러 인스턴스를 실행할 수 있습니다. 조정된 다중 인스턴스 배포를 위해 Enterprise 에디션은 클러스터링 및 HA 기능을 제공합니다.
문제 해결
Sinaptic® DROID+가 시작되지만 에이전트가 로드되지 않습니다.
에이전트 YAML 파일이 droid.yaml의 agents_dir에 지정된 디렉토리에 있는지 확인하세요(기본값: ./configs/agents/). 로드된 에이전트를 확인하려면 droid agents를 실행하세요.
API 호출 시 "Connection refused" 오류가 발생합니다.
Sinaptic® DROID+가 실행 중인지 확인하고(droid health), 올바른 포트(기본값 8080)를 사용하고 있는지 확인하세요. Docker에서 실행 중인 경우 포트 매핑이 올바른지 확인하세요.
LLM 호출이 인증 오류로 실패합니다.
API 키가 올바르게 설정되었는지 확인하세요. echo $OPENAI_API_KEY(또는 관련 변수)로 확인해 보세요. 설정은 ${VAR} 구문을 지원하므로 환경 변수가 Sinaptic® DROID+ 프로세스에서 사용 가능한지 확인하세요.