Agentes

O Que Sao Agentes?

Agentes sao assistentes com inteligencia artificial 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 tem 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 equipe para lidar com fluxos de trabalho complexos.

Capacidade de Agentes por Plano

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:

1. Navegue ate Agentes no dashboard.
2. Clique em Criar Agente.
3. 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 dashboard.

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 a um caso de uso especifico:

Voce sempre 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 global configurado 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 dropdown.
• 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 teto 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 rodar centenas de agentes no Enterprise ou quando agentes operam autonomamente 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 do 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 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

Historico do Chat

Cada sessao registra um historico completo do chat com papeis de mensagem claramente identificados:

• Usuario -- Mensagens enviadas por voce ou recebidas de um canal conectado.
• Assistente -- Respostas geradas pelo agente.
• Sistema -- Instrucoes de 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 de raciocinio complexas 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

Execucao

Web

Agendamento

Modelos de Agente

O Neotask suporta multiplos provedores e modelos de IA. Voce pode atribuir qualquer modelo suportado a qualquer agente.

Provedores e Modelos Suportados

Anthropic

OpenAI

Google

DeepSeek

OpenRouter

Roteamento Inteligente de Tarefas

Quando um agente esta 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:

Definicoes de nivel:

• Pesado -- Tarefas que exigem 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 de 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 o modelo certo com a tarefa certa automaticamente. Isso e especialmente valioso em planos Enterprise onde centenas de agentes podem estar rodando simultaneamente.