Manual do usuário

O Cidadão.AI é a plataforma de transparência pública da Neural Thinkers Lab. Você pergunta em português, em linguagem corrente, sobre contratos, licitações e gastos públicos, e um conjunto de agentes de inteligência artificial busca a resposta nas fontes oficiais de dados abertos do Brasil.

Este manual cobre o caminho comum: entrar, perguntar, e organizar o que você já perguntou. O perfil de cada agente e o catálogo detalhado das APIs governamentais ficam na documentação técnica, que é mantida à parte e não se repete aqui.

Para quem é

A plataforma é aberta a qualquer pessoa interessada em dado público: cidadão que quer fiscalizar a própria cidade, pesquisador, estudante. Não existem perfis diferentes de acesso. Todo mundo entra na mesma tela e usa as mesmas ferramentas; o que muda entre uma conta e outra é o plano contratado.

A página pública

Antes de entrar, / apresenta a plataforma. A barra de navegação leva a Início, Funcionalidades, Agentes IA, Transparência, Pesquisa e Acessar.

Vale conhecer duas seções antes de usar o produto:

• Agentes de IA mostra a grade de agentes, cada um com nome e retrato. Passe o cursor sobre um retrato, ou toque nele no celular, para ver o papel daquele agente e o que ele faz.
• Legado Acadêmico reúne a origem do projeto: a monografia completa publicada no Zenodo com DOI permanente, o caderno de notas de pesquisa em PDF, a documentação técnica e os repositórios da versão 1, que é aberta e está arquivada. Se você chegou aqui por interesse de pesquisa, comece por essa seção.

O botão Entrar na Plataforma leva ao login. Se você já estiver autenticado, ele aparece como Acessar Plataforma e vai direto para o chat.

Entrar

A tela de login oferece três caminhos.

Por um provedor que você já usa. Google, Meta, GitHub, LinkedIn, Banco do Brasil e Microsoft. Um clique, a autenticação acontece no provedor, e você volta para a plataforma.

Sem senha. O bloco Sem senha traz duas opções:

• Código WhatsApp: escolha o DDI, informe o número, e você recebe um código de seis dígitos no WhatsApp para digitar na tela seguinte.
• Link por email: informe o endereço e clique em Enviar link. A tela passa a dizer que é para verificar a caixa de entrada, e o acesso se completa ao abrir o link que chegou.

Com email e senha. Clique em Continuar com email. No mesmo formulário você alterna entre Entrar e Criar conta.

Concluída a autenticação, uma tela intermediária mostra Autenticando... e depois Autenticado com sucesso!, e você cai no chat. As telas internas são protegidas: se você abrir qualquer uma sem estar autenticado, é devolvido ao login.

A tela de conversa

Chat IA é a tela principal e o lugar onde o produto acontece.

Ao abrir uma conversa nova você vê uma saudação pelo horário do dia, com o seu primeiro nome. Se a sua conta não tem nome cadastrado, a plataforma chama você de Cidadão. Abaixo fica a caixa de texto, com o convite Como posso ajudar você hoje?.

Escreva a pergunta e envie com Enter. Para quebrar linha sem enviar, use Shift+Enter.

Começar por um atalho

Sob a caixa há quatro atalhos, que apenas preenchem e enviam uma pergunta pronta:

Eles servem para começar. Depois do primeiro envio, siga a conversa escrevendo normalmente.

Escolher quem responde

À esquerda da caixa há um seletor que começa em Auto, descrito como "IA seleciona o melhor agente". Deixado assim, a plataforma lê a sua pergunta, identifica a intenção e encaminha ao especialista adequado. É a forma recomendada, e é o que a maior parte das perguntas pede.

Se quiser dirigir a pergunta a um agente específico, abra o seletor e escolha pelo nome. A lista traz os agentes que estão ativos no momento, com o papel de cada um. A escolha vale para as próximas mensagens até você trocar de novo ou voltar para Auto.

O que acontece enquanto a resposta vem

A resposta chega em fluxo, palavra a palavra, e a interface conta o que está fazendo em cada momento. Primeiro Processando..., depois Detectando intenção..., depois a intenção reconhecida, depois o nome do agente que ficou com a pergunta, e então o texto começa a aparecer. Acima da resposta ficam o retrato e o nome desse agente, para você saber quem respondeu.

A resposta é formatada, com títulos, listas e tabelas quando o conteúdo pede.

Sobre confiar na resposta

Os agentes trabalham sobre dados públicos, e a resposta é um texto gerado por inteligência artificial a partir deles. Trate esse texto como ponto de partida, não como resultado final: quando o assunto for decisivo, confira na fonte oficial antes de agir. O valor da plataforma é chegar rápido ao dado certo, e não dispensar você de olhar para ele.

Histórico e projetos

A barra lateral guarda tudo o que você já conversou.

