환경 변수

Sinaptic® DROID+ 설정 파일은 ${ENV_VAR} 치환을 지원합니다. droid.yaml 또는 에이전트 설정의 모든 값은 환경 변수를 참조할 수 있습니다.

.env 파일

Sinaptic® DROID+는 시작 시 작업 디렉토리에서 .env 파일을 자동으로 로드합니다. 시스템 환경에 설정된 변수는 .env 파일의 값보다 우선순위가 높습니다.

# .env
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GEMINI_API_KEY=AIza...
GROK_API_KEY=xai-...

LLM 제공업체 키

변수	제공업체	필수 여부
OPENAI_API_KEY	OpenAI (기본값)	예 (OpenAI 사용 시)
ANTHROPIC_API_KEY	Anthropic (Claude)	예 (Anthropic 사용 시)
GEMINI_API_KEY	Google Gemini	예 (Gemini 사용 시)
GROK_API_KEY	xAI Grok	예 (Grok 사용 시)

로컬 제공업체(Ollama, LM Studio, llama.cpp)는 API 키가 필요하지 않습니다.

런타임 변수

변수	설명	기본값
DROID_CONFIG	메인 설정 파일 경로	./droid.yaml
DROID_DATA_DIR	데이터 디렉토리 경로	./data

설정에서의 사용

${VAR} 구문을 사용하여 모든 환경 변수를 참조할 수 있습니다.

llm:
  api_key: ${OPENAI_API_KEY}

server:
  api_key: ${DROID_API_KEY}

mcp:
  servers:
    my-server:
      env:
        TOKEN: ${MY_SERVICE_TOKEN}

환경 변수가 설정되지 않은 경우, ${VAR} 문자열은 그대로 유지됩니다(확장되지 않음). 즉, 설정 값은 리터럴 문자열인 ${VAR}가 되며, 이는 인증 오류를 발생시킬 가능성이 높으므로 누락된 변수를 쉽게 찾을 수 있게 해줍니다.