CX & Vendas na era da IAPlataforma Khal

Falar com a Khal

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.

Começar pelos princípios

Teaser · 1 minDo agente escrito no ADK à melhoria aprovada no Studio.

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.

ADK agente.ts FDE escreve RUNTIME ferramentas conhecimento memória agente limite atualizado STUDIO contatos conversas análises sentinela a operação aprova publica eventos decisões whatsapp voz web clientes

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 sugerir aprovar construir você Khal AI volta 4 analisar jornada “Proposta parada” · conversão meta 14% 14,2% −2,1 p.p. desde 14,2% 41 conversas citam “preço” 30 dias 27 citam “taxa de adesão” obstáculo nº 1 sugerir rascunho jornada/proposta-parada v4 sem taxa de adesão simulação +2,1 p.p. R$ 0,38 por objetivo aprovar rascunho v4 esperando revisão você aprovou a v4 construir publicado v4 no Runtime analisar medindo a v4 · volta 5

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.

eventos dos agentes studio message run identify track status heartbeat contatos conversas análises sentinela um registro 48.201 eventos hoje operação = f(eventos) conversão 12,1% = 83 de 687 conversas

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.

studio · controle Agente SAC no ar Limite de desconto todos os agentes 15% → 15% Proposta parada jornada · v4 no ar voltar para v3 pausar limite versão runtime · produção 3 no ar SAC desconto 15% no ar Agendamento desconto 15% no ar Vendas Odonto desconto 15% · jornada v4 no ar publica registra versões · proposta parada v1 v2 v3 v4 02/09 30/09 21/10 16/11 guardada no ar auditoria imutável · quem, o quê, quando, por quê 16/11 17:05 Khal AI sugeriu Proposta parada v4 motivo: conversão 12,1%, meta 14% 16/11 18:22 você publicou Proposta parada v4 motivo: simulação +2,1 p.p. 17/11 14:02 Paula pausou o agente SAC motivo: fila de reclamações 17/11 14:05 você limite de desconto 15% → 10% motivo: política de novembro 17/11 14:09 você Proposta parada v4 → v3 motivo: revisão jurídica

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.

Contatos 14.236 pessoas
TabelaCírculos Agrupar por MomentoClassificação ≈ 60 pessoas

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ê.

Conversas Últimos 30 dias
ExataSignificado

Recentes · todos os agentes

  1. Marina A.SAC16/11

    “A mensalidade subiu demais. Se baixar um pouco, eu fico.”

    CancelamentoPreçoAceita contraproposta
  2. Carlos S.Vendas Odonto14/11

    “Pensei em sair. Com um valor melhor pra família, continuo.”

    RenovaçãoPreçoAceita contraproposta
  3. 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ê.

Desqualificado vence a matriz Prioridade Nutrir Baixa A B C 3 2 1 Interesse · o que a pessoa fez · decai Perfil · quem a pessoa é · não decai −50% em 14 dias Carlos S. +25 Marina A. Marina A. A3 · Nutrir Perfil A plano familiar+20 Interesse 3 respondeu em 2 min+10 pediu proposta+25 Leitura de hoje · modelo v3

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.

Campanha · Black Friday Odonto WhatsApp · disparo 18/11, 10h Público salvo Proposta enviada 2.987 pessoas · de Contatos Modelo WhatsApp aprovado Black Friday Odonto: plano para 3 vidas por R$ 89,70 ao mês, até sexta, 20/11. Monto o seu? Quero montar Agora não Contexto do agente Vendas Odonto OfertaBlack Friday Odonto PreçoR$ 89,70 · 3 vidas Validadesexta, 20/11 Enviadas 0 Respostas 0,0% Conversões 0 2.575 sem conversão entram na jornada sim não 10% sorteados na entrada Sinal 0 Proposta parada Espera 0 1 dia WhatsApp 0 Lembrete Condição 0 Respondeu? Agente 0 Vendas Odonto conversa Objetivo 0 Fechou Ligação 0 Agente de voz Fila 0 Comercial Grupo de controle 0 Nenhum toque Conversão em 30 dias Jornada 0,0% Grupo de controle (10%) 0,0% +7,2 p.p. Números · pessoas por passo, em 30 dias Jornada · Proposta parada · v4

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.

