CX & Vendas
na era da IA.Plataforma Khal.
Como funciona a nossa suíte: agentes de IA vendem e atendem, e as pessoas decidem. Studio, Runtime e ADK, por dentro.
00Princípios
Agentes fazem o trabalho. Pessoas tomam a decisão.
Três ideias atravessam tudo o que vem a seguir. A operação melhora num loop em que a Khal AI analisa e sugere, e uma pessoa aprova; tudo o que acontece numa conversa é mensurável; e a suíte é pronta para enterprise, com versão, auditoria e controle remoto dos agentes.
00.01Princípios
Três camadas, um produto
O ADK constrói, o Runtime conversa, o Studio governa.
O ADK constrói
Os FDEs escrevem o agente em código, com as ferramentas, o conhecimento e os limites dele, e publicam no Runtime.
O Runtime conversa
Atende nos canais, chama as ferramentas nos sistemas do cliente e emite um evento por fala, execução e resultado.
O Studio governa
Lê os eventos, mostra a operação e devolve decisões ao Runtime: o que o agente sabe, com quem fala e até onde pode ir.
00.02Princípios
O loop agêntico
A Khal AI lê a operação, sugere a melhoria e uma pessoa aprova.
Analisar
A Khal AI lê conversas, métricas e achados, com o mesmo alcance de quem pergunta. Ela encontra a queda e o motivo antes de propor qualquer mudança.
Sugerir e construir
Cada melhoria nasce como rascunho, com versão, simulação e custo esperado. Aprovada, vira a nova versão no Runtime.
Uma pessoa aprova
Alguém do time revisa o rascunho e aprova, ou pede outro. Nada chega ao cliente sozinho, e o resultado da mudança abre a próxima volta.
00.03Princípios
Tudo é mensurável
O que foi dito, o que o agente fez, quanto levou e quanto custou: cada conversa vira dado.
O que foi dito
Cada fala do cliente e do agente fica registrada e é lida: tema, obstáculo, sinal e como a conversa terminou.
O que o agente fez
Cada ferramenta chamada, cada consulta à base e cada passagem para humano entra no mesmo registro, com o resultado.
Quanto levou e custou
Tempo de resposta, tempo até resolver e custo por conversa saem do mesmo registro. Qualquer número leva de volta às conversas que o produziram.
00.04Princípios
Pronto para enterprise
Tudo tem versão, tudo é auditável e a operação controla os agentes de onde estiver.
Tudo tem versão
Agentes, conhecimento, jornadas e limites: cada mudança é uma versão, e voltar é publicar a anterior.
Tudo é auditável
Quem mudou o quê, quando e por quê fica num registro que só cresce, junto com cada decisão dos agentes.
Controle remoto
Do Studio, a operação pausa um agente, muda um limite ou volta uma versão, e o Runtime aplica em todas as conversas na hora.
01Khal Studio
O control plane da operação de vendas e CX.
É onde a operação vê cada pessoa e cada conversa, decide com quem falar e quando, gerencia o que cada agente sabe e faz, e mede o resultado contra o custo. O Studio não conversa com ninguém: ele governa quem conversa.
01.01Studio
Contatos
Cada pessoa, todas as conversas, e a base inteira em círculos.
Uma ficha por pessoa
As identidades de cada canal se juntam numa ficha só, com todas as conversas com todos os agentes, os eventos e o resumo do que aconteceu.
A base em círculos
Agrupe por momento, classificação, último evento ou agente e veja o tamanho e a conversão de cada grupo. Cada ponto é sempre as mesmas pessoas.
Do círculo à ação
Um círculo vira o público de uma campanha ou de uma jornada. Quem aparece no círculo é quem recebe o próximo toque.
01.02Studio
Conversas
Toda conversa, com o porquê.
-
Marina A.SAC16/11
“A mensalidade subiu demais. Se baixar um pouco, eu fico.”
CancelamentoPreçoAceita contraproposta -
Carlos S.Vendas Odonto14/11
“Pensei em sair. Com um valor melhor pra família, continuo.”
RenovaçãoPreçoAceita contraproposta -
Joana L.SAC11/11
“Achei um plano mais barato. Se cobrirem a oferta, nem troco.”
CancelamentoConcorrenteAceita contraproposta
Busca por significado
Encontre a conversa pelo que a pessoa quis dizer, sem acertar a palavra que ela usou.
Temas, obstáculos e sinais
Cada conversa finalizada é lida e classificada. A leitura tem versões, então dá para saber com qual definição cada etiqueta foi dada.
O resumo
Duas ou três frases do que aconteceu, para quem pega o caso continuar de onde a conversa parou.
01.03Studio
Pontuação de leads
Quem priorizar, e por quê.
Perfil e interesse
Cada regra soma pontos até um teto. O perfil diz quem a pessoa é e fica; o interesse diz o que ela fez e cai pela metade a cada 14 dias.
Regras à vista
Cada classificação mostra as regras que a produziram e a versão do modelo que estava publicada. Uma regra desqualificadora vence a matriz.
Medida na conversão
A qualidade da pontuação é conferida contra a conversão real. Hoje, a Prioridade converte 3,4× a base.
01.04Studio
Campanhas e jornadas
Fale com a pessoa certa na hora certa, num disparo ou num acompanhamento de dias.
Disparo com contexto
Um modelo de WhatsApp aprovado ou uma ligação, para um público salvo. Em cada conversa que o disparo abre, o agente já sabe a oferta, o preço e a validade.
Acompanhamento pessoa a pessoa
Quem não converteu segue numa jornada de dias, com esperas, condições, novos toques e passagem para uma pessoa do time quando precisa.
Medido contra controle
10% sorteados na entrada não recebem nenhum toque. O ganho é a diferença entre os dois grupos, e cada toque guarda o porquê.
01.05Studio
Agentes
Cada agente num lugar só: o que ele sabe, o que ele faz e o que ele não pode fazer.
- Vendas Odontono ar · v14
- SACno ar · v9
- Agendamentono ar · v6
- Pós-vendapausado · v3
- v15agoraStudio
- v1412/11ADK
- v1306/11ADK
- v1228/10Studio
Khal AI · montando o rascunho
- Nada mudou desde a v14
- +BaseRede credenciada
- +WorkflowRetenção no cancelamento
- −ComportamentoLigar para quem não respondeu
Um lugar por agente
Canais, bases, workflows, comportamentos e limites de cada agente ficam numa página só, com a versão que está no ar. O que vem do código, como as ferramentas, muda pelo ADK.
Conhecimento e workflows
Escolha as bases que o agente consulta e construa os workflows que ele executa descrevendo o processo em português. A Khal AI monta o rascunho.
Ligar e desligar
Desligue um comportamento, como ligar de volta ou oferecer desconto, e o Runtime aplica em todas as conversas. Cada publicação é uma versão, e dá para voltar à anterior.
01.06Studio
Evolução contínua
A Khal AI melhora os agentes continuamente, e você acompanha cada passo.
27 conversas citam a taxa de adesão
Sugiro a jornada Proposta parada sem a taxa de adesão.
esperando a Khal AI construir
construindo ·
testando · 0 de 24 cenários
24 de 24 cenários ok · esperado 14,2%
aprovada por você · no ar como v14 · medindo desde hoje
A IA propõe e constrói
A Khal AI lê as conversas, acha a próxima melhoria do agente, constrói a mudança e testa com conversas simuladas antes de pedir a sua aprovação.
Você acompanha e aprova
Cada passo fica à vista no feed, da sugestão ao teste. Nada vai ao ar sem uma pessoa aprovar, e cada aprovação vira uma versão.
Cada versão, medida
O resultado de cada mudança aparece no objetivo do agente, degrau por degrau, e a próxima sugestão da Khal AI parte daí.
01.07Studio
Análises
Resultado e custo no mesmo lugar.
Métricas com versão
Contagem, soma, média, percentil e taxa, salvas com nome e definição. Mudar a definição gera uma nova versão, e o número antigo continua explicado.
Funis e jornadas
Onde as pessoas param, etapa por etapa, por agente e por canal.
Custo por resultado
Quanto custa cada venda ou atendimento resolvido, somando o agente, as mensagens e as ligações.
01.08Studio
Custos
Quanto custa cada conversa e cada resultado, por agente, canal e modelo.
- Modelo (LLM)46%
- Mensagens WhatsApp31%
- Minutos de voz19%
- Ferramentas e infraestrutura4%
Custo por resultado
Cada venda, atendimento resolvido ou consulta marcada soma o custo do modelo, das mensagens, dos minutos de voz e das ferramentas usadas para chegar até ela.
Por agente, canal e modelo
Dá para ver onde o dinheiro vai e comparar versões de um agente e modelos diferentes pelo mesmo resultado.
Orçamento e alerta
Um teto por mês e por agente, com aviso antes de estourar e a sugestão de onde economizar, que segue para a evolução contínua.
01.09Studio
Sentinela
O Sentinela lê as conversas que ninguém teria tempo de ler.
- 13:51(11) 9••••-4471SAC
- 13:52Marina A.Vendas Odonto
- 13:53(31) 9••••-0912Agendamento
- 13:54(21) 9••••-3385SAC
- 13:55(11) 9••••-7720Vendas Odonto
- 13:56(85) 9••••-1043Pós-venda
- 13:57(11) 9••••-5518Agendamento
- 13:58(41) 9••••-2867Vendas Odonto
- 13:59Rafael D.SAC
- 14:00(71) 9••••-6604SAC
- 14:01(11) 9••••-9132Pós-venda
- 14:02(51) 9••••-4250Agendamento
- 14:03(21) 9••••-8871Vendas Odonto
- 14:04(61) 9••••-3196SAC
- 14:05(81) 9••••-5027Vendas Odonto
- 14:06Joana L.Pós-venda
- 14:07(11) 9••••-7348Agendamento
- 14:08(92) 9••••-1189SAC
- 14:09(31) 9••••-6630Pós-venda
- 14:10(11) 9••••-2214Vendas Odonto
“…fica pronto em 24 horas, pode ficar tranquila.”
“…acho que até amanhã isso já está resolvido.”
“…a troca de plano sai na sexta, sem falta.”
Monitores em português
Descreva o que procurar como explicaria a um supervisor: uma promessa de prazo, um desconto fora da regra, uma reclamação sem resposta.
Julgado por IA
Cada conversa finalizada é lida contra o monitor. O achado vem com o trecho que o justifica e com o grau de certeza: confirmado ou provável.
Achado vira tarefa
Os achados aparecem em Tarefas para alguém dar ciência, com a conversa a um clique. A ciência vale para todo o workspace.
01.10Studio
Ao vivo
A operação agora, agente por agente.
- 14:33Joana L. · pediu humanoDDD 21
- 14:32Carlos S. · agendou para 19/11DDD 81
- 14:32Marina A. · pediu propostaDDD 11
- 14:31Rafael D. · respondeu à campanhaDDD 31
- 14:31(85) 9••••-1043 · iniciou conversaDDD 85
- 14:30(11) 9••••-7720 · tirou dúvidaDDD 11
- 11São Paulo31%
- 21Rio de Janeiro12%
- 81Recife9%
A fila agora
Quantas conversas estão abertas neste momento: com o agente, esperando resposta da pessoa e com alguém do time.
De onde vem
Cada conversa que chega acende o DDD de quem escreveu. A coorte do dia conta quem entrou hoje e de que região.
Modo TV
O painel da sala da operação: tela cheia, um agente por vez, atualizado a cada evento sem ninguém tocar.
02Khal Runtime
Onde os agentes rodam.
O Runtime executa os agentes que vendem e atendem: recebe a mensagem no canal, monta o contexto, chama as ferramentas nos sistemas do cliente e devolve a resposta, dentro dos limites que o Studio define. Cada cliente roda isolado, com homologação e produção.
02.01Runtime
Canais
WhatsApp, voz e web, um agente só.
Um agente, vários canais
O mesmo agente atende por texto e por voz, com as mesmas ferramentas, o mesmo conhecimento e os mesmos limites.
A conversa continua
Trocar de canal não reinicia o atendimento. Quem pediu a proposta no WhatsApp e liga à tarde fala com um agente que já sabe do pedido.
Regras de cada canal
No WhatsApp valem a janela de 24 h e os templates aprovados pela Meta. Nas ligações vale o horário de silêncio, das 21h às 8h.
02.02Runtime
Ferramentas e conectores
O agente pede, o sistema executa.
Conectores sem deploy
Cada conector é uma chamada HTTP configurada, versionada e testada em homologação antes de chegar à produção.
Parâmetros com origem
Cada parâmetro diz de onde vem: da sessão, do agente ou de uma constante. O que vem da sessão o agente não vê nem consegue trocar.
Como o agente vê
Cada ferramenta aparece para o agente como uma função com nome e descrição, e devolve só os campos que a operação escolheu.
02.03Runtime
Workflows
Regras que o agente não pula.
Procedimento em português
O cliente descreve o processo como explicaria a um atendente novo e aprova o texto de cada passo. A Khal monta o fluxo, testa em homologação e publica.
Regra, agente, pessoa
O sistema executa as regras, o agente conduz o que é conversa e a pessoa confirma. Ninguém muda a ordem dos passos.
Escrita com confirmação
Nada é gravado no sistema do cliente sem um sim explícito, pedido com uma frase fixa que o cliente aprovou.
02.04Runtime
Memória
O que ela disse no WhatsApp, ele sabe na ligação.
Por pessoa
Cada contato tem a sua memória, que vale em todas as conversas com ele. O que a pessoa disse uma vez fica guardado para a próxima.
Entre canais e agentes
O agente de vendas sabe o que o SAC ouviu, e a ligação sabe o que foi dito no WhatsApp.
Visível e corrigível
A operação vê o que o agente lembra de cada pessoa, com a conversa de origem, e pode apagar o que estiver errado.
02.05Runtime
Base de conhecimento
A base que os agentes consultam enquanto conversam: só o que está publicado, sempre com a fonte.
Só o publicado
Rascunhos e itens desativados não chegam ao agente. Ele lê a última versão publicada de cada item, e cada publicação é uma versão nova.
Com a fonte
Cada resposta guarda quais itens e quais versões usou, para quem confere a conversa depois.
A lacuna vira sugestão
A pergunta que a base não cobre vai para a curadoria no Studio, com a conversa como evidência. Uma pessoa decide o que publicar.
02.06Runtime
Tabelas
Dados sem sistema de origem, com uma ferramenta tipada para o agente.
Vendas Odonto inseriu 1 linha
Rafael D. · (11) 9••••-4410 · odonto · novo
Três finalidades
Uma tabela serve de configuração, que muda o comportamento sem mexer no prompt, de referência que nenhum sistema guarda, ou de registro do que o agente anota.
Ferramenta gerada
O esquema vira a ferramenta: o agente lê e escreve sem SQL, só vê as colunas liberadas e nunca exclui uma linha.
Aprovação na escrita
Cada escrita pode esperar uma pessoa, e tudo fica no histórico com a conversa de origem.
02.07Runtime
Guardrails
Limites que valem em toda conversa.
Teto de desconto
Acima do limite, o agente pede aprovação a uma pessoa antes de oferecer. A resposta volta para a mesma conversa.
Frequência e horário
Campanhas e jornadas somam no mesmo limite de toques e respeitam o horário de silêncio: o que cairia à noite sai de manhã.
Consentimento
Quem não aceitou o canal, ou pediu para sair, não recebe nada, de nenhum agente e de nenhuma campanha.
02.08Runtime
Passagem para humano
Quando a pessoa precisa de uma pessoa.
Gatilhos
O agente passa a conversa quando a pessoa pede, quando o valor passa de um teto, quando percebe irritação ou quando uma regra do negócio manda.
Com o contexto
Quem assume recebe o resumo e o histórico da conversa. A pessoa não precisa repetir nada do que já disse.
De volta ao agente
Resolvido o caso, a conversa volta para um agente, que segue com a pessoa no pós-venda.
02.09Runtime
Eventos e rastreio
Cada turno deixa rastro.
agendamento · v4
Por evento
Tudo o que o agente produz chega por eventos: falas, execuções e resultados. A cópia crua fica guardada antes de entrar em qualquer banco.
Só cresce
Eventos são acrescentados ao log e nunca editados. O que falha na entrega vai para uma fila de cartas mortas e pode ser reprocessado.
Execuções passo a passo
Cada chamada de ferramenta guarda o tempo, a versão e o resultado, com os dados pessoais mascarados.
02.10Runtime
Isolamento
Um cliente, uma instalação.
Instalação própria
Cada cliente tem o seu ambiente, com os seus dados e os seus segredos. Não existe banco, busca ou armazém compartilhado entre clientes.
Dados no Brasil
A infraestrutura roda na AWS em São Paulo. Conversas, eventos e documentos dos clientes ficam no país.
Homologação e produção
Toda mudança passa pela homologação do cliente antes de chegar à produção dele, e cada cliente segue na sua própria versão.
03Khal ADK
Agentes enterprise de fábrica.
O ADK é o kit em TypeScript com que a Khal constrói os agentes. Todo agente feito com ele já nasce com kill switch, logs, autorização, escrita segura e evals, e chega ao Core como uma release assinada.
03.01ADK
Construção rápida
O FDE escreve o agente em TypeScript, com o Claude Code, e o resto já vem pronto.
built-ins
- handoff.humanpassa a uma pessoa
- ask_userpergunta
- confirm_actionconfirma antes
- end_conversationencerra
em todo agente
- Kill switchpausa sem deploy
- LogsPII mascarada
- Autorizaçãoa cada chamada
- Evalsem todo PR
Só o que é do negócio
O FDE escreve o comportamento: canais, modelo, conhecimento, ferramentas e objetivo. O turno, os logs e os controles vêm do kit.
Com o Claude Code
O agente nasce no GitHub da Khal, em TypeScript sobre o Vercel AI SDK, com o Claude Code ao lado sugerindo o próximo trecho.
Built-ins prontos
Passar para uma pessoa, perguntar, confirmar uma ação e encerrar a conversa já existem em todo agente.
03.02ADK
Kill switch
Pausar um agente, uma capacidade ou uma tool leva segundos e não pede deploy.
Três níveis
A operação pausa uma tool, uma capacidade ou o agente inteiro, sem tocar no código.
Sem deploy
O comando desce assinado pelo canal de controle, e o agente lê do cache local no próximo turno. Uma conversa que pediria a ação pausada passa para uma pessoa.
Confirmado
O Core devolve a versão aplicada, e o Studio mostra quando cada cliente convergiu.
03.03ADK
Logs e eventos
Cada turno deixa um registro completo, com os dados pessoais mascarados antes de sair do agente.
Tudo correlacionado
Cada evento leva a conversa, o turno, a release e o dado de negócio, como o agendamento que o turno criou.
PII mascarada na saída
O dado pessoal em claro fica no Core. O log já sai mascarado: o CPF vira um hash e o telefone, os quatro últimos dígitos.
Nada se perde
Os eventos ficam num spool local e são reenviados se a rede cair. O turno não espera a telemetria, e auditoria e custo só confirmam depois de gravados.
03.04ADK
O turno
Seis passos, os mesmos em todo agente, com os controles já no lugar.
Igual em todo agente
O FDE escreve o comportamento. A ordem dos passos, os controles e a medida de cada um vêm do kit, iguais no Agendamento, no Vendas Odonto e no SAC.
Controle antes de agir
A pausa é conferida na entrada, no cache local. Cada chamada de tool é autorizada no próprio Core antes de chegar a qualquer sistema.
O modelo só age por tools
O modelo não chama nenhum sistema direto. Ele pede uma tool, o PDP autoriza e o Enterprise Gateway executa na API do cliente.
03.05ADK
Troca de modelo
Trocar de modelo é uma mudança na release, sem tocar no código.
ModelPort
O agente fala com uma porta de modelo, sobre o Vercel AI SDK. Qual modelo atende como principal e qual como reserva fica declarado na release.
Fallback declarado
Se o modelo principal cair, o turno segue no reserva e quem está na conversa recebe a resposta normalmente. Sem reserva declarado, o agente manda uma mensagem segura e passa para uma pessoa.
Testado como qualquer mudança
A troca roda os mesmos evals da release anterior e ganha tráfego aos poucos no canary, de 10% a 50% e depois para todos.
03.06ADK
Escrita segura
Uma escrita com resultado incerto é conferida no sistema antes de qualquer nova tentativa.
Ledger de escritas
Toda escrita com efeito no mundo fica registrada com a chave de idempotência, o estado e o resultado, como o appointment_id.
Reconciliar, nunca repetir
Se a resposta não chega, o agente consulta o sistema antes de tentar de novo. Com a mesma chave, a consulta nunca é marcada duas vezes.
Confirmação com a pessoa
Escritas sensíveis passam por confirm_action: o agente pergunta e só executa depois de um sim.
03.07ADK
Ferramentas governadas
O modelo só alcança os sistemas da empresa por tools aprovadas, e cada chamada é autorizada na hora.
Só tools aprovadas
O modelo só alcança o mundo por tools. As de cada agente saem do catálogo aprovado e ficam fixadas na release, com rota, efeito e contrato de retorno.
Autorizado na hora
O Cedar decide cada chamada no próprio Core, pelo agente e pelo titular da conversa, com fatos que vêm do sistema, nunca do modelo. A negada vira erro estruturado e evento de segurança.
Retorno conferido
O gateway executa com a credencial guardada no cofre do tenant. Se a resposta da API foge do contrato, o resultado é bloqueado e o agente passa para uma pessoa.
03.08ADK
Funciona sem o Studio
O agente nunca depende do Studio para responder.
Fora do caminho da mensagem
O Studio publica o estado e o agente lê do cache local, a cada turno. Nenhuma resposta passa pelo Studio.
Último estado assinado
Sem o Studio, valem as regras que já estavam assinadas, inclusive as pausas. O Core segue assim por até 72 horas, e as mudanças esperam a volta.
Volta e converge
Quando o Studio volta, o Core reconcilia pelo pull a cada 15 segundos e confirma a versão aplicada.
03.09ADK
Evals em todo PR
Cada mudança no agente passa por testes, evals e segurança antes de virar release.
Pessoas simuladas
Cenários escritos em português viram conversas completas contra o agente, turno a turno, com o resultado de cada avaliação.
Bloqueia o PR
Uma regressão de qualidade ou de segurança impede a release, como um teste vermelho. O FDE corrige e o próximo push roda tudo de novo.
Segurança do agente
Tentativas de sair do escopo, vazar dado ou acessar outro titular rodam em todo PR, junto com os evals.
03.10ADK
Release assinada
O agente chega ao Core como uma release imutável, e o Studio decide quando ela vale.
Imutável e assinada
O PR aprovado vira um pacote com digest e assinatura, publicado no registry da Khal. O Core só roda o pacote cuja assinatura confere.
Canary pelo Studio
A release ganha tráfego aos poucos, de 10% a 100%. A anterior continua no registry, e voltar para ela é um clique.
Pedido vira PR
O cliente pede a mudança no Studio, sem tocar no repositório. Ela vira código revisado, passa pelos evals e volta como release.
Uma suíte, três camadas.
Studio, Runtime e ADK são um produto só. O ADK constrói, o Runtime conversa, o Studio governa, e cada conversa volta como dado para a próxima decisão.
- StudioO control plane da operação de vendas e CX.
- RuntimeOnde os agentes rodam, com os limites que o Studio define.
- ADKO kit para construir agentes enterprise, em código.