Conhecendo o Eddie

Por Fabrício Rissetto and 4 outros

• 6 artigos

O que é o Eddie e como ele se diferencia da ClaudIA

Quando usar - Você é novo na plataforma Cloud Humans e quer entender o que o Eddie faz - Você precisa explicar para alguém a diferença entre ClaudIA e Eddie - Você está avaliando se um determinado caso de uso deve virar conteúdo da ClaudIA ou fluxo Eddie Pré-requisitos - Acesso ao Hub (plataforma de configuração da Cloud Humans) ou conhecimento básico do produto Sobre este artigo A Cloud Humans tem dois agentes complementares trabalhando em conjunto: a ClaudIA, focada em respostas baseadas em conteúdo, e o Eddie, focado em interações dinâmicas com sistemas externos. Este artigo explica a diferença entre eles e introduz as capacidades principais do Eddie. Detalhes Diferença entre ClaudIA e Eddie A ClaudIA é um agente de IA focado em respostas baseadas em conteúdo pré-fornecido — você abastece a base de conhecimento e ela responde. O Eddie, por outro lado, é um agente interativo que acessa o backoffice via API ou Google Sheets para recuperar ou modificar dados dinâmicos, resolvendo consultas complexas sem escalonamento manual. :::info Exemplos de casos Eddie: - Verificar status de pedido em tempo real - Alterar e-mail cadastrado do cliente - Realizar redefinição de senha automática - Consultar plano contratado para tomar decisão de roteamento ::: Capacidades principais do Eddie Visualização — recupera dados em tempo real Exemplo: Cliente pergunta "Qual o status do meu pedido?" → Eddie consulta o backoffice e responde diretamente. Edição — modifica informações no sistema Exemplo: Cliente solicita "Mude meu e-mail" → Eddie atualiza no sistema e confirma. Funcionamento básico O Eddie usa uma árvore de decisão ("se isso, então aquilo") para guiar as interações. Ele é acionado por seções específicas da ClaudIA que estão marcadas como interativas, processa as entradas, executa os passos lógicos do fluxo e gera saídas personalizadas. Exemplo de um Eddie construído Exemplo de um Eddie construído Observações - Para entender o fluxo entre ClaudIA e Eddie: Como funciona a interação ClaudIA e Eddie - Para criar seu primeiro Eddie do zero: Como lançar um novo Eddie passo a passo - Para conhecer as funcionalidades e botões da plataforma: Como usar as funcionalidades e botões básicos do Eddie

Última atualização em May 21, 2026

Como funciona a interação entre ClaudIA e Eddie

Quando usar - Você quer entender como ClaudIA decide acionar o Eddie - Você precisa diagnosticar por que um Eddie não está sendo chamado mesmo com a seção interativa configurada - Você quer entender as opções de finalização de um fluxo Eddie (End Flow, Forward to Human etc.) Pré-requisitos - Conhecimento básico do que é ClaudIA e do que é Eddie — ver O que é o Eddie Sobre este artigo Este artigo descreve em detalhes o fluxograma cliente → ClaudIA → Eddie: como a mensagem do cliente é interpretada, em que momento o Eddie é acionado, e como o fluxo termina. Fluxograma ClaudIA-Eddie Passo a passo Etapa 1 — Cliente envia a mensagem O cliente inicia o contato enviando uma mensagem para a ClaudIA. A mensagem pode ser uma simples dúvida, uma consulta sobre o status de um pedido, ou uma pergunta mais específica que requer um fluxo automatizado. Etapa 2 — ClaudIA interpreta a mensagem Ao receber a mensagem, a ClaudIA — alimentada por um modelo GPT — começa a processar o conteúdo. O modelo realiza uma análise linguística profunda para entender a intenção do cliente, o contexto da mensagem e identificar as entidades importantes. Etapa 3 — ClaudIA classifica o tipo de conteúdo Com a mensagem processada, a ClaudIA verifica qual é o tipo de resposta necessário: - Conteúdo N1 — se a mensagem for simples e direta, a ClaudIA responde automaticamente com uma resposta da base de conhecimento. - Conteúdo N2 — se a questão for mais complexa ou precisar de um atendimento humano, a ClaudIA transfere a conversa para a equipe N2. - Conteúdo Interativo — se a questão envolve consulta complexa (status de pedido, dados via API, integração com Google Sheets), a ClaudIA aciona o fluxo do Eddie. Etapa 4 — Eddie executa o fluxo (Conteúdo Interativo) Quando o conteúdo é interativo, a ClaudIA aciona o fluxo do Eddie. Esse fluxo pode incluir: - Consultas externas — API, Google Sheets, prompt LLM, fluxos de árvore, scripts JavaScript - Geração de resposta — a resposta gerada pelo Eddie é então enviada ao cliente Etapa 5 — Finalização do fluxo Após a execução do fluxo do Eddie, o atendimento pode seguir de diferentes maneiras: End Flow [N1] — retorna para a ClaudIA Se o fluxo foi configurado para retornar à ClaudIA, ela continua o atendimento. End Flow Forward to Human [N2] — escalado para humano Se configurado, a conversa é escalada para a equipe N2 para um atendimento mais aprofundado. Forward to Human :::info Existem outras formas de finalização (Answer Ticket e Close Ticket) — veja todas em Como lançar um novo Eddie passo a passo, seção "Estratégia de finalização". ::: Observações - Para criar seu primeiro Eddie do zero: Como lançar um novo Eddie passo a passo - Para entender o que cada botão da plataforma faz: Como usar as funcionalidades e botões básicos do Eddie - Para diferenciar as terminações de fluxo: Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket

