Saltar al contenido principal

FAQ

General​

¿Qué es Sinaptic® DROID+?​

Sinaptic® DROID+ es un motor de ejecución de agentes de IA sin interfaz (headless). Al igual que nginx sirve sitios web, Sinaptic® DROID+ sirve agentes de IA. Defines los agentes en configuraciones YAML y Sinaptic® DROID+ los expone como una API compatible con OpenAI. Un solo binario, cualquier proveedor de LLM, seguridad integrada.

¿Es Sinaptic® DROID+ de código abierto?​

Sinaptic® DROID+ Community Edition es de código disponible bajo la Licencia Business Source 1.1 (BSL 1.1). Es gratuito para uso interno con hasta 2 agentes. La licencia se convierte a Apache 2.0 después de la fecha de cambio. Las ediciones Pro y Enterprise tienen licencia comercial.

¿Cuál es la diferencia entre Community, Pro y Enterprise?​

Consulta la Comparación de ediciones para ver la matriz completa de características. En resumen: Community es gratuita con hasta 2 agentes y seguridad basada en RegExp. Pro elimina los límites de agentes y añade la cascada completa de seguridad de SinapticAI. Enterprise añade multi-tenancy, características de cumplimiento y soporte SLA.

¿Tengo que pagar por la edición Community?​

No. La edición Community es gratuita para siempre para uso interno con hasta 2 agentes. Sin registro, sin telemetría y sin límites de uso en las llamadas a la API.

Instalación y Configuración​

¿Cuáles son los requisitos del sistema?​

Sinaptic® DROID+ es un único binario de Go sin dependencias externas. Se ejecuta en Linux (amd64/arm64), macOS (Intel/Apple Silicon) y Windows. El uso de memoria depende de tu carga de trabajo, pero 128 MB son suficientes para configuraciones básicas.

¿Puedo ejecutar Sinaptic® DROID+ sin Docker?​

Sí. Sinaptic® DROID+ es un binario independiente. Descárgalo de GitHub Releases, dale permisos de ejecución y ejecuta droid up. Docker es opcional.

¿Cómo actualizo Sinaptic® DROID+?​

Para instalaciones binarias, descarga la nueva versión y reemplaza el binario. Para Docker, docker pull sinapticai/droid:latest && docker compose up -d. Tus archivos de configuración y datos están separados del binario, por lo que las actualizaciones no destruyen los datos.

Proveedores de LLM​

¿Qué proveedores de LLM son compatibles?​

Los 7 proveedores están disponibles en todas las ediciones: OpenAI, Anthropic (Claude), Google Gemini, xAI Grok, Ollama, LM Studio y llama.cpp. Los proveedores en la nube requieren claves API. Los proveedores locales (Ollama, LM Studio, llama.cpp) no requieren claves.

¿Puedo usar modelos diferentes para agentes diferentes?​

Sí. Cada agente especifica su propio model.provider y model.name. Puedes ejecutar un agente en GPT-4o, otro en Claude Sonnet y un tercero en un modelo local de Ollama, todo desde la misma instancia de Sinaptic® DROID+.

¿Puedo usar Sinaptic® DROID+ con mis propios modelos ajustados (fine-tuned)?​

Sí. Si tu modelo ajustado se sirve a través de una API compatible con OpenAI (que la mayoría de los proveedores soportan), Sinaptic® DROID+ puede usarlo. Simplemente configura el base_url correcto y el nombre del modelo.

¿Sinaptic® DROID+ envía mis datos a alguna parte?​

Sinaptic® DROID+ envía tus prompts solo al proveedor de LLM que configures. No hay telemetría, ni analítica, ni recolección de datos por parte de Sinaptic® DROID+. Cuando usas modelos locales (Ollama, LM Studio, llama.cpp), todo permanece en tu máquina.

Seguridad​

¿Qué es SinapticAI?​

SinapticAI es un firewall de intención de IA integrado en Sinaptic® DROID+. Inspecciona prompts y respuestas en tiempo real para detectar y bloquear ataques de inyección de prompts, intentos de jailbreak y fugas de PII (información de identificación personal). Consulta el resumen de SinapticAI para más detalles.

¿Qué ataques detecta la edición Community?​

