# Descripcion General de la Plataforma

## Que Es Neotask?

El **Gateway** es el motor central que impulsa Neotask. Es un unico servicio de larga ejecucion que gestiona todo: sesiones de agentes, integraciones de mensajeria, ejecucion de herramientas, automatizaciones programadas y conexiones de dispositivos.

Piense en el como el cerebro al que su aplicacion de escritorio Neotask, aplicaciones moviles y panel web se conectan. Mientras usted interactua a traves de esas interfaces, el Gateway hace el trabajo pesado detras de escena.

## Arquitectura

Neotask usa un modelo hub-and-spoke:

- **El Gateway** es el hub central -- un servidor WebSocket que se ejecuta en su maquina (o en la nube). Gestiona todas las sesiones de agentes, enruta mensajes entre canales, orquesta la ejecucion de herramientas y persiste el estado.
- **Los Clientes** (la aplicacion de escritorio, aplicaciones moviles, panel web o terminal) se conectan al Gateway y envian/reciben mensajes a traves de el.
- **Los Nodos** (aplicaciones companion en iOS, Android, macOS) exponen capacidades del dispositivo -- camara, canvas, grabacion de pantalla, ubicacion y voz -- a los agentes que se ejecutan en el Gateway.
- **Los Canales** (WhatsApp, Telegram, Discord, Slack, etc.) son transportes de mensajeria a los que el Gateway se conecta para enviar y recibir mensajes.

Todas las operaciones de IA pasan por el pipeline Gateway -> Proveedor LLM. La aplicacion de escritorio nunca llama a un LLM directamente.

## Capacidades Clave

### Mensajeria Multi-Canal
Conectese a mas de 20 plataformas de mensajeria simultaneamente. Sus agentes pueden enviar y recibir mensajes en WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Google Chat, Microsoft Teams, Matrix, IRC y mas -- todo desde una unica instancia de Gateway. Consulte [Canales](channels.md).

### Sistema Multi-Agente
Ejecute multiples agentes aislados, cada uno con su propio espacio de trabajo, personalidad, configuracion de modelo y vinculaciones de canal. Enrute mensajes entrantes de canales, servidores o contactos especificos al agente correcto automaticamente. Consulte [Agentes](agents.md).

### Capacidades de Dispositivo via Nodos
Conecte aplicaciones companion de iOS, Android y macOS como "nodos" que exponen hardware del dispositivo a sus agentes. Los agentes pueden tomar fotos, grabar video, capturar la pantalla, obtener ubicacion GPS, renderizar canvas interactivos y ejecutar comandos del sistema -- todo a traves de lenguaje natural. Consulte [Aplicaciones Companion](companion-apps.md).

### Automatizacion de Navegador
Los agentes pueden controlar un navegador Chromium completo -- abrir paginas, hacer clic en elementos, llenar formularios, tomar capturas de pantalla, extraer contenido, cargar archivos y ejecutar JavaScript. Se soportan multiples perfiles de navegador para aislamiento de cuentas. Consulte [Herramientas y Capacidades](tools-capabilities.md).

### Canvas y A2UI
El sistema Agent-to-UI (A2UI) permite a los agentes renderizar contenido visual interactivo en dispositivos conectados. Los agentes pueden presentar paginas web, enviar actualizaciones de UI estructuradas, ejecutar JavaScript en el contexto del canvas y tomar instantaneas de lo que se muestra. Consulte [Herramientas y Capacidades](tools-capabilities.md).

### Soporte Flexible de Modelos
Use cualquier proveedor principal de LLM -- Anthropic (Claude), OpenAI (GPT), Google (Gemini), Together AI, Moonshot, OpenRouter y mas. Configure cadenas de respaldo de modelos, alias y sobrecargas de modelo por agente. Ejecute modelos locales via Ollama o vLLM. Consulte [Modelos y Proveedores](models-providers.md).

### Ecosistema de Plugins y Skills
Extienda Neotask con plugins que agregan nuevos canales, herramientas, metodos RPC y capacidades. Explore los skills disponibles en el [catalogo de skills](/skills). Cree sus propios skills para ensenar nuevos flujos de trabajo a los agentes. Consulte [Plugins y Skills](plugins-skills.md).

### Programacion y Automatizacion
Programe activaciones de agentes con expresiones cron, recordatorios unicos o disparadores basados en intervalos. Los agentes pueden ejecutar tareas automatizadas, entregar resultados a canales o publicar en webhooks. Consulte [Automatizacion](automation.md).

### Interaccion por Voz
Use palabras de activacion para activar su agente por voz. El modo de conversacion habilita conversaciones de voz continuas con speech-to-text y text-to-speech en tiempo real (ElevenLabs, OpenAI). El daemon Swabble en macOS proporciona deteccion de voz siempre activa en el dispositivo. Consulte [Voz](voice.md).

### Inteligencia de Sesion
Las sesiones se reinician automaticamente diariamente, se compactan al acercarse a los limites de contexto y persisten entre reinicios. La busqueda de memoria permite a los agentes recordar informacion de conversaciones anteriores usando similitud vectorial. Consulte [Sesiones y Memoria](sessions-memory.md).

### Autoalojado y Privado
Todo se ejecuta en su infraestructura. Sus mensajes, claves API y datos de agentes nunca salen de sus maquinas a menos que configure explicitamente un servicio externo. El Gateway se vincula a localhost por defecto -- cero exposicion de red externa.

### Ejecucion en Sandbox
Ejecute comandos de agentes en contenedores Docker aislados con limites de recursos configurables, politicas de red y confinamiento del sistema de archivos. Los perfiles de sandbox por agente le permiten controlar exactamente a que puede acceder cada agente. Consulte [Seguridad](security.md).

## Como Encaja Todo

1. **Usted** interactua con sus agentes a traves de la aplicacion de escritorio Neotask, una aplicacion companion movil, o directamente via plataformas de mensajeria como WhatsApp o Telegram.
2. **El Gateway** recibe su mensaje, lo enruta al agente correcto e inicia un turno de IA.
3. **El agente** procesa su solicitud usando el LLM configurado (Claude, GPT, etc.), llama a cualquier herramienta que necesite (navegador, canvas, operaciones de archivos, comandos shell) y genera una respuesta.
4. **La respuesta** se entrega de vuelta a usted a traves del mismo canal, o se anuncia en un canal diferente si esta configurado.
5. **El estado** (transcripciones de sesion, configuracion de agentes, trabajos programados) se persiste localmente para que todo sobreviva a los reinicios.