Última atualização em May 21, 2026

Como lançar um novo Eddie passo a passo

Quando usar - Você precisa criar um novo fluxo Eddie do zero (status de pedido, reset de senha, validação de plano etc.) - Você quer entender o caminho completo: do desenho até o teste em produção - Você precisa relembrar a estratégia correta de finalização (End Flow, Answer Ticket, Forward to Human, Close Ticket) Pré-requisitos - Workspace no Eddie criado para você (ainda não é criado por padrão — solicite ao time Cloud Humans) - Acesso ao Hub do projeto ClaudIA correspondente - Saber qual a fonte de dados que o Eddie vai consultar (API ou Google Sheets) Sobre este artigo Este guia cobre todas as etapas de criação de um novo Eddie: desde a definição do objetivo, passando pelo rascunho do fluxo, setup no builder, vinculação à ClaudIA, e finalmente os testes. Use-o como checklist ao construir um Eddie do zero. Passo a passo Etapa 1 — Entender qual fluxo será construído O primeiro passo para lançar um novo Eddie é definir o objetivo. Será um Eddie que comunica o status do pedido? Que verifica o plano do cliente? Que exclui a conta do usuário? Para isso, identifique quais perguntas dos usuários devem acionar o novo Eddie, como nos exemplos: - "Onde está meu pedido?" → Eddie de status de pedido - "Esqueci a minha senha" → Eddie de reset de senha - "Minha conta está bloqueada" → Eddie de desbloqueio de conta - Validação de informação no início do atendimento → Eddie inicial de validação Etapa 2 — Desenhar o rascunho do fluxo Recomendamos usar o Miro ou outra ferramenta de "White Board" para fazer o rascunho de cada etapa (uma espécie de fluxograma simplificado). Você precisa entender: - A pergunta que o cliente fará para acionar este Eddie Exemplo: "Onde está o meu pedido?" - As variáveis que devem ser mapeadas Exemplo: campo de ID do pedido do cliente - As fontes de dados que serão utilizadas pelo Eddie Exemplo: Google Sheets ou API - As respostas que devem ser fornecidas ao cliente com base nas variáveis e nas consultas Exemplo: "O status do seu pedido é {{statusPedido}}" Etapa 3 — Configurar o fluxo no Eddie Siga os passos abaixo no builder visual: 1. Solicite a criação de um workspace no Eddie (se ainda não tiver) 2. Dentro do workspace, clique em Create a typebot para cada novo fluxo 3. Selecione Start from scratch 4. Inicie a construção do Eddie :::info Para detalhes completos da construção, veja: - Como criar um fluxo no Eddie com API externa - Como criar um fluxo no Eddie acessando informações em um Google Sheets ::: Etapa 4 — Vincular o fluxo à ClaudIA (seção INTERATIVA) Para garantir que o Eddie seja ativado pela ClaudIA: 1. Não use textos genéricos na "response" da seção. Ela deve ser específica para o caso, sem se repetir em outras seções — isso otimiza o acionamento do Eddie - Adequado (response específico): - Inadequado (genérico): 2. Marque o Type da seção como INTERACTIVE (essa opção só fica disponível após o setup no Eddie) 3. Selecione o Flow ID do fluxo Eddie correspondente :::success Pronto! Sua seção interativa está configurada. Você pode testar o comportamento integrado no Playground do Hub. ::: Etapa 5 — Revisar a estratégia de finalização Cada terminação tem um propósito diferente — escolha com cuidado: End Flow [N1] Quando este card é utilizado, o fluxo é encerrado e o atendimento é passado para a ClaudIA. A bubble de texto configurada antes do End Flow é enviada para o cliente, e a ClaudIA continua o atendimento a partir dali. Por isso, é ideal incluir na bubble algo como "como posso te ajudar?" ou "qual é a sua dúvida?" para que o cliente possa dar continuidade. Não há aproveitamento do contexto anterior da conversa nesse modo. Ideal para Eddies ativados a partir de uma seção específica da ClaudIA. Answer Ticket [N1] Quando este card é utilizado, a ClaudIA aproveita o contexto anterior da conversa para continuar o atendimento. Antes do Answer Ticket ser acionado, o cliente já pode ter mandado uma mensagem (um "oi" inicial, alguma dúvida) — a ClaudIA usa esse histórico. :::warning A bubble de texto colocada antes do Answer Ticket não é enviada para o cliente. Ela é consumida pela ClaudIA como contexto interno. Por isso, não escreva uma pergunta nessa bubble — escreva contexto. É obrigatório haver uma bubble de texto antes do Answer Ticket com algum conteúdo escrito. Sem isso, o funcionamento pode quebrar. ::: Ideal para casos em que o Eddie inicia o atendimento. Close Ticket [N1] Encerra o ticket em N1. Se o cliente enviar nova mensagem, um novo ticket será aberto. Forward to Human [N2] Encerra o ticket pela ClaudIA e transfere para um agente do cliente (escalado N2). :::warning Cuidados importantes: 1. Preencha o campo Topic apenas se a ClaudIA possuir seções com diferentes topics (multiprompt) 2. Sempre coloque uma bubble de texto antes do card Forward to Human [N2] ::: Etapa Final — Testar o Eddie criado Antes de substituir uma seção importante em produção, teste o Eddie de três formas distintas: 1. Pelo próprio workspace do Eddie Use o botão Test no canto superior direito da página. Test no workspace :::info Tem limitações — não considera todas as integrações com a ClaudIA (ex: variável helpdeskId não está disponível). Mas é o jeito mais rápido de iterar. ::: 2. Pelo Playground do Hub Crie uma seção na base de conteúdo da ClaudIA que acione o Eddie. Como o teste roda em produção, use um título improvável de ser usado por usuários reais — por exemplo: "Teste Eddie - como eu faço uma poção polissuco com uma batedeira?". Com a seção criada, envie a mensagem do título no playground. 3. Pelo canal oficial Crie a mesma seção e envie a mensagem pelo canal real (WhatsApp, e-mail, widget). Útil para testar fluxos com validação por helpdeskId, que só funciona no canal real. Observações - Para construir o fluxo via API: Como criar um fluxo no Eddie com API externa - Para construir o fluxo via Google Sheets: Como criar um fluxo no Eddie acessando informações em um Google Sheets - Para entender em detalhes cada terminação: Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket - Para usar todos os botões da plataforma: Como usar as funcionalidades e botões básicos do Eddie

