# Painel Web do Neotask ## Visao Geral O Painel Web do Neotask e um centro de controle baseado em navegador para gerenciar seus agentes, monitorar sessoes, rastrear uso e configurar seu workspace. Acesse o painel na URL atribuida apos autenticar com sua chave de licenca. O painel fornece uma interface centralizada para todos os aspectos da sua implantacao do Neotask, incluindo configuracao de agentes, monitoramento de sessoes, orquestracao de equipes, analytics de uso e configuracoes de conta. --- ## Autenticacao ### Login por Chave de Licenca Para acessar o painel, insira sua chave de licenca na tela de login. Chaves de licenca seguem este formato: ``` SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX ``` Apos autenticacao bem-sucedida, voce recebe um token de sessao que concede acesso ao painel durante sua sessao. ### Autenticacao de Dois Fatores (TOTP) A autenticacao de dois fatores e opcional mas fortemente recomendada para todas as contas. **Configurando a autenticacao de dois fatores:** 1. Navegue ate **Configuracoes > Seguranca**. 2. Selecione **Ativar Autenticacao de Dois Fatores**. 3. Escaneie o codigo QR exibido com um aplicativo autenticador como Google Authenticator, Authy ou qualquer aplicativo compativel com TOTP. 4. Insira o codigo de verificacao de 6 digitos do seu aplicativo autenticador para confirmar a configuracao. 5. Baixe e armazene com seguranca os codigos de backup fornecidos. Esses codigos permitem que voce recupere o acesso se perder seu dispositivo autenticador. Uma vez ativado, um codigo de 6 digitos do seu aplicativo autenticador e necessario em cada login subsequente. Para desativar a autenticacao de dois fatores, va em **Configuracoes > Seguranca** e selecione a opcao para desativa-la. --- ## Pagina Inicial A pagina Inicial serve como visao geral do painel, apresentando um resumo de alto nivel da atividade do seu workspace. ### Grafico de Gastos do Agente Um grafico de barras exibindo custos discriminados por agente. Use-o para identificar quais agentes estao consumindo mais recursos. ### Resumo de Sessoes Exibe contagens de suas sessoes organizadas por status: - **Ativas** -- Sessoes atualmente em andamento. - **Falhas** -- Sessoes que encontraram erros. - **Concluidas** -- Sessoes que terminaram com sucesso. ### Sessoes Recentes Uma lista das 5 sessoes mais recentes, incluindo uso de tokens para cada uma. Selecione qualquer sessao para ver seus detalhes completos. ### Discriminacao de Uso por Modelo Mostra quais modelos de IA estao sendo usados em seus agentes, ajudando a entender a distribuicao de modelos e implicacoes de custo. ### Tarefas Proximas Uma visualizacao de calendario das suas automacoes agendadas, dando visibilidade sobre quais trabalhos estao por vir. ### Widgets Rapidos Widgets compactos fornecendo acesso rapido a funcoes-chave: - **Agentes** -- Exibe contagem de agentes com um toggle de auto-deploy para ativar ou desativar implantacao automatica de agentes. - **Uso** -- Exibe resumo de uso com um toggle de rastreamento automatico para ativar ou desativar rastreamento automatico de uso. - **Sessoes** -- Exibe atividade de sessao atual. --- ## Pagina de Agentes A pagina de Agentes e onde voce gerencia todos os seus agentes de IA. E organizada em sub-paginas com abas, cada uma focada em um aspecto diferente do gerenciamento de agentes. ### Aba Visao Geral A aba Visao Geral apresenta uma visao abrangente dos seus agentes e sua atividade. - **Estatisticas do Agente** -- Veja o nome de cada agente, modelo atribuido, contagem de sessoes, total de tokens consumidos e status atual. - **Grafico de Gastos** -- Selecione um agente para ver um grafico detalhado de gastos daquele agente. - **Discriminacao de Sessoes** -- Uma discriminacao da atividade de sessao do agente selecionado. - **Trabalhos Proximos** -- Uma lista de trabalhos agendados associados ao agente selecionado. - **Mini Calendario** -- Um calendario compacto destacando datas com eventos agendados. ### Aba Chat A aba Chat fornece uma visualizacao somente leitura das conversas do agente. - **Barra Lateral de Sessoes** -- Navegue por uma lista de sessoes na barra lateral e selecione uma para visualizar. - **Bolhas de Mensagem** -- Mensagens de conversa sao exibidas como bolhas de chat com indicadores de papel: - **Usuario** -- Mensagens enviadas pelo usuario. - **Assistente** -- Respostas do agente de IA. - **Sistema** -- Mensagens e instrucoes no nivel do sistema. - **Ferramenta** -- Mensagens geradas por chamadas de ferramentas. - **Timestamps** -- Cada mensagem exibe um timestamp relativo (por exemplo, "2 minutos atras"). ### Aba Skills A aba Skills permite que voce navegue, instale e gerencie skills do agente. - **Catalogo** -- Navegue por todas as skills disponiveis. Cada listagem de skill inclui o numero da versao, uma descricao e um link para sua pagina. - **Minhas Skills** -- Veja suas skills instaladas e use o toggle para ativar ou desativar cada uma. - **Organizacao por Categoria** -- Skills sao organizadas por categoria para facilitar a navegacao. - **Filtro de Pesquisa** -- Use a barra de pesquisa para filtrar skills por nome ou palavra-chave. ### Aba Canais A aba Canais exibe todos os canais de comunicacao conectados. - **Badges de Status** -- Cada canal exibe um badge de status indicando seu estado atual: **Conectado**, **Erro**, **Pendente** ou **Desconectado**. - **Adicionar Novos Canais** -- Use a opcao de adicionar canal para conectar uma nova plataforma de comunicacao. - **Filtrar por Tipo** -- Filtre a lista de canais por tipo de canal para encontrar conexoes especificas. ### Aba Integracoes A aba Integracoes gerencia conexoes de servicos externos e configuracoes de API. **Opcoes de filtro:** - Todos - Google - OAuth - API Key **Servicos Google Workspace:** Os seguintes servicos Google Workspace podem ser conectados e gerenciados: - Gmail - Google Calendar - Google Drive - Google Sheets - Google Docs - Google Meet Cada servico Google pode ser ativado ou desativado individualmente. **Configuracao de API:** - Configure chaves de API para servicos de terceiros. - Defina variaveis de ambiente necessarias pelas integracoes. ### Aba Automacoes A aba Automacoes fornece ferramentas para agendar e gerenciar trabalhos automatizados. - **Visualizacao de Calendario** -- Um calendario exibindo todos os trabalhos de automacao agendados. - **Lista de Trabalhos** -- Uma visualizacao em lista mostrando o nome de cada trabalho, agendamento, status atual e proximo horario de execucao. - **Historico de Execucao** -- Veja o historico de execucao de cada automacao com indicadores de status mostrando sucesso ou falha. - **Criar e Editar** -- Use os dialogos modais para criar novas automacoes ou editar existentes. ### Aba Ferramentas A aba Ferramentas exibe todas as ferramentas disponiveis organizadas por categoria. Cada ferramenta pode ser ativada ou desativada individualmente. **Ferramentas de Sistema de Arquivos:** - Ler arquivos - Escrever arquivos - Editar arquivos **Ferramentas de Execucao:** - Comandos shell - Gerenciamento de processos - Agentes subprocesso **Ferramentas Web:** - Navegador - Requisicoes HTTP **Ferramentas de Agendamento:** - Cron jobs - Webhooks --- ## Pagina de Sessoes A pagina de Sessoes fornece monitoramento detalhado de todas as sessoes de agentes no seu workspace. ### Caixas de KPI No topo da pagina, caixas de indicadores-chave de desempenho exibem: - **Total de Sessoes** -- O numero total de sessoes. - **Ativas** -- Sessoes em execucao no momento. - **Chamadas de Ferramentas** -- O numero total de chamadas de ferramentas feitas em todas as sessoes. - **Duracao Media** -- A duracao media de uma sessao. - **Falhas** -- O numero de sessoes que terminaram em falha. ### Grafico de Uso de Tokens Um grafico multi-linhas mostrando uso de tokens ao longo do tempo, com uma linha separada para cada agente. Use-o para identificar tendencias e picos no consumo de tokens. ### Discriminacoes - **Uso de Tokens por Agente** -- Uma discriminacao mostrando como os tokens sao distribuidos entre seus agentes. - **Chamadas de Ferramentas por Agente** -- Uma discriminacao mostrando volume de chamadas de ferramentas por agente. ### Tabela de Sessoes Pesquisavel Uma tabela listando todas as sessoes com as seguintes colunas: | Coluna | Descricao | |--------|-----------| | Agente | O agente que executou a sessao | | Chave da Sessao | O identificador unico da sessao | | Tokens (Entrada) | Numero de tokens de entrada consumidos | | Tokens (Saida) | Numero de tokens de saida gerados | | Tokens (Total) | Tokens de entrada e saida combinados | | Custo | O custo monetario da sessao | | Iniciado | Quando a sessao comecou | | Status | Status atual da sessao | ### Painel de Detalhes da Sessao Selecione qualquer sessao da tabela para abrir o painel de detalhes, que exibe: - Metadados completos da sessao (agente, modelo, timestamps, contagens de tokens, custo). - Entradas completas da sessao com indicadores de papel para cada mensagem. ### Filtros Restrinja a lista de sessoes usando: - **Filtro de Status** -- Todos, Ativas, Concluidas ou Falhas. - **Pesquisa** -- Pesquise por nome do agente ou chave da sessao. - **Intervalo de Datas** -- Intervalos predefinidos incluindo Hoje, Semana e Mes. --- ## Pagina de Equipes A pagina de Equipes permite orquestracao multi-agente, permitindo agrupar agentes em equipes e executar tarefas coordenadas. ### Layout A pagina de Equipes usa um layout de tres colunas: 1. **Lista de Agentes** -- Todos os agentes disponiveis que podem ser atribuidos a equipes. 2. **Lista de Equipes** -- Suas equipes criadas com suas configuracoes. 3. **Execucoes de Tarefas** -- Historico e status de execucoes de tarefas. ### Criando uma Equipe Para criar uma nova equipe: 1. Selecione **Criar Equipe**. 2. Insira um **nome** e **descricao** para a equipe. 3. Selecione os **agentes** para incluir na equipe. 4. Escolha um **modo de orquestracao**: - **Paralelo** -- Todos os agentes executam simultaneamente. - **Sequencial** -- Agentes executam um apos o outro em ordem. - **Hibrido** -- Uma combinacao de execucao paralela e sequencial. ### Execucoes de Tarefas - Execute prompts contra uma equipe para iniciar uma execucao de tarefa. - Veja o historico de execucoes com atualizacoes de status para cada execucao. ### Controles - **Iniciar/Parar Execucoes** -- Inicie ou interrompa execucoes de tarefas. - **Excluir Equipes** -- Remova equipes que nao sao mais necessarias. --- ## Pagina de Uso A pagina de Uso fornece rastreamento abrangente de custos e tokens em todo o seu workspace. ### Caixas de KPI Metricas resumidas exibidas no topo da pagina: - **Total de Tokens e Custo** -- Contagem combinada de tokens e custo monetario total. - **Discriminacao de Entrada** -- Total de tokens de entrada e seu custo associado. - **Discriminacao de Saida** -- Total de tokens de saida e seu custo associado. - **Dias Rastreados** -- O numero de dias incluidos no periodo de rastreamento. ### Grafico de Custos Uma discriminacao detalhada de custos ao longo do tempo. Use o seletor de intervalo para ajustar a visualizacao: - Hoje - Dia - Semana - Mes - Ano - Intervalo personalizado ### Discriminacao por Modelo Exibe os 8 principais modelos classificados por custo, mostrando como os gastos sao distribuidos entre diferentes modelos de IA. ### Distribuicao de Tokens Uma discriminacao percentual de tokens de entrada versus tokens de saida, dando visao sobre o equilibrio do seu consumo de tokens. ### Discriminacao por Agente Exibe os 8 principais agentes classificados por uso de tokens, com valores de custo correspondentes para cada agente. ### Tabela Diaria Uma visualizacao tabular dos dados de uso nos ultimos 30 dias com as seguintes colunas: - Data - Tokens - Tokens de entrada - Tokens de saida - Custo ### Exportar Selecione **Exportar** para baixar seus dados de uso como um arquivo CSV para analise externa ou manutencao de registros. --- ## Pagina de Downloads A pagina de Downloads fornece acesso ao aplicativo desktop do Neotask. ### Downloads Disponiveis - **macOS** -- Download do aplicativo desktop disponivel agora. - **Windows** -- Em breve. ### Guia de Instalacao Rapida 1. Baixe o aplicativo desktop para sua plataforma. 2. Instale o aplicativo em sua maquina. 3. Faca login com sua chave de licenca para comecar. --- ## Configuracoes Acesse as Configuracoes pelo menu suspenso do avatar na barra de navegacao. ### Conta Veja os detalhes da sua conta: - **Tenant ID** -- Seu identificador unico de workspace. - **Status da Licenca** -- Se sua licenca esta ativa. - **Plano** -- Seu plano de assinatura atual. - **Data de Expiracao** -- Quando sua licenca expira. - **Capacidade de Agentes:** O numero de agentes nao e limitado em nenhum plano; isso reflete as capacidades do seu plano atual. ### Seguranca Gerencie configuracoes de autenticacao e seguranca: - Ativar ou desativar autenticacao de dois fatores TOTP. - Visualizar e regenerar codigos de backup. ### Sobre Veja informacoes de versao do painel do Neotask e componentes relacionados. ### Idioma Selecione seu idioma de exibicao preferido. O painel suporta 20 idiomas. --- ## Assistente de Configuracao Inicial Novos usuarios sao guiados por um assistente de configuracao inicial de 11 etapas para configurar seu workspace. ### Etapa 1: Selecionar Template de Agente Escolha entre 9 templates de agente disponiveis para comecar com uma configuracao pre-configurada. ### Etapa 2: Configurar Agente Defina o **nome** do seu agente e selecione o **modelo** de IA que ele usara. ### Etapa 3: Definir Orcamento Diario Defina um limite de gasto diario para controlar custos do seu agente. ### Etapa 4: Conectar Canais Conecte seu agente a plataformas de comunicacao. 10 plataformas estao disponiveis para integracao. ### Etapa 5: Conectar Google Workspace Vincule ate 12 servicos Google Workspace, incluindo Gmail, Calendar, Drive, Sheets, Docs e Meet. ### Etapa 6: Recursos de Desenvolvedor e Codigo Configure recursos orientados a desenvolvedores e capacidades de execucao de codigo para seu agente. ### Etapa 7: Visao Geral de Skills Integradas Revise as 55+ skills integradas disponiveis para seu agente e selecione quais ativar. ### Etapa 8: Configuracao de Automacoes Configure automacoes agendadas e trabalhos recorrentes para seu agente. ### Etapa 9: Configuracao de Controle por Voz Configure as opcoes de controle por voz para interagir com seu agente usando comandos de voz. ### Etapa 10: Notificacoes Configure a entrega de notificacoes por webhooks do Discord para se manter informado sobre a atividade do agente. ### Etapa 11: Baixar Aplicativo Desktop Baixe e instale o aplicativo desktop do Neotask para acesso direto do seu computador.