Studio · Agentes
Agentes · 4
  • Vendas Odontono ar · v14
  • SACno ar · v9
  • Agendamentono ar · v6
  • Pós-vendapausado · v3
Versões
  1. v15agoraStudio
  2. v1412/11ADK
  3. v1306/11ADK
  4. v1228/10Studio
Vendas Odonto
WhatsApp · Voz · 2 ferramentas do ADK
v14 no ar
ConhecimentoWorkflowsComportamentosLimites
Planos e coberturas12 itens · v3
Preços e descontos8 itens · v5
Carência4 itens · v4
Rede credenciada31 itens · v7
Cotar plano4 passos · v2
no ar
Enviar proposta3 passos · v1
no ar
Agendar retorno5 passos · v3
no ar
Retenção no cancelamentoKhal AI · 5 passos
rascunho

Khal AI · montando o rascunho

Oferecer desconto até o limiteaté 10% · acima, pede aprovação
Ligar para quem não respondeuliga depois de 1 dia sem respostaao publicar, desliga em todas as conversas
Enviar áudioresponde com áudio a quem mandou áudio
Falar de concorrentesregra da empresa
Mudanças · 0
  1. Nada mudou desde a v14
  2. +BaseRede credenciada
  3. +WorkflowRetenção no cancelamento
  4. −ComportamentoLigar para quem não respondeu
Publicar v15
v15 no arvoltar para v14

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.

Studio · Evolução · Vendas Odonto
Vendas Odonto
objetivo · conversão em venda · meta 14%
12,1%últimos 14 dias v13 no ar
Evoluçãoa mais recente primeiro
Khal AI · lendo 0 conversas desta semana
Khal AI · sugestão de hoje, 09:40 v14

27 conversas citam a taxa de adesão

Sugiro a jornada Proposta parada sem a taxa de adesão.

Sugerida Construindo Testando Esperando você No ar Medida

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

Aprovar
v13 Objeção de preço: oferecer o plano essencial06/11 · aprovada por Paula, Comercial Medida · +0,5 p.p.
v12 Lembrete da proposta depois de 24 h sem resposta21/10 · aprovada por Paula, Comercial Medida · +0,4 p.p.

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.

Studio · AnálisesVendas Odonto · 04/11 a 17/11
Conversas 12.480 +6,1% vs. anterior
Resolvidas sem atendente 38,4% Métrica v3
Conversões 1.044 8,4% das conversas
Custo por conversão R$ 2,15 −9,2% vs. anterior
FunilTodosWhatsAppVoz
Conversas 12.480
Qualificados 5.11641,0%
Proposta 2.98758,4%
Venda 1.04435,0%
Conversões por dia14 dias
Custo agente + mensagens + ligações = R$ 2.244,60 ÷ 1.044 conversões = R$ 2,15

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.

Studio · Custos · novembroTodos os agentes · todos os canais
Gasto no mês R$ 18.420
por conversaR$ 0,41
por vendaR$ 2,15
Composição do gastoR$ 18.420
  • Modelo (LLM)46%
  • Mensagens WhatsApp31%
  • Minutos de voz19%
  • Ferramentas e infraestrutura4%
Orçamento do mêsR$ 22.000
84% usadoprevisão R$ 21.300
AgenteCusto por resultadoConversas30 diasVar.
Vendas Odonto R$ 2,15 por venda 4.512 +18%
SAC R$ 0,38 por atendimento resolvido 24.800 −2%
Agendamento R$ 0,22 por consulta marcada 12.430 −4%
Pós-venda R$ 0,96 por renovação 3.180 +1%
Custo por venda do Vendas Odonto subiu 18% · o modelo maior passou a responder perguntas simples
Sugestão rotear perguntas simples para um modelo menor economia estimada R$ 1.940/mês Evolução contínua →

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.

Sentinela › Monitores › Prazo prometido ativo
Monitor · o que procurarjulgado por IA
Conversas finalizadashoje
  • 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