Última atualização em May 21, 2026

Como usar as funcionalidades e botões básicos do Eddie

Quando usar - Você está construindo seu primeiro fluxo Eddie e precisa entender o que cada bloco faz - Você quer aprender quais blocos usar para coletar dados, tomar decisões, integrar com sistemas externos - Você quer um guia de referência rápida dos botões disponíveis no builder Pré-requisitos - Workspace no Eddie criado - Conhecimento básico de fluxos conversacionais — ver Como funciona a interação ClaudIA e Eddie Sobre este artigo Bem-vindo(a) ao guia definitivo sobre como construir fluxos com o Eddie, o builder visual do Cloud Chat. Aqui você vai entender o que cada botão faz, quando usar e como configurar — com exemplos práticos para decidir o melhor caminho para o seu caso. Como funciona um fluxo Um fluxo é como uma conversa guiada, com começo, meio e fim: - Ele pode começar com uma mensagem (ex: "Olá! Em que posso te ajudar?") - O cliente responde (ex: "Quero saber o status do meu pedido") - O Eddie entende e decide o que fazer com essa informação - E segue adiante: buscando dados, encaminhando, ou finalizando a conversa :::info Cada etapa é um bloco, e você pode ligar blocos como quem monta um quebra-cabeça. ::: Tipos de blocos disponíveis Blocos do Eddie Bubbles (Mensagens) Text — enviar mensagem ao cliente - O que faz: Envia uma mensagem visível ao cliente - Quando usar: Sempre que quiser exibir uma informação, confirmação, aviso ou instrução - Como usar: Arraste o bloco para o fluxo, escreva sua mensagem no campo Text e pronto - Exemplo: "Olá! Preencha o formulário a seguir para prosseguir com sua solicitação." Inputs (Coleta de dados) Text — coletar dado digitado - O que faz: Coleta dados digitados pelo usuário (nome, código, número do pedido etc.) - Quando usar: Para obter o número do pedido, CPF, e-mail, ou qualquer outro dado - Como usar: Posicione o bloco no fluxo, escreva a pergunta e defina a variável que vai armazenar a resposta - Exemplo: "Qual o número do seu pedido?" → armazena como numero_pedido Logic (Lógica) Aqui começam as decisões do fluxo — como num "se isso, então aquilo". Set Variable — definir variável - O que faz: Cria ou atualiza uma variável (uma "caixinha" onde você guarda um valor para reutilizar depois) - Por que é útil: - Reutilização — define uma vez, usa em vários lugares - Organização — deixa o fluxo mais limpo - Automação — guarda resultado de cálculos, integrações ou inputs - Tomada de decisão — pode ser usada em condições - Como usar: 1. Arraste o bloco Set Variable 2. Escolha uma variável existente ou crie uma nova (ex: tipo_usuario) 3. Atribua um valor manual ou vindo de outro ponto do fluxo - Exemplos: status_fluxo = "aguardando_validação" · desconto = 0.15 Condition — bifurcar o fluxo - O que faz: Verifica uma condição lógica (ex: status == "aprovado") e direciona o fluxo - Como usar: 1. Arraste o bloco Condition 2. Escolha a variável a ser testada 3. Defina o valor a ser comparado 4. Configure os caminhos Sim e Não - Exemplo: Se cliente_tipo == "vip" → mostrar mensagem personalizada; senão → fluxo padrão Script — rodar JavaScript - O que faz: Permite rodar código JavaScript dentro do fluxo (cálculos, formatações, lógica avançada) - Como usar: 1. Arraste o bloco Script 2. Insira o código JS 3. Defina variáveis de entrada e saída - Exemplo: Calcular dias entre duas datas, ou formatar um CPF com pontos Atalhos e organização Jump — saltar para outra parte do fluxo - O que faz: Faz o fluxo "saltar" para outra parte sem passar pelos blocos intermediários - Quando usar: Reaproveitar partes do fluxo · loops · pular etapas com base em condição - Exemplo: Se tipo_usuario == "interno" → pule direto para o bloco Encerrar Typebot — embutir outro fluxo - O que faz: Permite encaixar um fluxo dentro de outro (modularização) - Quando usar: Reaproveitar fluxo genérico (ex: validação de CPF) em vários fluxos diferentes Integrações ClaudIA - O que faz: Conecta o fluxo Eddie de volta à ClaudIA. Permite: - Transferir conversa para N1 ou N2 - Encerrar a conversa - Alterar o tópico ou contexto do atendimento - Como usar: Arraste o bloco e defina a interação desejada HTTP Request - O que faz: Permite que o Eddie se conecte com APIs externas (GET, POST etc.) - Como usar: Configure método, URL, headers e corpo da requisição. Use variáveis para enviar e receber dados - Exemplo: Buscar status de pedido no ERP do cliente Google Sheets - O que faz: Integra com Google Sheets para ler ou escrever dados em planilhas - Como usar: Conecte sua conta Google, escolha a planilha e defina a operação - Exemplo: Verificar se o CPF do usuário está em uma lista · Salvar dados preenchidos no atendimento OpenAI / Anthropic - O que faz: Permite enviar prompts para GPT ou Claude e usar a resposta no fluxo - Como usar: Conecte ao serviço, configure prompts e parâmetros - Exemplo: Resumo de explicação técnica · Geração de respostas em linguagem natural · Validação se o cliente escreveu opção 1, 2 ou 3 Cal.com - O que faz: Permite agendar reuniões diretamente pelo fluxo - Como usar: Conecte sua conta Cal.com e configure tipo de reunião e horários Email - O que faz: Envia e-mails automáticos dentro do fluxo - Como usar: Configure destinatário, assunto e conteúdo - Exemplo: Resumo da conversa · link de contrato Make / Zapier - O que faz: Conecta o Eddie com plataformas externas via automações prontas - Como usar: Conecte sua conta da plataforma e defina a automação - Exemplo: Disparar automação no CRM · atualizar base de leads Como montar seu primeiro fluxo do zero Exemplo: "Quero saber o status do meu pedido" 1. Mensagem inicial (Text): "Olá! Posso te ajudar a consultar o status do seu pedido." 2. Pergunta (Input): "Qual o número do seu pedido?" → guarde como numero_pedido 3. Condição (Condition): se o número estiver preenchido, vá para o próximo passo 4. Integração (HTTP Request): consulte API ou planilha com o número informado 5. Mensagem final (Text): "O status do seu pedido é: {{status_pedido}}." Boas práticas :::success 1. Use nomes claros para as variáveis (nome_cliente, tipo_plano, resposta_email) 2. Pense como um roteiro — o que você diria conversando com o cliente? 3. Teste no Playground sempre que terminar um trecho 4. Comece simples — você pode ir melhorando aos poucos 5. Se tiver dúvidas, pense: "o que eu quero que aconteça depois disso?" ::: Observações - Para o passo a passo de criar um Eddie do zero: Como lançar um novo Eddie passo a passo - Para fluxo com API externa: Como criar um fluxo no Eddie com API externa - Para fluxo com Google Sheets: Como criar um fluxo no Eddie acessando informações em um Google Sheets - Para evitar erros comuns: Como identificar e evitar falhas nos fluxos e requisições do Eddie

