Agentes de IA

Para que serve

Este módulo configura assistentes de IA e confirmações de ações. Em Pergunte à IA, você pode consultar dados, adicionar contexto de um contato, tarefa ou negócio e acompanhar as ações que a IA realizou ou deixou aguardando aprovação.

Para perguntas sobre onde fica um recurso ou como usá-lo, consulte o dicionário de uso do Koda. O Pergunte à IA usa essas informações para orientar em linguagem comum; respostas sobre dados da sua conta continuam exigindo consulta autorizada.

Como usar

Abra Pergunte à IA no menu do Koda.
Use o histórico à esquerda para retomar conversas ou inicie uma nova.
Se necessário, selecione um contato, tarefa ou negócio no painel de contexto.
Envie a solicitação e acompanhe a atividade da IA.
Revise a prévia e confirme antes de qualquer cadastro, alteração, exclusão, envio ou importação. A IA não informa sucesso enquanto a ação estiver aguardando confirmação.

Se pedir vários contatos de uma vez, o Koda mostra a lista de nomes e telefones em uma única proposta. Um botão confirma o lote inteiro; se algum contato não puder ser cadastrado, nenhum item novo desse lote é gravado.

Integrações

Em Configurar IA e integrações, administradores acompanham Apify, Google Calendar, WhatsApp, e-mail e Pipedream e liberam cada conexão para a empresa. Cada pessoa ainda escolhe quais conexões quer usar no próprio chat. Apify usa duas aprovações — uma para a busca e outra para importar resultados. O Pipedream prepara futuras conexões, mas não libera ações externas automaticamente para a IA.

As chaves e conexões de serviços usados pela IA ficam nessa mesma tela. O remetente de e-mail dos relatórios fica em Configurações > Conta > Seu perfil, junto de Relatórios automáticos.

Na parte superior de Pergunte à IA, selecione Clique aqui para conectar para vincular sua conta pessoal pelo Telegram ou WhatsApp. Esse vínculo permite conversar com o assistente interno e não altera o canal de atendimento dos clientes.

Depois de vincular a conta pelo código LINK, o bot mostra automaticamente os comandos disponíveis e os atalhos de Financeiro, Estoque e Contatos.

Use /analise no Telegram para ativar ou desativar a análise de dados por IA. Ela começa desativada para cada pessoa. Com a opção desativada, consultas diretas mostram os dados preparados pelo Koda, sem enviar registros, respostas anteriores, memórias da empresa ou arquivos à IA. O bot ainda pode usar IA para entender o texto que você escreveu, sem fornecer a ela dados consultados no sistema. Pedidos explícitos de análise solicitam a ativação.

Quando você ativa a opção e pede uma análise, o Koda consulta os dados que você pode acessar e envia à IA somente o resultado necessário daquele pedido. A resposta mostra os dados consultados junto com a análise. Respostas antigas do bot nunca são acrescentadas ao contexto da IA, mesmo se você ativar a opção depois. Arquivos enviados são salvos normalmente; a classificação da pasta e a importação com IA só acontecem com a análise ativada.

Você pode responder datas de um jeito natural: hoje, dia 1, 01/01, 01/01/2000 ou 2000-01-01. Sem ano, o bot usa o ano atual; com apenas o dia, usa o mês e o ano atuais. Datas inexistentes continuam sendo recusadas.

Ao criar uma receita ou despesa, o bot pergunta se o lançamento já foi recebido/pago ou se está pendente. Quando já foi pago, também pergunta a data do pagamento. Ele não marca um lançamento como pendente sem perguntar.

Todo documento enviado em uma conversa privada é salvo em Documentos. Com a análise ativada, uma IA pequena escolhe a pasta existente mais adequada ou cria uma nova; com ela desativada, o Koda usa uma pasta definida por regras. Se você pedir explicitamente para registrar os dados da planilha ou relatório, o bot analisa o arquivo e pode cadastrar até 50 linhas em Financeiro, Vendas, Tarefas ou Contatos, além de produtos e serviços no Estoque, respeitando suas permissões e os campos obrigatórios.

Créditos e chave própria

O plano inclui uma franquia mensal de perguntas para a IA. Quando ela termina, novas perguntas ficam bloqueadas até a ampliação do plano. Nos planos que permitem chave própria, um administrador pode configurar uma chave OpenAI ou Anthropic; ela fica protegida e não aparece novamente na tela. A contratação ou alteração de plano é tratada fora do Koda nesta versão.

Permissões e dependências

O acesso depende do módulo estar habilitado para a conta e das permissões atribuídas ao seu usuário. A interface informa quando uma dependência ou permissão é necessária.

Quando algo der errado

Confirme sua sessão, a conexão com o servidor e os campos obrigatórios. Se o problema persistir, consulte Solução de Problemas e informe o horário, a tela e a mensagem apresentada ao administrador.

Este guia descreve somente comportamentos presentes na versão instalada. Consulte o administrador antes de alterar configurações de integração ou dados em massa.