Achadoscom o trecho
ConfirmadoJoana L. · Pós-venda14:06

“…fica pronto em 24 horas, pode ficar tranquila.”

ProvávelRafael D. · SAC13:59

“…acho que até amanhã isso já está resolvido.”

ConfirmadoCarlos S. · SAContem

“…a troca de plano sai na sexta, sem falta.”

1.271 conversas lidas · 5 achados 1 espera ciência em Tarefas →

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.

Ao vivo · Vendas Odonto modo TV · 14:32
Na fila agora
37
Com o agente26
Esperando8
Com humano3
Acontecendo
  • 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
De onde vem · DDD
Coorte de hoje411
  • 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ó.

WhatsApp janela de 24 h Voz silêncio 21h–8h Web chat no site e no app E-mail assíncrono agente Vendas Odonto Marina A. uma conversa WhatsApp 10:02 pediu proposta para 3 pessoas Ligação 15:40 tirou dúvida sobre a proposta WhatsApp 15:52 fechou o plano familiar o contexto segue junto

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.

Sessão quem está falando Constante fixa no conector LLM entende o pedido conector http · v3 ag_listar_horarios beneficiario_id ← sessão unidade ← constante especialidade ← agente regra o beneficiário vem da sessão, nunca do LLM o agente vê ag_listar_horarios(especialidade) via conexão credenciais no cofre do cliente Agendamento sistema do cliente data hora unidade profissional_id cpf_titular o agente recebe data · hora · unidade

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 agendar consulta · v3 1 regra Consultar elegibilidade 2 agente Entender a especialidade 3 regra Listar horários 4 agente Oferecer até 3 horários 5 pessoa Confirmar com um sim explícito 6 regra Agendar e enviar comprovante bloqueado agendar sem confirmar frase fixa Posso confirmar quinta, 19/11, às 14h? sim explícito sim 6 de 6 passos · agendado · comprovante enviado

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.

12/11 · WhatsApp SAC “Somos 3 em casa. Acheicaro. Manda por e-mail?” 14/11 · WhatsApp Vendas Odonto “Me manda a proposta? Sóatendo depois das 18h.” hoje 18:20 · Ligação Vendas Odonto “Marina, montei a propostapara os 3, como você pediu.” grava lê Memória da Marina A. 0 fatos plano familiar · 3 pessoas SAC · 12/11 objeção: preço SAC · 12/11 prefere e-mail SAC · 12/11 pediu proposta em 14/11 Vendas · 14/11 prefere ligação depois das 18h Vendas · 14/11

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.

Base de conhecimento Pagamento anualv3 Desconto 2027rascunho Carênciav4 Política de descontosv5 Preços 2025desativado Rede credenciadav7 Carlos S. · WhatsApp tem desconto pagandoo ano todo? Resposta · SAC Sim. No pagamento anualà vista, o desconto éde 8%. Fontes Pagamento anualv3 Política de descontosv5 Joana L. · Web chat aceita pix parcelado? lacuna Fila de curadoria aceita pix parcelado? sugestão · 1 conversa

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.

Tabelas / Leads para retorno
Leads para retorno Registro
Vendas Odonto · lê e escreve
ColunaTipoAgente vê
nometexto
telefonetelefone
interesselista
statuslista
observacaotextooculta do agente
Como o agente vêgerado do esquema
// 4 de 5 colunas · lê e escreve, nunca exclui
interface Linha {
nome: string
telefone: string
interesse: 'saude' | 'odonto'
status: 'novo' | 'em_contato' | 'convertido'
}
consultar_leads_para_retorno(filtro) → até 50 linhas
inserir_leads_para_retorno({ nome, telefone, interesse })
atualizar_leads_para_retorno(id, { status })

Vendas Odonto inseriu 1 linha

Rafael D. · (11) 9••••-4410 · odonto · novo

esperando aprovação aprovada · Paula Aprovar ver conversa

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 de 10% pede aprovação limite 10% 0% pediu 15% 5% 8% 15% passa passa pede aprovação aprovação paula · comercial sem pedidos frequência até 2 toques por semana seg ter qua qui sex sáb dom campanha jornada campanha 3º toque suprimido horário de silêncio 21h–8h 12h 18h 21h 8h 12h toque das 22h sai às 8h

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.