Última atualização em May 21, 2026

Como funciona a edição colaborativa no Eddie

Quando usar - Você está editando um fluxo Eddie e outra pessoa também precisa editar - Você abriu o Eddie e viu "SOMENTE LEITURA" — quer entender por quê - Você precisa passar o controle de edição para outro membro do time Pré-requisitos - Acesso ao workspace Eddie do projeto - Estar com o fluxo aberto na plataforma Sobre este artigo O Eddie utiliza um sistema de fila para organizar múltiplos usuários no mesmo fluxo. Apenas um usuário por vez pode editar (modo Editor); os demais ficam em modo Somente Leitura, acompanhando em tempo real. Quando o editor sai ou é removido por inatividade, o próximo da fila assume a edição automaticamente. Detalhes Quem pode editar um fluxo? A ordem é definida pela chegada: 1. O primeiro usuário que abre o fluxo torna-se o Editor 2. Os demais entram automaticamente na fila de espera 3. Quando o editor atual sai, o próximo da fila recebe o controle Quais são os modos de acesso? - Modo Edição — você pode arrastar blocos, alterar configurações e publicar alterações normalmente - Modo Somente Leitura — você pode visualizar todo o fluxo e até testá-lo, mas não pode editar Como sei em qual modo estou? A interface mostra indicadores claros: Modo Edição Aparece a barra lateral com blocos disponíveis e o botão Publicar: Modo Edição Modo Somente Leitura Aparece o aviso SOMENTE LEITURA na parte superior: Modo Somente Leitura Indicador de usuários conectados O ícone de usuários (👥) mostra quantas pessoas estão acessando o fluxo. Passando o mouse, você vê: - O Editor em destaque (negrito) - Os demais usuários em modo de visualização O que acontece se eu ficar inativo? Para evitar bloqueios: - O Eddie monitora sua atividade - Se você ficar ~10 minutos inativo, perde a posição de edição - O próximo usuário na fila assume o modo Editor :::warning Se você não tiver publicado as alterações antes dos 10 minutos de inatividade, suas mudanças podem ser perdidas. Sempre clique em Publicar antes de sair. ::: Como passo a vez para outro usuário? Para liberar a edição: 1. Salve suas alterações (Publicar) 2. Saia do fluxo 3. O próximo na fila ganha automaticamente acesso à edição Posso duplicar um fluxo para editar separadamente? Sim. Se não quiser esperar na fila para testar uma alteração, clique em Duplicar para criar sua própria cópia editável. Duplicar fluxo Minhas alterações são perdidas quando outro assume? Somente se você ficar inativo após os 10 minutos e não tiver publicado as alterações. Observações - Para entender o histórico de mudanças e versionamento: Histórico de Alterações no Eddie (em construção) - Para usar todos os botões da plataforma: Como usar as funcionalidades e botões básicos do Eddie

