Ajuda › Agente HNR
Agente HNR — O seu assistente de contabilidade
O Agente é um assistente que olha os seus dados e responde às suas perguntas em frases comuns. Você pergunta "para quem eu mais vendi neste mês?" e ele consulta sem abrir relatório nenhum e te diz. O mais importante a saber é isto: esta versão é somente leitura — o agente não consegue alterar, excluir nem criar nenhum registro.
O agente não emite nota fiscal, não abre conta, não baixa estoque nem apaga registro. Ele apenas olha e conta. Isso significa que você pode fazer quantas perguntas quiser sem a preocupação de "será que ele estraga alguma coisa". Se receber uma resposta errada, a única perda é tempo; nada acontece com os seus dados.
1. Três abas
Conversa
Onde você pergunta e recebe respostas. Todo o uso do dia a dia acontece aqui.
Rotinas
Tarefas agendadas do tipo "toda manhã às 08:00, confira isto". Configuradas uma vez só.
Configurações
Conexão, modelo, personalidade e resumo de uso. Em geral é tarefa do administrador.
2. Conversa — fazer a pergunta certa
A tela de conversa tem a lista de sessões à esquerda, o fluxo de mensagens no meio e a caixa de entrada embaixo. Enter envia, Shift+Enter abre uma nova linha. Enquanto a resposta está sendo escrita aparece um botão Parar — você pode interromper uma resposta longa.
Pergunta boa, pergunta ruim
| Pergunta ruim | Pergunta boa | Por quê |
|---|---|---|
| "Como estão as vendas?" | "Quais são os meus 5 maiores clientes por faturamento em julho?" | Com um período e uma medida definidos, a resposta fica exata |
| "Como está o estoque?" | "Quais produtos do depósito CENTRAL estão abaixo de 10 unidades?" | Com o depósito e o limite informados, a lista já serve para agir |
| "Como está a Deniz Yapı?" | "Qual é o saldo da Deniz Yapı e quais são as três últimas notas fiscais dela?" | Você diz o que quer, e o agente não precisa adivinhar |
Enquanto o agente responde, pequenos chips aparecem: eles dizem qual dado está sendo consultado, giram enquanto ele trabalha e deixam um resumo curto ao terminar. Esses chips são o jeito de você auditar a resposta. Se um chip diz "notas fiscais de venda dos últimos 30 dias" mas você perguntou sobre o ano inteiro, é preciso afinar a pergunta.
A linha de custo no rodapé
Abaixo de cada resposta há uma linha de uso e, bem no fim da sessão, o custo total. Como o agente usa um serviço externo de inteligência artificial, cada pergunta gera um pequeno custo para a empresa. O número não é assustador, mas deixá-lo visível é proposital: você fica sabendo o que custa o quê.
3. Rotinas — um olho que confere regularmente por você
Uma rotina é uma tarefa que o agente executa em intervalos definidos sem que você peça. Exemplos:
- Toda manhã às 08:00 — listar os cheques que vencem hoje.
- Toda segunda-feira — resumir as cinco maiores notas fiscais da semana passada.
- No dia 1º do mês — gerar os produtos abaixo do nível crítico de estoque.
Você pode acrescentar e editar rotinas, desativá-las temporariamente e testar uma na hora com Executar agora. No rodapé da página há uma lista das últimas execuções: qual rotina rodou, quando e o que encontrou. É um bom hábito rodar uma rotina à mão uma vez e olhar o resultado antes de agendá-la.
Quando você acrescenta, exclui ou liga/desliga uma rotina, a lista inteira é enviada ao servidor e o agendador é remontado. Por isso duas pessoas editando rotinas ao mesmo tempo podem apagar a alteração uma da outra. Deixe uma única pessoa cuidar das rotinas.
4. A aba Configurações (para o administrador)
Um usuário comum não precisa entrar nesta aba. Ela tem seis seções:
| Seção | O que faz |
|---|---|
| Conexões | A qual serviço o agente se conecta; testado na hora com o botão Testar |
| Chaves de API e modelos | Pode-se escolher um modelo diferente para as tarefas principais e para as rotinas; a lista de modelos vem ao vivo do serviço |
| Personalidade | Como o agente deve falar — resumido ou detalhado, em qual idioma |
| Capacidades | Um inventário somente leitura do que o agente pode consultar — aqui não se liga nem se desliga nada |
| Empresa | Dados da empresa — situam as respostas do agente no seu contexto |
| Uso | Um resumo de uso e custo vindo dos próprios registros do agente |
Os campos secretos chegam do servidor mascarados (algo como sk-ant-***). Se você salvar sem tocar no campo, a máscara volta igual e o valor real no servidor é preservado — ou seja, apertar "salvar" não estraga a chave. Para trocar a chave de verdade, é preciso limpar o campo e digitar a nova. Nunca compartilhe essa chave com ninguém, nem em captura de tela.
5. Quanto se deve confiar no agente?
O agente é rápido, mas pode errar. A postura certa é: use-o como placa de sinalização, não como prova. A distinção abaixo vai te ajudar bastante:
| Pergunte ao agente | Confirme na janela |
|---|---|
| "Quais clientes estão pagando com atraso neste mês?" | O saldo real no cartão da conta, antes de emitir uma nota fiscal |
| "Em qual produto o estoque está acabando?" | O detalhamento por depósito no cartão de estoque, antes de fazer o pedido |
| "Quanto de lucro eu tive no mês passado, por alto?" | O Relatório de Resultado para declarações e decisões |
6. Perguntas frequentes
O agente manda os meus dados para fora?
Para conseguir responder à sua pergunta, ele envia ao serviço de inteligência artificial a parte pertinente do dado que consultou — isso vale para todo assistente baseado em nuvem. Por isso, não escreva ao agente informações realmente sensíveis (senhas, dados pessoais de identificação). A qual serviço ele se conecta aparece em Configurações › Conexões; se a sua empresa tem uma política própria, consulte o administrador.
A resposta veio errada — o que eu faço?
Olhe primeiro os chips: o agente consultou o dado certo? A maioria das respostas erradas é uma resposta certa para a pergunta errada. Estreite a pergunta acrescentando um período, um depósito ou um tipo de documento e pergunte de novo. Se continuar errada, confirme na janela correspondente e avise o administrador do sistema.
As minhas conversas antigas ficam guardadas?
Sim — elas ficam na lista de sessões à esquerda e vêm do servidor, então você as vê também de outro computador. A lista não se atualiza sozinha; para renová-la use F5 ou o botão de atualizar da janela.
7. Glossário
| Turco | Explicação breve |
|---|---|
| Oturum | Uma sequência de perguntas e respostas sobre um mesmo assunto |
| Çip | Uma pequena etiqueta que mostra qual dado o agente consultou |
| Rutin | Tarefa agendada, que roda sozinha |
| Koşum | Uma execução única de uma rotina e o resultado dela |
| Model | A versão do motor de inteligência artificial que produz a resposta |
| Salt-okunur | Apenas olha; não consegue alterar nenhum registro |
O botão Imprimir no canto superior direito gera uma versão adequada ao papel A4. Guias relacionados: Relatórios, Ferramentas, Configurações e Log.