본문으로 건너뛰기

빠른 시작

단 5분 만에 첫 번째 AI 에이전트를 실행해 보세요.

사전 요구 사항​

  • 지원되는 LLM 제공업체(OpenAI, Anthropic, Google, xAI 또는 로컬 모델)의 API 키
  • 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

첫 번째 에이전트 만들기​

방법 A: AI 빌더 UI (코드 불필요)​

Sinaptic® DROID+를 시작하고 비주얼 빌더를 엽니다.

droid up
# 브라우저에서 http://localhost:8081/builder/ 를 엽니다.

AI 빌더 UI를 사용하면 모델 선택, 시스템 프롬프트 작성, 도구 추가 및 실시간 테스트를 시각적으로 수행할 수 있습니다. 작업이 완료되면 자동으로 YAML 설정 파일이 생성됩니다.

방법 B: 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 — 에이전트의 고유 식별자로, API 호출 시 model 이름으로 사용됩니다.
  • model.name — 사용할 LLM 모델 (예: gpt-4o-mini, claude-sonnet-4-20250514, gemini-2.0-flash)
  • personality — 에이전트의 행동 방식을 정의하는 시스템 프롬프트
  • tools — 에이전트가 사용할 수 있는 내장 도구, REST API 엔드포인트 또는 MCP 서버
  • sinaptic.enabled — SinapticAI 보안(프롬프트 인젝션 감지, 개인정보 마스킹) 활성화 여부

CLI 명령어​

droid up          # 런타임 시작 (모든 에이전트 로드)
droid down        # 실행 중인 인스턴스를 안전하게 중단
droid init NAME   # 새 에이전트 프로젝트 생성
droid agents      # 로드된 에이전트 목록 및 상태 확인
droid health      # 서버 상태 확인
droid version     # 버전, 커밋, 빌드 날짜 출력

다음 단계​

  • LLM 제공업체 — OpenAI, Anthropic, Gemini, Grok 또는 로컬 모델 설정하기
  • MCP 도구 — Model Context Protocol을 통해 외부 도구 추가하기
  • SinapticAI 보안 — 내장 보안 계층 이해하기
  • Docker 배포 — Docker를 사용하여 프로덕션 환경에서 Sinaptic® DROID+ 실행하기
  • 에디션 — Community, Pro, Enterprise 기능 비교하기