Observabilidade de handoffs: quem acionou quem e em quanto tempo

O que é observabilidade de agentes?

Observabilidade é a capacidade de entender, a partir do que o sistema registra, o que aconteceu dentro dele. Para agentes, isso significa saber quem passou a conversa a quem, o que foi enviado e se a troca funcionou.

Sem esse registro, um sistema com vários agentes vira uma caixa preta. A tela de Observabilidade existe para que a pergunta "por que essa resposta saiu assim?" tenha onde ser investigada.

A tela serve a duas pessoas: quem opera a plataforma e investiga um problema, e quem administra o workspace e quer ter confiança no que os agentes estão fazendo. É o equivalente, para conversas entre agentes, ao que um rastreio é para uma requisição de software.

A lista: o que cada coluna mostra

A tela principal traz a tabela das últimas trocas do workspace, da mais recente para a mais antiga. Ela é alimentada apenas por registros reais, sem dados de exemplo.

Cada linha é um rastreio e pode ser aberta para inspeção. O rótulo de status resume a conferência de contexto em uma única leitura, para que o time passe os olhos e vá direto aos casos que merecem atenção.

Quando ainda não há handoffs, a tela explica que eles aparecem quando uma conversa passa de um agente para outro, como do Victor para a DAISY.

• Trace: identificador curto do rastreio.
• Handoff: agente de origem e agente de destino.
• Status: "Contexto completo", "N campo(s) ausente(s)" ou "Erro".
• Contexto: tamanho do que foi enviado, em kilobytes.
• Latência: tempo até o agente destino terminar, em milissegundos.
• Horário: quando a troca foi registrada.

O detalhe do rastreio: o Handoff Inspector

Abrir um rastreio mostra os dois agentes lado a lado, com o status de cada um, e as métricas da troca: tamanho do contexto, latência, tokens e quantos campos obrigatórios chegaram. Abaixo, uma tabela compara o contrato com o que foi enviado, campo a campo.

Cada campo aparece como "OK", "Ausente" ou "Não usado", com o nome técnico ao lado. É a evidência de que a mensagem do usuário, o histórico e os anexos chegaram ou não.

O tamanho do contexto ajuda a notar trocas desproporcionais, como uma conversa muito longa enviada a um agente que precisava de pouco.

Saúde da aresta nas últimas 24 horas

O mesmo rastreio mostra a saúde do par de agentes envolvido: quantas execuções ocorreram, a taxa de sucesso, a latência média e quantas tiveram contexto completo. Há uma linha de tendência por hora e a lista das dez execuções mais recentes do par.

Isso ajuda a distinguir um caso isolado de um padrão. A conta é feita sobre as execuções da janela, sem estimativas. Se uma troca específica falha, a aresta mostra se é um episódio ou se o problema se repete. O par de agentes é a unidade de análise porque é nele que o contrato de contexto se repete, a mesma troca muitas vezes.

Como a PowerVizion aborda a observabilidade

Três princípios guiam o desenho: registrar só o que foi de fato medido, nunca bloquear o chat por causa do registro e isolar os dados por workspace. As consultas filtram sempre pelo workspace de quem pergunta, e o rastreio de outro workspace responde "não encontrado".

Essa tela se soma a outras camadas de transparência da plataforma, como o consumo por agente em Uso e Custos e a auditoria de guardrails. Cada uma responde a uma pergunta diferente: a Observabilidade mostra a troca, Uso e Custos mostra o consumo, e os guardrails mostram o que foi barrado.

Como os registros trazem o identificador do rastreio, a equipe pode citar uma troca específica em um chamado de suporte e ser entendida sem precisar reproduzir a conversa inteira.

Exemplo ilustrativo: investigando uma resposta estranha

Um usuário relata que a resposta da DAISY ignorou o que ele havia dito ao Victor. A equipe abre a Observabilidade, localiza o rastreio da troca pelo horário e vê o status "1 campo(s) ausente(s)".

No detalhe, a tabela mostra qual campo faltou. Em seguida, a saúde da aresta indica se o par Victor e DAISY costuma chegar completo ou se esse foi um caso isolado. Este é um exemplo ilustrativo de uso, não um caso real.

O acesso é feito pelo aplicativo autenticado, no contexto do workspace ativo da pessoa, como as demais telas da plataforma.

Limites atuais

A lista mostra as 50 trocas mais recentes por padrão, com um teto de 200 na consulta. O registro parte do aplicativo, quando o chat troca de agente, e não cobre execuções fora dessa rota.

O campo de tokens existe, mas pode aparecer como "—" quando o aplicativo não o informa, e a latência é medida no aplicativo, incluindo o tempo de rede. Para o contrato de contexto, vale a nota técnica sobre handoff obrigatório.

Também não há alertas automáticos sobre as trocas: a tela é de consulta. Quem quiser acompanhar um par de agentes precisa abrir a aresta, e a leitura é feita por uma pessoa. A janela de 24 horas é fixa no detalhe, e a lista não tem, hoje, filtro por período ou por agente.

Perguntas frequentes

O que a Observabilidade da PowerVizion mostra?

Cada handoff entre agentes: quem acionou quem, status, tamanho do contexto, latência e se campos obrigatórios ficaram de fora. O detalhe inclui a saúde do par nas últimas 24 horas.

O que significa "Contexto completo"?

Que todos os campos obrigatórios do contrato chegaram ao agente destino. Se faltar algum, a tela mostra quantos campos ficaram ausentes.

A Observabilidade usa dados de exemplo?

Não. As telas leem apenas a tabela de handoffs registrados. Se ainda não houve trocas, a lista aparece vazia.

Outros workspaces veem os meus rastreios?

Não. As consultas são filtradas pelo workspace, e um rastreio de outro workspace não é encontrado.