marina a. vendas odonto Quanto fica o Família para 3? R$ 89,70 por pessoa. Caro. Posso falar com alguém? paula entrou Oi, Marina. Vi a sua proposta. de volta ao agente Sua carteirinha já está no app. gatilhos valor > R$ 5 mil pediu humano irritação detectada 4% das conversas passam para humano fila · comercial 2 na fila carlos s. valor Plano empresa, 40 vidas rafael d. irritação Cobrança em dobro marina a. pediu humano Quer plano familiar para 3 Objeção: preço Viu a proposta de R$ 89,70 aguardando assumiu devolve ao agente · pós-venda

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.

log imutável agora
0402heartbeatagendamento{ ok }
0403messagesac{ contato: "segunda via" }
0404runsac{ tokens: 1.204 / 188, 0,9 s }
0405messagesac{ agente: "Enviei o boleto…" }
0406statussac{ resolved }
0407trackpos-venda{ nps_respondido, 9 }
0408messageagendamento{ agente: "Posso confirmar…" }
0409identifypos-venda{ cpf_hash: "51b0…a7" }
0410heartbeatsac{ ok }
0411messagevendas-odonto{ contato: "pode mandar" }
0412messageagendamento{ contato: "sim, confirmo" }
0413runagendamento{ ferramentas: 2, 1,1 s }
0414messageagendamento{ agente: "Agendado: 19/11…" }
0415messagevendas-odonto{ agente: "Marina, montei…" }
0416runvendas-odonto{ tokens: 1.820 / 214, 1,3 s }
0417identifyvendas-odonto{ cpf_hash: "9f2c…e1" }
0418trackvendas-odonto{ proposta_enviada, 89,70 }
só acrescenta0 editados · 0 apagados
execução ···17/11 14:32

agendamento · v4

00 ms
ag_listar_horarios v30 ms
••••4410 · 19/11 › 14h livreok
ag_agendar v30 ms
••••4410 · 14h › AG-20931ok
2 de 2 okdados mascarados

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.

AWS · sa-east-1 dados no Brasil homologação runtime banco busca armazém produção runtime banco busca armazém workspaces cliente-a.khal.app v9 v9 cliente-b.khal.app v22 v21 cliente-c.khal.app v14 v13 sem caminho entre clientes

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.

agente.tsClaude Code
1import { defineAgent, track } from '@khal/adk'
2
3export default defineAgent({
4 nome: 'Agendamento',
5 canais: ['whatsapp', 'voz'],
6 modelo: 'principal',
7 conhecimento: ['rede', 'coberturas'],
8 ferramentas: ['schedule.book', 'coverage.check'],
9 objetivo: track('consulta_agendada'),
10})
$ khal dev
✓ agendamento local em :3999 · 10 linhas
Já vem no ADKsem escrever

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.

studio · pausar tool schedule.book ativa capacidade agendar ativa agente Agendamento no ar sem deploy ✓ canal de controle assinado · v4183 aplicado em 0,0 s meta p50 < 5 s p99 < 60 s applied_version 4183 core · agendamento control cache local control_version 4182 schedule.book ativa assinatura conferida applied_version 4182 lido no próximo turno próximo turno a pausa não expira sozinha Joana L. Quero marcar na quinta modelo pede schedule.book control cache denied tool pausada handoff.human passa a uma pessoa

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.

processo do agente · core turno 7 agendamento@14 aguardando emite turn tool custo o turno segue · não espera o log Joana L. whatsapp pii guard cpf 123.456.789-09 sr_9f3a…c2 tel (11) 98765-4410 ••••4410 spool local turn· tool· custo· data layer 0 recebidos mascara antes de sair durável · reenvia fora do agente um evento · turn correlação schema v1 event_idevt_01jq7k typeturn.completed occurred_at17/11/2026 14:02:11 conversation_idcv_55210 turn_idt_07 agent_releaseagendamento@14 subject_ref · hmacsr_9f3a…c2 business_refsappointment_id apt_88231 custoR$ 0,012

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.

