Agentes
O Que Sao Agentes?
Agentes sao assistentes alimentados por IA que podem pensar, agir e se comunicar em seu nome. Diferente de chatbots simples, os agentes do Neotask sao entidades autonomas que raciocinam sobre problemas, executam tarefas e interagem em multiplas plataformas.
Caracteristicas principais dos agentes:
- Identidade: Cada agente possui um nome unico, emoji e personalidade que o distingue dos demais.
- Workspace: Cada agente opera dentro de seu proprio workspace, mantendo arquivos, sessoes e contexto separados.
- Skills: Agentes podem ser equipados com skills modulares que estendem suas capacidades (veja Skills).
- Canais: Agentes se conectam a plataformas de comunicacao como Slack, Discord e email para enviar e receber mensagens (veja Canais).
- Independencia: Multiplos agentes podem trabalhar independentemente em tarefas diferentes, ou colaborar como uma equipe para lidar com fluxos de trabalho complexos.
Capacidade de Agentes por Plano
| Plano | Agentes Simultaneos |
|---|---|
| Free | Apenas o agente de chat principal; a criacao de agentes personalizados e bloqueada |
| Individual | Agentes ilimitados com acesso completo a plataforma |
| Business | Agentes ilimitados, alem de operacoes de empresa e assentos para funcionarios |
| Enterprise | Agentes ilimitados com orquestracao multi-empresa em escala |
No plano Free, a principal superficie de agente suportada e o chat interativo, os boards e os fluxos de codificacao dentro da cota Free: primeiro 10 mensagens/eventos, depois 5 mensagens/eventos por dia no fuso do usuario. Usuarios Free podem conectar apps e chaves de provedores, mas nao podem adicionar agentes personalizados nem executar agentes de empresa autonomos. Em todos os planos pagos, o numero de agentes nao e limitado: o Individual entrega a plataforma completa para uma pessoa, enquanto Business e Enterprise adicionam operacoes de empresa e orquestracao paralela em larga escala, tudo coordenado pelo motor de orquestracao de equipes da plataforma. Veja Cobranca e Planos para detalhes sobre como o uso funciona.
Criando um Agente
Para criar um novo agente:
- Navegue ate Agentes no painel.
- Clique em Criar Agente.
- Forneca as seguintes informacoes:
- Nome: Um nome descritivo para o agente (ex.: "Bot de Suporte", "DevOps Runner").
- Workspace: Selecione um workspace existente ou crie um novo. O workspace determina onde o agente armazena arquivos e mantem estado.
- Emoji: Escolha um emoji para identificar visualmente o agente no painel.
Templates de Agente
O Neotask fornece templates pre-configurados para voce comecar rapidamente. Cada template vem com skills recomendadas, configuracoes de modelo e prompts de sistema adaptados para um caso de uso especifico:
| Template | Descricao |
|---|---|
| Assistente | Auxiliar de proposito geral para tarefas do dia a dia, perguntas e respostas e produtividade |
| Desenvolvedor | Geracao de codigo, depuracao, gerenciamento de repositorios e fluxos CI/CD |
| Pesquisador | Pesquisa aprofundada, sumarizacao e coleta de informacoes pela web |
| Redes Sociais | Criacao de conteudo, agendamento e engajamento em plataformas sociais |
| Analista de Dados | Processamento de dados, visualizacao e relatorios |
| Automacao Residencial | Controle de dispositivos inteligentes, rotinas e monitoramento |
| Assistente de Voz | Fluxos de trabalho conversacionais com fala-para-texto e texto-para-fala |
| Tutor | Entrega de conteudo educacional, quizzes e aprendizado adaptativo |
| Gerente de Campanhas | Planejamento, execucao e analise de campanhas de marketing |
Voce pode personalizar um template apos a criacao ou comecar do zero com um agente em branco.
Configuracao do Agente
Substituicao de Modelo
Por padrao, os agentes usam o modelo configurado globalmente nas configuracoes do Neotask. Voce pode substituir isso por agente para atribuir um modelo de IA especifico.
- Abra a aba Configuracoes do agente.
- Em Modelo, selecione um provedor e modelo no menu suspenso.
- Se definido como Padrao do Sistema, o agente seguira o modelo configurado globalmente.
Isso e util quando certos agentes precisam de raciocinio mais poderoso (ex.: Claude 4 Opus para tarefas de arquitetura) enquanto outros podem usar modelos mais leves para reduzir custos (ex.: GPT-4.1 Nano para formatacao).
Limites de Gasto
Controle custos definindo um limite diario de gasto por agente.
- Navegue ate a aba Configuracoes do agente.
- Em Limite de Gasto, insira um custo diario maximo em USD.
- Quando o agente atingir seu limite, ele parara de fazer chamadas de API pelo restante do dia.
- Os limites de gasto sao redefinidos a meia-noite UTC.
A aplicacao automatica garante que nenhum agente individual gere custos inesperados, o que e especialmente importante ao executar centenas de agentes no Enterprise ou quando agentes rodam de forma autonoma em agendamentos.
Modo Seguro
O modo seguro executa o agente dentro de um sandbox de execucao isolado. Quando ativado:
- O acesso ao sistema de arquivos e restrito ao diretorio de workspace do agente.
- Requisicoes de rede sao limitadas a dominios explicitamente permitidos.
- Comandos shell sao executados em um ambiente contido.
- O agente nao pode afetar outros agentes ou recursos no nivel do sistema.
O modo seguro e recomendado para agentes que executam codigo nao confiavel, interagem com APIs externas ou operam com supervisao minima.
Sessoes do Agente
Cada agente mantem sessoes de conversa que rastreiam o historico completo de interacao.
Tipos de Sessao
| Tipo | Comportamento |
|---|---|
| Principal | Uma sessao persistente que se mantem entre interacoes. O agente lembra do contexto anterior e pode referenciar mensagens anteriores. |
| Isolada | Uma sessao nova criada a cada vez. Nenhum contexto anterior e retido. Util para tarefas sem estado ou quando voce quer que o agente comece limpo. |
Historico de Chat
Cada sessao registra um historico completo de chat com papeis de mensagem claramente rotulados:
- Usuario: Mensagens enviadas por voce ou recebidas de um canal conectado.
- Assistente: Respostas geradas pelo agente.
- Sistema: Instrucoes no nivel do sistema, prompts ou mensagens de configuracao.
- Ferramenta: Resultados retornados de execucoes de skills e ferramentas.
Modo de Raciocinio
Ative o modo de raciocinio para ver o processo de raciocinio interno da IA antes de produzir uma resposta. Isso e util para:
- Depurar comportamento inesperado do agente.
- Entender como o agente chega a uma decisao.
- Auditar cadeias complexas de raciocinio em multiplas etapas.
Quando o modo de raciocinio esta ativo, as etapas de raciocinio do agente aparecem em uma secao recolhivel acima de cada resposta.
Anexos
Agentes podem processar anexos dentro de uma sessao:
- Imagens: Capturas de tela, fotos, diagramas. O agente pode analisar e descrever conteudo visual.
- Arquivos: Documentos, planilhas, PDFs. O agente pode ler, resumir e extrair dados.
- Codigo: Arquivos fonte e trechos. O agente pode revisar, editar e executar codigo.
Ferramentas do Agente
Agentes vem equipados com um conjunto de ferramentas integradas organizadas por categoria. Essas ferramentas estao sempre disponiveis e nao requerem instalacao.
Sistema de Arquivos
| Ferramenta | Descricao |
|---|---|
| Read | Ler o conteudo de um arquivo do workspace do agente |
| Write | Criar ou sobrescrever um arquivo no workspace do agente |
| Edit | Fazer edicoes direcionadas em um arquivo existente usando buscar e substituir |
Execucao
| Ferramenta | Descricao |
|---|---|
| Comandos Shell | Executar comandos shell (bash, zsh, etc.) dentro do ambiente do agente |
| Gerenciamento de Processos | Iniciar, parar e monitorar processos em execucao |
| Agentes Subprocesso | Criar agentes filhos para lidar com subtarefas, permitindo fluxos de trabalho paralelos e delegados |
Web
| Ferramenta | Descricao |
|---|---|
| Automacao de Navegador | Controlar um navegador headless para navegar paginas, preencher formularios, clicar elementos e capturar telas |
| Requisicoes HTTP | Fazer requisicoes HTTP/HTTPS para APIs e servicos web com controle total sobre metodo, cabecalhos e corpo |
Agendamento
| Ferramenta | Descricao |
|---|---|
| Cron Jobs | Agendar tarefas recorrentes usando expressoes cron (ex.: executar um relatorio toda segunda-feira as 9h) |
| Webhooks | Registrar endpoints de webhook que acionam acoes do agente quando chamados por servicos externos |
Modelos do Agente
O Neotask suporta multiplos provedores e modelos de IA. Voce pode atribuir qualquer modelo suportado a qualquer agente.
Provedores e Modelos Suportados
Anthropic
| Modelo | Melhor Para |
|---|---|
| Claude 4 Sonnet | Desempenho equilibrado em codificacao, analise e conversacao |
| Claude 4 Opus | Profundidade maxima de raciocinio para arquitetura e analise complexas |
| Claude 3.5 Haiku | Tarefas rapidas e leves como sumarizacao e classificacao |
OpenAI
| Modelo | Melhor Para |
|---|---|
| GPT-5.1 | Tarefas complexas de codificacao e geracao |
| GPT-4.1 | Tarefas de proposito geral com forte seguimento de instrucoes |
| GPT-4.1 Nano | Tarefas ultra-rapidas e leves como formatacao e boilerplate |
| Modelo | Melhor Para |
|---|---|
| Gemini 3 Pro | Analise complexa e raciocinio com contexto longo |
| Gemini 3 Flash | Pesquisa e testes rapidos com janelas de contexto grandes |
| Gemini 2.5 Flash Lite | Extracao de dados economica e processamento simples |
DeepSeek
| Modelo | Melhor Para |
|---|---|
| DeepSeek V3.2 | Revisao de codigo, documentacao e geracao de boilerplate |
OpenRouter
| Modelo | Melhor Para |
|---|---|
| Roteamento multi-modelo | Selecao automatica de modelo baseada no tipo de tarefa e orcamento |
Roteamento Inteligente de Tarefas
Quando um agente e configurado para usar roteamento inteligente, o Neotask seleciona automaticamente o melhor modelo para cada tarefa com base na complexidade e tipo. A tabela de roteamento abaixo mostra as atribuicoes padrao:
| Tipo de Tarefa | Modelo | Nivel |
|---|---|---|
| Arquitetura | Claude Sonnet 4 | Pesado |
| Codificacao Complexa | GPT-5.1 | Pesado |
| Analise Complexa | Gemini 3 Pro | Pesado |
| Codificacao Padrao | Claude Haiku 4.5 | Medio |
| Revisao de Codigo | DeepSeek V3.2 | Medio |
| Testes | Gemini 3 Flash | Medio |
| Pesquisa | Gemini 3 Flash (contexto 1M) | Medio |
| Documentacao | DeepSeek V3.2 | Medio |
| Extracao de Dados | Gemini 2.5 Flash Lite | Leve |
| Formatacao | GPT-4.1 Nano | Leve |
| Sumarizacao | Claude Haiku 3.5 | Leve |
| Tarefas Simples | GPT-4.1 Nano | Leve |
| Boilerplate | DeepSeek V3.2 | Leve |
Definicoes de nivel:
- Pesado: Tarefas que requerem raciocinio profundo, contexto grande ou alta precisao. Usam os modelos mais capazes (e mais caros).
- Medio: Tarefas que precisam de bom desempenho mas podem ser tratadas por modelos intermediarios. Um bom equilibrio entre custo e capacidade.
- Leve: Tarefas rotineiras que priorizam velocidade e eficiencia de custo. Usam os modelos mais rapidos e acessiveis.
O roteamento inteligente ajuda a otimizar seus custos de uso combinando automaticamente o modelo certo para a tarefa certa. Isso e especialmente valioso em planos Enterprise onde centenas de agentes podem estar rodando simultaneamente.