Saltar al contenido principal

Descripción general de la configuración

Sinaptic® DROID+ utiliza dos tipos de archivos de configuración YAML:

Configuración principal (droid.yaml)​

El archivo de configuración principal controla el entorno de ejecución: puertos del servidor, credenciales del proveedor de LLM, ajustes de seguridad, registro (logging) y rutas.

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+ busca droid.yaml en el directorio actual por defecto, o puedes especificar una ruta con droid up --config /ruta/al/archivo/droid.yaml.

Configuraciones de agentes (configs/agents/*.yaml)​

Cada agente tiene su propio archivo YAML. El campo name del agente se convierte en el parámetro model en las llamadas a la API.

name: my-agent
description: Un asistente servicial

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

personality: |
  Eres un asistente servicial. Sé conciso y preciso.

tools:
  - name: web-search
    type: mcp

Sinaptic® DROID+ carga todos los archivos .yaml del directorio agents_dir al iniciarse y vigila los cambios para la recarga en caliente (hot-reload).

Sustitución de variables de entorno​

Todos los valores de configuración admiten la sintaxis ${VAR_ENTORNO}. Sinaptic® DROID+ los resuelve al iniciarse:

llm:
  api_key: ${OPENAI_API_KEY}    # Resuelto desde el entorno

Utiliza un archivo .env en la raíz del proyecto para el desarrollo local. Sinaptic® DROID+ lo carga automáticamente.

Más lectura​