Última atualização em May 21, 2026

Como funciona o Detector de Atendimentos Ruins (rotina diária da Agêntica)

Quando usar - Você quer entender o que é a rotina diária de monitoramento da Agêntica e como ela complementa os detectores existentes - Você precisa acessar a amostra do dia para revisar atendimentos suspeitos de um projeto - Você quer rodar o detector manualmente (fora do horário automatizado) para um projeto específico Pré-requisitos - Acesso ao repositório claudia-cloudhumans/agentic-view no GitHub - Acesso ao Metabase para cruzar cloudchatid → helpdeskid - (Opcional) Acesso ao Claude para invocar a skill bad-interaction-detector manualmente Sobre este artigo O Detector de Atendimentos Ruins é uma rotina automatizada que aplica diariamente uma biblioteca de 11 padrões de comportamento problemático sobre as conversas AgenticResponse de todos os projetos ClaudIA ativos, gera uma amostra estatisticamente significativa dos atendimentos suspeitos e disponibiliza no GitHub para revisão humana. Para que serve Muitos atendimentos ruins acontecem sem o cliente perceber — a IA inventa dados, vaza prompt, executa ação errada, mas a conversa parece tranquila. Esta rotina foi calibrada para pegar exatamente esse tipo de problema silencioso, complementando os detectores que já existem. Como funciona Todo dia útil às 09h BRT (12h UTC), o GitHub Actions: 1. Descobre projetos ativos — roda no Metabase para identificar todos os projetos com ≥5 conversas AgenticResponse nas últimas 24h 2. Aplica a biblioteca de padrões — nas últimas 12h de cada projeto, roda regex e heurísticas para identificar conversas problemáticas 3. Calcula amostra por projeto — usa fórmula estatística com correção para população finita (80% confiança, 8% margem) 4. Sorteia aleatoriamente os flaggeados (com seed fixa para reprodutibilidade) 5. Commita o JSON em agentic-view/data/YYYY-MM-DD.json Biblioteca de 11 padrões | # | Categoria | O que detecta | | --- | --- | --- | | 1 | Vazamento de prompt/persona/raciocínio | Gírias da persona, placeholders [RAZAO_X], markdown vazando, meta-instruções | | 2 | Alucinação / dados inventados | CNPJ placeholder (12.345.678/0001-95), IDs falsos | | 3 | Inconsistência / contradição interna | "reativado com sucesso" + "ainda vencido" na mesma conversa | | 4 | Execução incorreta de regra de negócio | Oferta proibida, R$ 0,00 sendo processado, bônus já usado | | 5 | Fluxo conversacional quebrado | Escalação prematura (≤3 prompts), loops de busca, excesso de prompts sem resolução | | 6 | Problemas de UX / formatação | "R$ R$" duplicado, menu de 1 opção | | 7 | Admissão explícita de falha | "não consegui localizar", "sistema retorna erro" | | 8 | Oferta de ação não-autorizada | "lançamento manual", "vou te enviar por e-mail", "vou te ligar" | | 9 | Cross-contamination entre clientes/turnos | Nome/telefone muda inexplicavelmente (monitoramento manual) | | 10 | Resposta sem uso de base de conhecimento (hub bypass) | response_usedsection_id IS NULL em prompts factuais | | 11 | Reset / perda de contexto mid-flow | IA se re-apresenta no meio da conversa, mudança de persona, mix de engines | Configuração | Parâmetro | Valor | | --- | --- | | Frequência | Seg–sex às 09h BRT | | Critério de projeto ativo | ≥5 conversas Agentic nas últimas 24h | | Janela de análise | Últimas 12h | | Filtro response_class | AgenticResponse (categorias 1–10); todas as classes para categoria 11 | | Tamanho da amostra | 80% confiança / 8% margem (~64 max por projeto) | | Seed aleatório | 42 (fixo) | Como acessar os dados Repositório claudia-cloudhumans/agentic-view — toda execução fica versionada em data/YYYY-MM-DD.json. Formato do JSON { "run_date": "2026-04-24", "config": { "window_hours": 12, "confidence": 0.80, "margin_of_error": 0.08 }, "totals": { "active_projects": 11, "total_flaggeados": 263, "total_amostra": 177 }, "projects": [ { "projectname": "cayena", "conversas_agentic_24h": 282, "flaggeados": 69, "amostra_n": 34, "amostra": [ { "cloudchatid": "04221f71-...", "categorias": "5_quick_escalate" } ] } ] } Como abrir uma conversa flaggeada O cloudchatid é o ID interno da Cloud Humans. Para abrir no CloudChat ou Unthread: 1. Pegue o cloudchatid no JSON 2. Cruze no Metabase (public.conversation) para obter o helpdeskid 3. Abra no helpdesk do cliente (CloudChat / Zendesk / etc.) Como invocar manualmente via Claude A skill bad-interaction-detector está disponível no Claude e responde a: - "rodar o detector de atendimentos ruins" - "amostra de bad interactions" - "gerar amostra para revisão de IA" - "quais projetos estão com problemas de comportamento" :::info Útil quando você quer rodar fora do horário automatizado ou para um projeto específico. ::: Como interpretar os resultados Por categoria - Categorias 1, 2, 3, 4, 6, 8, 11 — alta confiança; quando bate, quase sempre é problema real - Categoria 5 (fluxo quebrado) — heurística estrutural; pode ter falso positivo (cliente pediu humano direto, por exemplo) - Categoria 7 (admissão de falha) — alta confiança, mas pode ser caso legítimo onde a IA não tinha acesso ao dado - Categoria 10 (hub bypass) — alta confiança quando o tema é factual (políticas, prazos) Cruzando com outros sinais :::success Um ticket flaggeado + com frustration=CALM + com CSAT≥4 é o caso mais valioso: bug de comportamento que passa despercebido pelos detectores existentes. ::: Limitações conhecidas :::warning - Categoria 9 (cross-contamination) não é detectável via SQL regex — está documentada mas roda como monitoramento manual - Falhas de tool-calling (tag não atribuída, custom field não preenchido) não são detectadas — exigem cruzamento com o helpdesk - A amostra é aleatória, não priorizada por gravidade. Se quiser revisar os mais graves primeiro, ordene por número de categorias hit - Heurísticas estruturais (5_quick_escalate, 5_excess_no_resolve) podem ter falso positivo em projetos onde clientes pedem humano direto com frequência ::: Histórico A biblioteca foi consolidada empiricamente em abril/2026, partindo da análise de tickets reportados como ruins no crmbonusgiftback, com extensões iterativas a partir de validação nos projetos reise (que revelou o padrão hub bypass) e cayena (que revelou o padrão reset de contexto). Observações - Para o repositório com os dados: claudia-cloudhumans/agentic-view - Para entender as terminações de fluxo (relevante para análise da categoria 5): Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket - Para boas práticas de fluxos que evitam alguns dos padrões detectados: Como identificar e evitar falhas nos fluxos e requisições do Eddie

Última atualização em May 21, 2026