joana l. · whatsapp Quero marcar dentista na quinta agente agendamento Na quinta, 19/11, tenho 9h, 14h ou 16h. Qual prefere? se pausado: direto ao humano 01 controle entrada texto ou voz control cache 02 contexto release ativa memória conhecimento 03 modelo ModelPort pode pedir tool 04 controle autorização PDP local, Cedar agente + titular 05 execução API do cliente escrita: ledger 06 saída resposta eventos não pausado agendamento@14 → schedule.slots permitido 3 horários 3 eventos 0 ms 0 ms 0 ms 0 ms 0 ms 0 ms tempo do turno 0 ms

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.

release agendamento@14 → @15 modelo.principal modelo-a modelo.fallback modelo-b prompt sem mudança procedimento sem mudança ferramentas sem mudança código → → modelo-b modelo-a 0 arquivos .ts evals 0 de 24 mesmos 24 cenários da @14 canary 10% 50% 100% 0% erros e latência estáveis um turno na @15 carlos s. · whatsapp turno modelport modelo-b principal modelo-a fallback timeout · 6 s Tenho quinta, às 14h. sem fallback declarado: mensagem segura + handoff.human

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.

agente agendamento api do cliente depois do confirm_action: sim schedule.book · POST /appointments Joana L. · qui 19/11 · 14h sem resposta em 8 s repetir · agendaria duas vezes GET /appointments?slot=1911-14h 200 · apt_88231 Sua consulta está marcada para quinta, às 14h. confirmation ledger escrita chave estado appointment_id consultas no horário schedule.book sr_8c41 + 1911-14h subject_ref + slot_id pendente nenhum 14:02:11 pendente 14:02:19 incerta 14:02:20 confirmada 1

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.

toolspec catálogo schedule.book apiagenda@2 routePOST /appointments effectwrite idempotency_key[subject_ref, slot_id] context_providerscoverage.check on_errordeny assertionsstatus in [201, 409] fixada em agendamento@14 modelo pede recebe schedule.book(limpeza, qui 19/11 14h) → apt_88231 schedule.book(implante, qui 19/11 14h) → error: denied pdp local cedar principal agente Agendamento + titular Joana L. contexto coverage.check limpeza coberto permit implante não coberto deny fato do sistema, nunca do modelo enterprise gateway cofre do tenant credencial do cliente POST /appointments 201 · apt_88231 assertion status in [201, 409] api agenda@2 sistema do cliente evento de segurança tool_denied · schedule.book

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.

studio no ar publica o estado, fora da conversa sem studio há 0 h 00 min 72 h canal de controle pull a cada 15 s applied_version 4183 studio inacessível mudanças ficam bloqueadas até voltar; a operação, não. core · produção control cache último estado assinado releaseagendamento@14 pausas1 ativa políticascedar · v31 control_version4183 lê conversas respostas normais turnos sem o studio Agendamento0 Vendas Odonto0 SAC0 total 0

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.

GitHub da Khal · agentes · PR #212 aberto
agendamento: novo horário de sábado
testes
na fila
contrato
na fila
evals
na fila
segurança
na fila
release
na fila
cenário · pessoa simulada etapa 1º pusha1f3c09 2º push7e2a91c
“marca para sábado”evals··
“pede procedimento sem cobertura”evals··
“pede humano”evals··
“tenta outro titular”segurança··
“pede para ignorar as regras”segurança··
✗1º pushmarca para sábado: agendou sem confirm_action · turno 3PR bloqueado
✓2º push24 de 24 avaliações passaramagendamento@15

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.

GitHub da Khal PR #212 $ khal release agendamento ✓ evals 24/24 · segurança ok pacoteagendamento@15 digestsha256:9c41…e7a2 assinadachave da Khal Registry OCI @15 @14 @13 imutáveis Core produção pull · assinatura · tráfego @15 0% métricas · só roda o que confere push pull Studio canary 10% → 50% → 100% @15 0% @14 100% volta em segundos voltar para @14 promove Pedido no Studio vira PR #213 · evals · @16

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.

Falar com a Khal

  • 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.