Novo chat limpa a tela e começa do zero, sem apagar nada do que existe.

Abaixo, em Histórico, as conversas aparecem agrupadas por quando foram usadas pela última vez: Hoje, Ontem, Últimos 7 dias, Últimos 30 dias e Mais antigos. Clique em uma para reabri-la com as mensagens anteriores carregadas. Enquanto você não tiver nenhuma, a lista diz que não há conversa ainda.

Passando o cursor sobre uma conversa aparece um menu com:

• Renomear, que pede o novo nome. Conversa sem nome é listada como "Chat sem título".
• Mover para projeto, disponível quando você já tem ao menos um projeto criado. Do mesmo menu você também tira a conversa do projeto.
• Excluir.

Projetos

Projetos agrupa conversas de um mesmo assunto. Clique no ícone ao lado do título para criar um, dê um nome, e ele aparece na lista com uma cor própria e a contagem de conversas dentro. Clique no nome para abrir ou fechar o grupo. O menu do projeto permite Renomear e Excluir projeto.

O plano gratuito limita quantos projetos você pode ter ao mesmo tempo. Quando o limite é atingido, o botão de criar aparece com um cadeado e a própria barra lateral mostra quantos projetos você já usou e qual o teto. Para saber o que cada plano libera, veja a tela de assinatura.

De onde vêm os dados

As respostas são montadas a partir de fontes públicas oficiais. A plataforma tem clientes próprios para consultar, entre outras:

• Portal da Transparência do governo federal
• PNCP, o Portal Nacional de Contratações Públicas da Lei 14.133/2021
• Compras.gov.br, com órgãos, licitações, fornecedores e contratos
• SICONFI, do Tesouro Nacional, com dados contábeis e fiscais
• Banco Central, com séries econômicas, câmbio e estatísticas do PIX
• IBGE, com estados, municípios, população e indicadores
• DataSUS, com dados abertos de saúde
• INEP, com instituições de ensino e indicadores educacionais
• Minha Receita, para dados cadastrais de CNPJ
• dados.gov.br, o catálogo federal de dados abertos
• Portais estaduais de dados abertos e tribunais de contas estaduais

Nem toda pergunta encontra resposta em todas essas fontes. A cobertura varia por estado, por município e por tipo de dado, e depende de o órgão ter publicado a informação. O catálogo detalhado, com o que cada uma dessas APIs entrega, fica na documentação técnica.

Notificações

O sino no alto da tela mostra os avisos da plataforma, com o que ainda não foi lido, e permite marcar como lido item a item ou tudo de uma vez.

Para receber aviso no navegador mesmo com a aba fechada, abra /notificacoes. Essa página faz o registro do navegador e aceita a permissão de notificação; ela precisa rodar no domínio do Cidadão.AI, e por isso é uma tela separada. Ao terminar, ela devolve você para accounts.ntlabs.dev, onde ficam as preferências: quais categorias você quer receber e em que horários.

Sua conta e seus planos

Configurações, no menu do seu nome, não é mais uma tela deste produto. Ela leva você para accounts.ntlabs.dev, onde identidade, segurança, cobrança e privacidade ficam centralizadas para todos os produtos da Neural Thinkers Lab.

A tela Plano & Assinatura, em /assinatura, mostra o seu plano vigente, o que ele inclui e como trocar. Os planos e os valores vêm da plataforma e mudam com o tempo, então essa tela é a única fonte confiável sobre o que você tem contratado hoje. Se algum limite do seu plano for atingido, um aviso aparece no topo do chat dizendo qual foi.

Acessibilidade

O menu Acessibilidade, no alto da tela, oferece Tamanho do Texto, que vai de Muito Pequeno a Extra Grande, Alto Contraste e VLibras (Libras). Ao lado dele fica o botão que alterna entre tema claro e escuro; por padrão a plataforma acompanha a preferência do seu sistema.

Telas que ainda não entregam conteúdo

Duas entradas da barra lateral não fazem hoje o que o nome sugere, e é melhor você saber antes de procurar:

• Mapa do Brasil abre uma tela que anuncia visualização de dados de transparência por estado e informa, no próprio corpo da página, que está em desenvolvimento. Não há mapa para consultar ali.
• O botão de modo de voz, ao lado do envio no chat, está desativado.

Tudo o que a plataforma entrega hoje passa pela conversa em texto.

Seus dados

O Cidadão.AI trabalha sobre dado público, não sobre dado seu. O que a plataforma guarda a seu respeito é o necessário para manter a conta e o histórico das suas conversas, e você apaga esse histórico quando quiser, pelo menu de cada conversa. Na primeira visita a plataforma pede seu consentimento para cookies.

Os termos de uso, a política de privacidade e o canal do encarregado de proteção de dados ficam em www.ntlabs.dev.