La edición Community incluye la capa de seguridad RegExp, que captura aproximadamente el 70% de los vectores de ataque conocidos: patrones comunes de inyección de prompts, plantillas de jailbreak conocidas, intentos de extracción del prompt del sistema y patrones de PII (correos electrónicos, números de teléfono, tarjetas de crédito).

¿Puedo desactivar SinapticAI para agentes específicos?​

Sí. Establece sinaptic.enabled: false en la configuración YAML del agente. La configuración global en droid.yaml controla el valor predeterminado.

¿Mis datos se procesan localmente para las comprobaciones de seguridad?​

Sí. Todas las comprobaciones de SinapticAI se ejecutan localmente dentro de tu instancia de Sinaptic® DROID+. No se envían datos a servicios externos para el análisis de seguridad.

API e Integración​

¿Es la API realmente compatible con OpenAI?​

Sí. Sinaptic® DROID+ implementa el endpoint /v1/chat/completions con el mismo formato de solicitud/respuesta que la API de OpenAI. Puedes usar el SDK oficial de OpenAI en cualquier lenguaje; solo tienes que cambiar el base_url a tu instancia de Sinaptic® DROID+.

¿Cómo autentico las solicitudes de la API?​

Por defecto, no se requiere autenticación (modo de desarrollo local). Para producción, configura una clave API en droid.yaml:

server:
  api_key: "tu-clave-secreta"

Luego pásala en las solicitudes a través del encabezado Authorization: Bearer tu-clave-secreta, igual que con OpenAI.

¿Puedo usar Sinaptic® DROID+ como un reemplazo directo de OpenAI?​

Sí. Configura el base_url a tu instancia de Sinaptic® DROID+ y usa cualquier nombre de agente como parámetro model. El formato de respuesta es idéntico al de OpenAI.

Agentes​

¿Cuál es el límite de agentes en la edición Community?​

La edición Community admite hasta 2 agentes. Si necesitas más, actualiza a Pro (agentes ilimitados). El límite es sobre agentes cargados simultáneamente, no sobre el total de configuraciones.

¿Puedo recargar agentes en caliente sin reiniciar?​

Sí. Sinaptic® DROID+ vigila el directorio de agentes en busca de cambios. Cuando modificas la configuración YAML de un agente, se recarga automáticamente sin reiniciar el servidor ni interrumpir las conexiones activas.

¿Qué herramientas pueden usar los agentes?​

Los agentes pueden usar herramientas integradas (current_time, etc.), herramientas de API REST (llamar a cualquier endpoint HTTP) y herramientas MCP (Model Context Protocol para integraciones extensibles como búsqueda web, acceso a archivos, bases de datos). Consulta la guía de MCP.

Despliegue​

¿Qué puertos usa Sinaptic® DROID+?​

El puerto 8080 para la API compatible con OpenAI y el puerto 8081 para la API de gestión y la interfaz del Constructor de Agentes. Ambos son configurables en droid.yaml.

¿Debería exponer la API de gestión públicamente?​

No. El puerto 8081 proporciona funcionalidad de administración y la interfaz del Constructor de Agentes. Manténlo en una red interna o detrás de autenticación en producción.

¿Puedo ejecutar múltiples instancias de Sinaptic® DROID+?​

Sí. Cada instancia es sin estado (más allá de sus archivos de configuración y directorio de datos). Puedes ejecutar múltiples instancias detrás de un equilibrador de carga. Para despliegues coordinados de múltiples instancias, la edición Enterprise ofrece características de clustering y alta disponibilidad (HA).

Solución de problemas​

Sinaptic® DROID+ arranca pero los agentes no se cargan​

Comprueba que tus archivos YAML de agentes estén en el directorio especificado por agents_dir en droid.yaml (por defecto: ./configs/agents/). Ejecuta droid agents para ver los agentes cargados.

"Connection refused" al llamar a la API​

Asegúrate de que Sinaptic® DROID+ se esté ejecutando (droid health) y que estés usando el puerto correcto (por defecto 8080). Si se ejecuta en Docker, asegúrate de que los puertos estén mapeados correctamente.

Las llamadas a LLM fallan con errores de autenticación​

Verifica que tu clave API esté configurada correctamente. Comprueba con echo $OPENAI_API_KEY (o la variable correspondiente). La configuración admite la sintaxis ${VAR}; asegúrate de que la variable de entorno esté disponible para el proceso de Sinaptic® DROID+.