Saltar para o conteúdo
Guia7 min de leitura

Guia de Vídeo de Reprodução de Erros do Agente de IA

Registe um percurso de erro observado sem adivinhar a sua causa.

Grave a reprodução verificada de um erro numa aplicação criada por agente, com dados seguros e uma entrega que não exagera a causa.

Ver como funcionaOs primeiros 60 segundos de vídeo são gratuitos, com marca de água. Verifique o seu correio eletrónico para o descarregar.

Um vídeo de reprodução de erro do agente de IA deve preservar um comportamento de navegador observado para que outra pessoa o consiga inspecionar e repetir. A sua função não é diagnosticar a causa, prever o âmbito afetado nem provar que um agente cometeu um erro. O registo útil mostra onde o navegador começou, que ações foram tomadas, que resultado se esperava e o que realmente apareceu. Essa sequência dá a um responsável um ponto de partida concreto quando a interface está a mudar rapidamente.

Isto é particularmente valioso quando um agente ajudou a construir a aplicação. Rótulos, rotas e a gestão de estado podem mudar entre um relatório escrito e uma revisão posterior. Uma descrição simples pode perder o pormenor que tornou o comportamento visível. Uma gravação delimitada capta os termos e o estado do ecrã de uma sessão. Não substitui a investigação, as verificações de acessibilidade nem uma decisão sobre se um comportamento é suficientemente importante para mudar.

O GogoScreen pode preparar um MP4 editado a partir do URL acessível de uma aplicação web e de uma indicação de uma linha sobre o fluxo de navegador. Grava a aplicação real, não uma maqueta, enquanto percorre o fluxo. Uma renderização pode falhar ou precisar de uma nova tentativa, pelo que o próprio candidato deve ser verificado face à observação original. Trate o resultado como um registo para uma rota e estado específicos, não como uma afirmação de que o mesmo comportamento acontece em qualquer ambiente.

Declare o comportamento observado antes de gravar

Escreva o relatório em quatro partes antes de escolher a rota. Nomeie o estado inicial, a sequência de ações, o resultado visível esperado e o comportamento visível observado. Use os termos que uma pessoa consegue ver no navegador. Evite uma conclusão como um componente está avariado, um serviço causou o comportamento ou todos os utilizadores são afetados. Essas afirmações exigem evidência para além de uma gravação de ecrã.

O resultado esperado deve ser suficientemente concreto para que outra pessoa o compare com o fotograma final. Se a expectativa for vaga, o revisor não consegue saber se o excerto mostra um defeito, um fluxo de trabalho pouco familiar ou uma explicação incompleta. Uma declaração clara pode dizer que selecionar uma opção visível deve revelar um estado de confirmação nomeado, enquanto a sequência observada regressa ao mesmo painel. Não deve depender de instruções internas nem de suposições que só quem construiu a aplicação conhece.

O guia de demonstração de issue do GitHub com agente de IA cobre como anexar um resultado de navegador delimitado a uma discussão de issue. O guia de vídeo de demonstração do agente de IA ajuda a manter uma gravação focada num resultado verificado. Para um fluxo pronto a mostrar como evidência positiva de produto, use o guia de vídeo de demonstração de aplicação criada por agente em vez de apresentar um registo de reprodução como uma demonstração de funcionalidade.

Prepare um estado seguro repetível

Abra a rota manualmente e recrie o comportamento observado antes de pedir um candidato. Note a página inicial visível, os dados não sensíveis preparados, os controlos selecionados e o estado final. Verifique redirecionamentos, avisos de cookies, intervalos de carregamento, modais, estados vazios e rótulos. Se surgir uma condição inesperada, registe-a como parte da sessão, em vez de a suavizar com narração.

Registo de observaçãoO que capturarO que não concluir
Estado inicialA rota e as condições visíveisPor que motivo ocorre o comportamento.
Sequência de açõesOs controlos selecionados, por ordemSe todos os utilizadores o veem.
Resultado esperadoO resultado visível que uma pessoa antecipavaQue sistema causou a diferença.
Comportamento observadoO que apareceu nesta sessãoSe uma correção vai funcionar.

Use esta sequência de reprodução antes de gravar:

  1. Declare o resultado visível esperado em termos de navegador.
  2. Repita as ações exatas a partir do estado seguro preparado.
  3. Compare o fotograma final com o comportamento observado antes de partilhar o candidato.

Use dados seguros para mostrar. Não inclua um nome de cliente, um URL de cliente, um documento privado, uma credencial nem conteúdo multimédia de cliente. Se for necessária autenticação, use uma conta de demonstração descartável através do processo aprovado. No GogoScreen, as credenciais são cifradas, utilizadas para uma única renderização e depois eliminadas. Se for planeado primeiro um storyboard, as credenciais ficam cifradas durante essa sessão e são eliminadas, no máximo, duas horas após a última utilização. Quem grava e quem revê não pede, copia nem mostra esses dados.

Uma reprodução é mais forte quando começa no estado visível mais antigo que torna o comportamento compreensível. Começar depois da seleção-chave pode encurtar o excerto, mas pede ao espectador que aceite uma descrição não verificada do que aconteceu. Começar muito antes pode ocultar a alteração importante. Selecione a sequência mais pequena que uma pessoa pouco familiarizada com o produto consiga repetir.

