# Visao Geral da Plataforma

## O Que E o Neotask?

O **Gateway** e o motor central que alimenta o Neotask. E um unico servico de longa execucao que gerencia tudo: sessoes de agente, integracoes de mensagens, execucao de ferramentas, automacoes agendadas e conexoes de dispositivos.

Pense nele como o cerebro ao qual o app desktop do Neotask, apps moveis e dashboard web se conectam. Enquanto voce interage por essas interfaces, o Gateway esta fazendo o trabalho pesado nos bastidores.

## Arquitetura

Neotask usa um modelo hub-and-spoke:

- **O Gateway** e o hub central -- um servidor WebSocket que roda na sua maquina (ou na nuvem). Ele gerencia todas as sessoes de agente, roteia mensagens entre canais, orquestra execucao de ferramentas e persiste estado.
- **Clientes** (o app desktop, apps moveis, dashboard web ou terminal) se conectam ao Gateway e enviam/recebem mensagens atraves dele.
- **Nodes** (apps companion no iOS, Android, macOS) expoe capacidades do dispositivo -- camera, canvas, gravacao de tela, localizacao e voz -- para agentes rodando no Gateway.
- **Canais** (WhatsApp, Telegram, Discord, Slack, etc.) sao transportes de mensagens aos quais o Gateway se conecta para enviar e receber mensagens.

Todas as operacoes de IA passam pelo pipeline Gateway → Provedor LLM. O app desktop nunca chama um LLM diretamente.

## Capacidades Principais

### Mensagens Multi-Canal
Conecte-se a mais de 20 plataformas de mensagens simultaneamente. Seus agentes podem enviar e receber mensagens no WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Google Chat, Microsoft Teams, Matrix, IRC e mais -- tudo a partir de uma unica instancia do Gateway. Veja [Canais](channels.md).

### Sistema Multi-Agente
Execute multiplos agentes isolados, cada um com seu proprio workspace, personalidade, configuracao de modelo e vinculacoes de canal. Roteie mensagens de entrada de canais, servidores ou contatos especificos para o agente correto automaticamente. Veja [Agentes](agents.md).

### Capacidades de Dispositivo via Nodes
Conecte apps companion iOS, Android e macOS como "nodes" que expoe hardware do dispositivo para seus agentes. Agentes podem tirar fotos, gravar video, capturar a tela, obter localizacao GPS, renderizar canvas interativos e executar comandos de sistema -- tudo por linguagem natural. Veja [Apps Companion](companion-apps.md).

### Automacao de Navegador
Agentes podem controlar um navegador Chromium completo -- abrir paginas, clicar em elementos, preencher formularios, tirar screenshots, extrair conteudo, fazer upload de arquivos e executar JavaScript. Multiplos perfis de navegador sao suportados para isolamento de contas. Veja [Ferramentas e Capacidades](tools-capabilities.md).

### Canvas e A2UI
O sistema Agent-to-UI (A2UI) permite que agentes renderizem conteudo visual interativo em dispositivos conectados. Agentes podem apresentar paginas web, enviar atualizacoes de UI estruturadas, executar JavaScript no contexto do canvas e tirar snapshots do que esta sendo exibido. Veja [Ferramentas e Capacidades](tools-capabilities.md).

### Suporte Flexivel a Modelos
Use qualquer provedor LLM principal -- Anthropic (Claude), OpenAI (GPT), Google (Gemini), Together AI, Moonshot, OpenRouter e mais. Configure cadeias de fallback de modelos, aliases e sobrescritas de modelo por agente. Execute modelos locais via Ollama ou vLLM. Veja [Modelos e Provedores](models-providers.md).

### Ecossistema de Plugins e Skills
Estenda o Neotask com plugins que adicionam novos canais, ferramentas, metodos RPC e capacidades. Navegue pelas skills disponiveis no [catalogo de skills](/skills). Crie suas proprias skills para ensinar novos workflows aos agentes. Veja [Plugins e Skills](plugins-skills.md).

### Agendamento e Automacao
Agende despertares de agente com expressoes cron, lembretes unicos ou gatilhos baseados em intervalo. Agentes podem executar tarefas automatizadas, entregar resultados em canais ou postar em webhooks. Veja [Automacao](automation.md).

### Interacao por Voz
Use palavras de ativacao para acionar seu agente por voz. O modo de conversa habilita conversas por voz continuas com fala-para-texto e texto-para-fala em tempo real (ElevenLabs, OpenAI). O daemon Swabble no macOS fornece deteccao de voz sempre ativa e no dispositivo. Veja [Voz](voice.md).

### Inteligencia de Sessao
Sessoes resetam automaticamente diariamente, compactam quando se aproximam dos limites de contexto e persistem entre reinicializacoes. A busca por memoria permite que agentes recuperem informacoes de conversas anteriores usando similaridade vetorial. Veja [Sessoes e Memoria](sessions-memory.md).

### Auto-Hospedado e Privado
Tudo roda na sua infraestrutura. Suas mensagens, API keys e dados de agentes nunca saem das suas maquinas a menos que voce configure explicitamente um servico externo. O Gateway se vincula ao localhost por padrao -- zero exposicao de rede externa.

### Execucao em Sandbox
Execute comandos de agentes em containers Docker isolados com limites configuraveis de recursos, politicas de rede e confinamento de sistema de arquivos. Perfis de sandbox por agente permitem controlar exatamente o que cada agente pode acessar. Veja [Seguranca](security.md).

## Como Tudo Se Encaixa

1. **Voce** interage com seus agentes pelo app desktop do Neotask, um app companion movel, ou diretamente via plataformas de mensagens como WhatsApp ou Telegram.
2. **O Gateway** recebe sua mensagem, roteia para o agente correto e inicia um turno de IA.
3. **O agente** processa sua solicitacao usando o LLM configurado (Claude, GPT, etc.), chama quaisquer ferramentas necessarias (navegador, canvas, operacoes de arquivo, comandos shell) e gera uma resposta.
4. **A resposta** e entregue de volta para voce pelo mesmo canal, ou anunciada em um canal diferente se configurado.
5. **O estado** (transcricoes de sessao, configuracao de agente, jobs agendados) e persistido localmente para que tudo sobreviva a reinicializacoes.