Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]
Um agente que aparece correto na aba Build ainda pode falhar na conversa. Instruções são orientação, não garantias: o modelo as interpreta, e a diferença entre o que você escreveu e o que o agente faz só aparece quando você realmente fala com ele. Use a aba Preview para testar seu agente tanto no chat web quanto na voz antes de publicar.
Canais de teste
A aba Preview oferece duas formas de testar seu agente:
- Webchat: Um painel de chat baseado em texto. É aí que você deve passar a maior parte do tempo realizando testes. É mais rápido que a voz, a transcrição completa é visível, e você recebe um traço de raciocínio junto com o chat.
- Chamada de Voz: Uma conversa ao vivo com seu agente. A voz tem modos de falha que o texto nunca revela, então teste separadamente mesmo quando o chat passa limpo.
Selecione Chat na Web ou Chamada de Voz no topo da aba Prévia para alternar entre os canais de teste. Um painel de Transcrição ao Vivo aparece junto com a conversa.
Antes de começar
- Salve suas alterações. O painel de Pré-visualização executa seu agente salvo, não as edições não salvas na aba Build .
- Saiba identificar o que está "correto". Anote o resultado esperado antes de enviar a primeira mensagem.
- Abra o mapa de atividades. Ele fica ao lado do chat e mostra roteamento, chamadas de ferramentas e execução de tópicos. É como você distingue uma falha de raciocínio de uma falha de infraestrutura.
- Inicie uma nova sessão de teste entre os cenários. O contexto é transferido e contaminará seu próximo resultado.
As cinco camadas a serem testadas
Comece pela camada mais simples e avance para as externas. Uma falha em uma camada inicial se propagará em cascata, então corrija os problemas em ordem.
| Camada | O que você está testando | Como saber se está funcionando |
|---|---|---|
| Saudação e escopo | O agente se apresenta e entende sua própria função | A mensagem de abertura corresponde à sua descrição; aceita pedidos dentro do escopo |
| Routing | O orquestrador escolhe o subagente certo | O mapa de atividades mostra o especialista esperado invocado |
| Ferramentas e tópicos | As ações realmente executam e retornam dados | Valores reais voltam, não marcadores de posição ou silêncio |
| Conhecimento | As respostas são fundamentadas nas suas fontes | As citações aparecem e correspondem às suas fontes configuradas |
| Barreiras de proteção | Recusas, escalonamentos e regras de negócios em espera | O agente recusa, encaminha ou sinaliza exatamente conforme instruído |
Testes no chat web
Execute primeiro o fluxo principal
Atue como um usuário realista com um objetivo completo, não como um testador cutucando recursos. Por exemplo, para um agente de viagens, isso significa reservar uma viagem de ponta a ponta em vez de perguntar "você pode reservar voos?"
- Abra a meta naturalmente, do jeito que um usuário real faria.
- Responda às perguntas do agente como usuário cooperativo.
- Siga o fluxo até uma conclusão real: um agendamento, um resumo, uma resolução.
- Peça um resumo no final e depois verifique todos os fatos com a transcrição.
Então quebre de propósito
O fluxo principal prova que o agente pode trabalhar. Esses cenários provam que ele falha de forma segura.
| Teste | O que enviar | O que deveria acontecer |
|---|---|---|
| Detalhe faltante | Ignorar um campo obrigatório de que o agente precisa | Ele pede exatamente esse campo, apenas uma vez |
| Mudança de ideia | Reverta uma decisão no meio do fluxo | Ele atualiza sem perder o contexto anterior |
| Fora do escopo | Pergunte algo fora do domínio dele | Ele declina e redireciona, sem improvisar |
| Escalonamento | Acione uma regra de handoff documentada | Transfere em vez de tentar a tarefa |
| Regra de negócios | Ultrapasse um limite declarado, como o orçamento | Ele sinaliza explicitamente o conflito |
| Memória na sessão | Peça para repetir um detalhe de antes | Lembra com precisão, sem pedir novamente |
Leia o Activity Map, não apenas a resposta
O chat te diz o que o agente disse. O mapa de atividades informa o que foi feito. Quando uma resposta parece errada, o mapa indica onde corrigi-la:
- Especialista errado invocado → suas instruções de roteamento ou descrições de subagentes são ambíguas.
- Especialista correto, saída ruim → as instruções do próprio subagente precisam ser melhoradas.
- A ferramenta rodou mas não retornou nada → a ferramenta ou o tópico está quebrado, não o prompt.
- Nenhuma chamada de ferramenta → o agente respondeu com base no modelo em vez dos seus dados. Trate cada valor desse retorno como não verificado.
Teste por voz
Voice não é um chat na web com áudio anexado. Há modos de falha em que o texto jamais será exibido, então teste-o separadamente mesmo quando o chat passa limpo.
- Conceda acesso ao microfone, então inicie a conversa de voz e confirme que o status atinja o estado conectado e ouvindo.
- Fale um pedido completo naturalmente, em vez de ler um roteiro palavra por palavra.
- Assista à transcrição ao vivo. Se o reconhecimento de fala interpretar errado o que você disse, a resposta do agente estará respondendo a uma pergunta diferente da que você fez.
- Interrompa o agente no meio da frase para verificar se o barge-in interrompe a reprodução e passa a escutar.
- Fique em silêncio por alguns segundos para confirmar que ele solicita novamente de forma educada, em vez de encerrar a chamada.
- Peça um código de confirmação e verifique se está escrito caractere por caractere, não lido como uma palavra.
A que prestar atenção ao ouvir
- Duração: Qualquer coisa acima de cerca de três frases é longa demais para acompanhar de ouvido.
- Listas e URLs: Essas devem ser resumidas, nunca devem ser lidas em voz alta item por item.
- Datas e números: "Terça-feira, vinte e quatro de março" funciona; "2026-03-24" não.
- Confirmação de dados críticos: Nomes, datas e códigos devem ser confirmados antes que o agente aja sobre eles.
Se o Speech se comporta como seu canal de Chat, as instruções específicas do canal não estão cumprindo o papel delas. Instruções de fala e chat são configuradas separadamente em cada agente, nas abas Fala e Chat da seção Instruções. Veja Visão geral das configurações de fala e chat.
Dica
Execute seus cenários críticos mais de uma vez e faça pelo menos uma sessão longa. Falhas intermitentes ainda são falhas, e são as que chegam à produção.
Quando algo falha
- Reproduza-a. Comece uma nova sessão e execute as mesmas etapas novamente, observando se ela falha toda vez ou de forma intermitente.
- Localize-o usando o mapa de atividade: roteamento, ferramenta, conhecimento ou instrução.
- Conserte uma coisa de cada vez. Mudar várias instruções ao mesmo tempo torna impossível saber o que funcionou.
- Salve, comece uma nova sessão e execute exatamente o mesmo cenário.
- Refaça seus outros cenários aprovados. Mudanças nas instruções têm efeitos colaterais.
Lista de verificação de pronto para envio
- O fluxo ideal é concluído de ponta a ponta sem intervenção manual.
- Cada fato no resumo final pode ser atribuído a algo que uma ferramenta ou fonte de conhecimento realmente retornou.
- Nenhum texto provisor aparece em nenhuma resposta visível para o usuário.
- O agente relata a falha honestamente quando uma ferramenta não retorna nada.
- Regras de escalonamento e recusa disparam de forma confiável.
- As respostas de voz são curtas e os códigos são soletrados.
- Cenários críticos foram executados mais de uma vez, incluindo uma sessão longa.