Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
[Este artigo é documentação de pré-lançamento e está sujeito a alterações.]
Um agente que parece correto no separador Build pode ainda falhar numa conversa. As instruções são orientação, não garantias: o modelo interpreta-as, e a diferença entre o que escreveu e o que o agente faz só aparece quando realmente fala com ele. Use o separador Pré-visualização para testar o seu agente tanto no chat web como na voz antes de o publicar.
Canais de teste
O separador Pré-visualização oferece duas formas de testar o seu agente:
- Webchat: Um painel de chat baseado em texto. É aqui que deves passar a maior parte do tempo dedicado aos testes. É mais rápido do que a voz, a transcrição completa é visível e recebes um rasto de raciocínio juntamente com o chat.
- Chamada de Voz: Uma conversa de voz ao vivo com o seu agente. A voz tem tipos de falha que no texto nunca se manifestam, por isso testa separadamente mesmo quando o chat passa nos testes.
Selecione Webchat ou Voice Call no topo do separador Pré-visualização para alternar entre canais de teste. Um painel de Transcrição em Direto aparece ao lado da conversa.
Antes de começar
- Guarde as suas alterações. O painel de Pré-visualização executa o teu agente guardado, não as edições não guardadas no separador Build .
- Saiba como é "correto". Escreva o resultado esperado antes de enviar a primeira mensagem.
- Abra o mapa de atividades. Fica ao lado do chat e mostra o encaminhamento, chamadas de ferramentas e execução de tópicos. É assim que distingue uma falha de raciocínio de uma falha de canalização.
- Inicia uma nova sessão de teste entre cenários. O contexto é mantido e vai contaminar o teu próximo resultado.
As cinco camadas para testar
Comece pela camada mais simples. Uma falha numa camada inicial propagar-se-á em cascata, por isso corrige os problemas por ordem.
| Camada | O que estás a testar | Como verificar que funciona |
|---|---|---|
| Saudação e âmbito | O agente apresenta-se e compreende o seu próprio trabalho | A mensagem de abertura corresponde à sua descrição; aceita pedidos dentro do âmbito |
| Routing | O orquestrador escolhe o subagente certo | O mapa de atividade mostra o especialista esperado invocado |
| Ferramentas e tópicos | As ações efetivamente executam e devolvem dados | Os valores reais regressam, não os marcadores de posição ou o silêncio |
| Conhecimento | As respostas baseiam-se nas tuas fontes | As citações aparecem e correspondem às suas fontes configuradas |
| Barreiras de segurança | Recusas, escalada e regras de negócio em espera | O agente recusa, encaminha ou denuncia exatamente conforme instruído |
Testes no chat web
Execute primeiro o fluxo principal
Jogue como um utilizador realista com um objetivo de ponta a ponta, não como um testador a mexer com funcionalidades. Por exemplo, para um agente de viagens, isso significa reservar uma viagem real de ponta a ponta em vez de perguntar "consegues reservar voos?"
- Abre o objetivo naturalmente, como um utilizador real faria.
- Responder às perguntas do agente como utilizador cooperativo.
- Segue o fluxo até uma conclusão real: uma reserva, um resumo, uma resolução.
- Pede um resumo no final e depois verifica todos os factos nele contidos com base na transcrição.
Então parte-o de propósito
O cenário ideal prova que o agente pode trabalhar. Estes cenários provam que falha de forma segura.
| Teste | O que enviar | O que deve acontecer |
|---|---|---|
| Detalhe em falta | Ignorar um campo obrigatório de que o agente precisa | Pede exatamente esse campo, uma única vez |
| Mudança de opinião | Alterar uma decisão a meio do processo | Atualiza sem perder o contexto anterior |
| Fora de âmbito | Pergunte algo fora do seu domínio | Declina e redireciona, sem improvisar |
| Escalamento | Ativar uma regra de handoff documentada | Transfere em vez de tentar realizar a tarefa |
| Regra de negócio | Ultrapassar um limite declarado, como o orçamento | Sinaliza explicitamente o conflito |
| Memória da sessão | Pede-lhe para repetir um detalhe de antes | Recorda com precisão, sem ter de voltar a perguntar |
Leia o mapa de atividade, não apenas a resposta
O chat diz-te o que o agente disse. O mapa de Atividade diz-te o que ele fez. Quando uma resposta parece errada, o mapa indica onde corrigi-la:
- O especialista errado invocado → as suas instruções de roteamento ou descrições do subagente são ambíguas.
- Especialista adequado, mau resultado → as instruções do próprio subagente precisam de melhorias.
- A ferramenta foi executada mas não devolveu nada → a ferramenta ou o tópico está avariado, não o prompt.
- Não houve qualquer chamada de ferramenta → o agente respondeu a partir do modelo em vez dos teus dados. Trate todos os elementos dessa resposta como não verificados.
Testes de voz
O Voice não é chat web com áudio associado. Tem modos de falha que o texto nunca revela, por isso testa-o separadamente mesmo quando o chat não apresenta problemas.
- Conceda acesso ao microfone, depois inicie a conversa de voz e confirme que o estado atinge um estado ligado e em escuta.
- Fale um pedido completo de forma natural em vez de ler um guião palavra por palavra.
- Veja a transcrição em direto. Se o reconhecimento de voz compreender mal o que disse, a resposta do agente está a responder a uma pergunta diferente da que fez.
- Interrompa o agente a meio da frase para verificar se a interrupção por voz para a reprodução e fica à escuta.
- Fica em silêncio durante vários segundos para confirmar que volta a pedir de forma educada em vez de desligar a chamada.
- Pede um código de confirmação e verifica se é soletrado carácter a carácter, não lido como uma palavra.
Ao que prestar atenção
- Extensão: Qualquer coisa acima de cerca de três frases é demasiado longa para acompanhar de ouvido.
- Listas e URLs: Estas 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 de o agente agir sobre eles.
Se a Speech se comporta como o teu canal de chat, as instruções específicas do canal não estão a fazer o seu trabalho. As instruções de Voz e Chat são configuradas separadamente em cada agente, nos separadores Voz e Chat da secção de Instruções. Veja Descrição geral das definições de fala e chat.
Tip
Executa os teus cenários críticos mais do que uma vez e faz pelo menos uma sessão longa. Falhas intermitentes continuam a ser falhas, e são as que chegam à produção.
Quando algo falha
- Reproduza-o. Inicia uma nova sessão e repete o mesmo caminho, anotando se falha sempre ou de forma intermitente.
- Encontre-o usando o mapa de atividade: encaminhamento, ferramenta, conhecimento ou instrução.
- Resolve uma coisa de cada vez. Mudar várias instruções ao mesmo tempo torna impossível perceber o que funcionou.
- Guardar, iniciar uma nova sessão e repetir exatamente o mesmo cenário.
- Repete os teus outros cenários aprovados. As alterações nas instruções têm efeitos secundários.
Lista de verificação de prontidão para envio
- O caminho nominal é concluído de ponta a ponta sem orientação.
- Cada facto no resumo final é rastreável a algo que uma ferramenta ou fonte de conhecimento realmente devolveu.
- Nenhum texto provisório aparece em lado nenhum numa resposta visível pelo utilizador.
- O agente reporta a falha honestamente quando uma ferramenta não devolve nada.
- As regras de escalada e recusa disparam de forma fiável.
- As respostas de voz são curtas e os códigos são soletrados.
- Cenários críticos foram executados mais do que uma vez, incluindo uma sessão longa.