본문으로 건너뛰기

설정 개요

Sinaptic® DROID+는 두 가지 유형의 YAML 설정 파일을 사용합니다.

메인 설정 (droid.yaml)

메인 설정 파일은 런타임을 제어합니다: 서버 포트, LLM 제공업체 자격 증명, 보안 설정, 로깅 및 경로 등을 설정합니다.

edition: community

server:
openai_port: 8080
management_port: 8081

llm:
provider: openai
api_key: ${OPENAI_API_KEY}
default_model: gpt-4o-mini

sinaptic:
enabled: true
mode: block

logging:
level: info
format: json

agents_dir: ./configs/agents

Sinaptic® DROID+는 기본적으로 현재 디렉토리에서 droid.yaml을 찾지만, droid up --config /path/to/droid.yaml 명령을 통해 경로를 지정할 수도 있습니다.

에이전트 설정 (configs/agents/*.yaml)

각 에이전트는 고유한 YAML 파일을 가집니다. 에이전트의 name 필드는 API 호출 시 model 파라미터로 사용됩니다.

name: my-agent
description: 도움이 되는 어시스턴트

model:
name: gpt-4o-mini
max_tokens: 1024
temperature: 0.7

personality: |
당신은 도움이 되는 어시스턴트입니다. 간결하고 정확하게 답변하세요.

tools:
- name: web-search
type: mcp

Sinaptic® DROID+는 시작 시 agents_dir 디렉토리에서 모든 .yaml 파일을 로드하며, 변경 사항을 감시하여 핫 리로드를 수행합니다.

환경 변수 치환

모든 설정 값은 ${ENV_VAR} 구문을 지원합니다. Sinaptic® DROID+는 시작 시 이를 해석합니다.

llm:
api_key: ${OPENAI_API_KEY} # 환경 변수에서 해석됨

로컬 개발 시에는 프로젝트 루트의 .env 파일을 사용하세요. Sinaptic® DROID+가 자동으로 이를 로드합니다.

추가 자료