Handoff entre agentes: contexto obrigatório e como medi-lo

O que é um handoff entre agentes?

Em um sistema com vários agentes, a conversa muda de mãos. O Victor, porta de entrada, entende o pedido e o encaminha ao agente certo: a DAISY para leitura estratégica, a ELISA para execução. Esse momento de troca é o handoff.

O risco aparece aqui, e é fácil de subestimar. Se o agente destino recebe a conversa sem o que precisa, a resposta degrada em silêncio. O usuário vê uma resposta pior e não sabe por quê.

Há ainda uma regra de proteção: o Victor é instruído a nunca encaminhar a conversa para si mesmo, e o servidor recusa registros em que origem e destino são iguais.

O contrato mínimo de contexto

A PowerVizion define, por campo, o que o agente destino espera receber. O contrato atual é deliberadamente pequeno, e cada campo tem um papel:

Esse desenho trata o contrato como um acordo de interface, parecido com os contratos de uma API: o agente destino declara o que espera, e quem envia confere se entregou.

O contrato vive no servidor, e não no aplicativo. Assim, uma mudança de regra vale para todos os clientes sem exigir nova versão.

• Mensagem do usuário: obrigatória. Sem ela, não há o que responder.
• Histórico da conversa: opcional. Ajuda, mas o agente funciona sem ele.
• Agente anterior: opcional. Indica quem acionou quem.
• Anexos e arquivos: sem expectativa definida. Se vierem, são registrados como "não usados".

Como cada troca é medida

A decisão de trocar de agente acontece no aplicativo: se a resposta atual vem de um agente diferente da última resposta da conversa, a troca é tratada como handoff. Quando o agente destino termina, o aplicativo envia ao servidor um relatório com origem, destino, status, latência, tamanho do contexto e a lista de campos efetivamente enviados.

O servidor compara essa lista com o contrato. Cada campo fica como "ok", "ausente" ou "não usado", e o total de obrigatórios ausentes é gravado junto de um identificador de rastreio. Dados que não foram medidos não são inventados.

Por exemplo, o aplicativo considera que há histórico quando a conversa tem mais de uma mensagem, e que há anexos quando alguma mensagem traz arquivo anexado.

Como a PowerVizion aborda o contexto obrigatório

O princípio é tornar a falta visível. Um handoff sem a mensagem do usuário aparece com campo ausente, em vez de passar despercebido. Isso transforma uma falha vaga, "a resposta ficou estranha", em um fato verificável por rastreio.

A medição é desenhada para nunca atrapalhar a conversa. O envio do relatório é feito sem esperar resposta, e uma falha no registro não derruba o chat. Troca de um agente para ele mesmo não é registrada.

Cada registro ganha um identificador de rastreio curto, que serve de referência para a equipe de suporte e para quem investiga uma resposta específica. O mesmo identificador aparece na tela de Observabilidade. Essa abordagem é coerente com o resto da plataforma: transparência antes de restrição.

Exemplo ilustrativo: uma troca de Victor para DAISY

Um usuário pede ao Victor uma leitura de cenário. O Victor encaminha para a DAISY, que responde. O aplicativo registra o handoff: o histórico foi enviado, não havia anexos e a mensagem do usuário estava presente. O rastreio mostra contexto completo.

Se a mensagem chegasse vazia, o registro marcaria o campo obrigatório como ausente, e o painel de observabilidade mostraria a quantidade de campos ausentes. Este é um exemplo ilustrativo do desenho, sem números de ocorrência real.

A verificação não interpreta a mensagem. Ela só confere se o campo foi enviado, o que mantém a medição simples e previsível. O registro serve à auditoria: mostra quando, entre quais agentes e com que campos a troca ocorreu.

Por que registrar em vez de bloquear a troca?

Bloquear um handoff por contexto incompleto parece seguro, mas pode piorar a experiência: a pessoa fica sem resposta por um detalhe que o agente talvez contornasse. A PowerVizion optou por primeiro medir e só depois decidir onde endurecer a regra.

Com o registro, a equipe vê quais pares de agentes mais perdem contexto e pode ajustar o encaminhamento. A decisão de endurecer ou não vira uma escolha informada, não um palpite.

A mesma filosofia vale para o resto da plataforma: o sistema mostra o que aconteceu e deixa a decisão com as pessoas. A equipe pode usar esse registro para decidir se vale ajustar o encaminhamento do Victor.

Limites atuais

A verificação é observacional: ela registra depois que o agente destino responde e não impede a troca. O contrato também é mínimo, com um único campo obrigatório, e não valida a qualidade do conteúdo, apenas a presença.

O relatório parte do aplicativo, e o campo de tokens existe no registro, mas pode ficar sem valor. Handoffs decididos dentro de um flow ou fora do chat do aplicativo não passam por esse caminho. Ampliar o contrato é o próximo passo natural, e ainda não há data.

Por fim, o contrato descreve o que o agente destino espera, não o que ele de fato aproveita. Medir o uso real do contexto, e não só o envio, exigiria outro tipo de instrumentação.

Perguntas frequentes

O que é handoff entre agentes de IA?

É a passagem de uma conversa de um agente para outro, por exemplo do Victor para a DAISY. O agente destino precisa receber o contexto necessário para responder bem.

Qual contexto é obrigatório no handoff da PowerVizion?

Hoje, apenas a mensagem do usuário. Histórico da conversa e agente anterior são opcionais, e os anexos são registrados quando existem.

O que acontece se o contexto obrigatório faltar?

A troca é registrada com o campo marcado como ausente e aparece na observabilidade. A verificação não bloqueia a conversa.

Onde vejo os handoffs?

No módulo de Observabilidade, que lista a troca entre agentes, o status, o tamanho do contexto e a latência.