Saltar al contenido principal

Variables de entorno

Los archivos de configuración de Sinaptic® DROID+ admiten la sustitución de ${VAR_ENTORNO}. Cualquier valor en droid.yaml o en las configuraciones de los agentes puede hacer referencia a una variable de entorno.

Archivo .env

Sinaptic® DROID+ carga automáticamente un archivo .env del directorio de trabajo al iniciarse. Las variables establecidas en el entorno del sistema tienen prioridad sobre los valores del archivo .env.

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

Claves de proveedores de LLM

VariableProveedorRequerido
OPENAI_API_KEYOpenAI (por defecto)Sí (si se usa OpenAI)
ANTHROPIC_API_KEYAnthropic (Claude)Sí (si se usa Anthropic)
GEMINI_API_KEYGoogle GeminiSí (si se usa Gemini)
GROK_API_KEYxAI GrokSí (si se usa Grok)

Los proveedores locales (Ollama, LM Studio, llama.cpp) no requieren claves API.

Variables del entorno de ejecución

VariableDescripciónPor defecto
DROID_CONFIGRuta al archivo de configuración principal./droid.yaml
DROID_DATA_DIRRuta al directorio de datos./data

Uso en la configuración

Haz referencia a cualquier variable de entorno con la sintaxis ${VAR}:

llm:
api_key: ${OPENAI_API_KEY}

server:
api_key: ${DROID_API_KEY}

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

Si una variable de entorno no está establecida, la cadena ${VAR} se deja tal cual (no se expande). Esto significa que el valor de configuración será la cadena literal ${VAR}, lo que probablemente causará un error de autenticación, facilitando la detección de variables faltantes.