O guia de vídeo de demonstração de software a partir de um URL ajuda a preparar uma rota estável para uma execução de navegador. O guia de demonstração de automação de navegador com agente de IA distingue evidência de navegador observável de suposições sobre como a automação se comporta. O guia de vídeo de demonstração de funcionalidade do agente de IA explica como gravar um resultado bem-sucedido verificado quando o comportamento já foi corrigido.

Descreva a sequência sem diagnóstico

A indicação deve descrever as ações e o comportamento visível em linguagem neutra. Nomeie o contexto da rota, a ação do utilizador e o resultado inesperado. Não coloque uma causa suspeita na indicação. Um candidato deve permitir a um revisor observar a mesma sequência antes de formar uma explicação. Isto reduz o risco de as legendas ou a voz sobreposta transformarem um diagnóstico provisório numa afirmação de facto.

Assista ao candidato primeiro sem som. Confirme que o estado de abertura, cada ação necessária e o comportamento final são visíveis. Depois compare as legendas e a voz sobreposta com a execução de navegador. O GogoScreen escreve e fala uma voz sobreposta ajustada ao que aconteceu no ecrã, mas o responsável tem de decidir se a linguagem descreve com precisão a observação. Remova redação que afirme a causa raiz, a população afetada, a consequência de segurança ou uma correção futura sem evidência separada.

Para uma alteração técnica em discussão, o guia de vídeo de demonstração de PR do agente de IA mantém o registo ligado ao comportamento proposto. O guia de vídeo de demonstração de agente de programação é útil quando uma pessoa precisa de explicar uma alteração visível sem a tratar como prova ampla de produto. O guia de vídeo de demonstração de entrega do agente ajuda a transferir uma pequena tarefa de navegador verificável para outro responsável.

Entregue uma observação que possa ser verificada

Um registo de entrega útil nomeia a data de captura, a rota, o estado seguro, a sequência de ações, o resultado esperado, o comportamento observado e o revisor. Pode também nomear o que não foi verificado, como outra rota ou uma condição de conta diferente. Isto não é preenchimento administrativo. Diz à pessoa seguinte exatamente o que a gravação demonstra e onde estão os limites.

Os revisores devem comparar a observação escrita com o candidato numa única sessão. Verifique rótulos desatualizados, preparação oculta, erros inesperados, material privado ou um resultado que desaparece demasiado depressa para ser avaliado. Se o comportamento não puder ser reproduzido no candidato, não use a gravação como prova. Atualize o relatório com a nova observação e experimente uma sequência recém-verificada, em vez de editar a explicação para se ajustar a um ficheiro antigo.

Cada conta nova recebe 60 segundos de vídeo uma única vez, com marca de água. Depois disso, os vídeos usam tempo de um plano ou de um carregamento, e o tempo só é usado quando uma renderização é bem-sucedida. Um limite curto sustenta uma sequência concisa. Não dispensa mostrar a ação visível que dá sentido ao resultado inesperado.

Mantenha a evidência de erro separada da prova pública

Uma gravação de reprodução pode informar uma revisão interna, uma alteração proposta ou uma entrega. Não deve ser reutilizada como prova pública de produto apenas porque a interface parece polida. Um ficheiro público precisa da sua própria afirmação, público, revisão de dados seguros e decisão humana. Depois de um comportamento ser corrigido, um novo candidato de funcionalidade deve mostrar o resultado atualmente verificado, em vez de sugerir que um problema anterior nunca existiu.

O guia de vídeo de demonstração de resultado de teste do agente de IA é para um resultado específico verificado depois de uma condição testável ter sido definida. O guia de vídeo de entrega de lançamento do agente de IA serve para dar a outro responsável um resultado aceite delimitado. O guia de vídeo de demonstração para investidores do agente de IA mantém uma observação de navegador separada de afirmações comerciais mais amplas. O guia de apresentação guiada de produto do agente de IA é útil quando um revisor precisa de contexto ligado em torno de um fluxo selecionado. Para colocação de lançamento, use o guia de vídeo de demonstração de lançamento do agente de IA e reveja desde o início a afirmação pública escolhida.

Visite a página inicial do GogoScreen para o fluxo de trabalho de URL e indicação. Um vídeo cuidadoso de reprodução de erro do agente de IA mantém-se limitado ao comportamento de navegador que mostra, torna visível a sequência repetível e deixa a causa, o âmbito e a correção para a evidência que realmente os consegue sustentar.

Esclarecimentos

Antes de começar

O que deve incluir um vídeo de reprodução de erro do agente de IA?

Inclua o estado inicial, as ações visíveis exatas, o resultado esperado e o comportamento observado numa única sessão de navegador verificada. Deve documentar o que aconteceu sem afirmar a causa, o âmbito ou a correção, a menos que existam evidências separadas para esses pontos.

Por que gravar um erro numa aplicação criada por agente?

Uma interface criada por agente pode mudar rapidamente, e uma gravação curta preserva a rota, os termos e o estado visível que produziram o comportamento. O vídeo ajuda outra pessoa a repetir a observação sem depender de uma descrição que possa omitir um clique ou condição importante.

Um vídeo de reprodução pode provar que um erro afeta todos os utilizadores?

Não. Regista uma condição selecionada. O revisor deve declarar o comportamento de navegador observado com precisão e investigar o âmbito afetado separadamente, em vez de generalizar uma gravação numa afirmação sobre todas as contas, rotas ou dispositivos.

Cole um URL, descreva um fluxo e obtenha um vídeo de demonstração da sua aplicação web.

Os primeiros 60 segundos de vídeo são gratuitos, com marca de água. Verifique o seu correio eletrónico para descarregar o vídeo.