Teste de Fumaça do Gateway de Tempo de Execução do Agente

Use este fluxo de trabalho quando uma tarefa de agente é executada em um sandbox remoto que chama de volta para uma API local através de um gateway. Ele verifica todo o caminho sem depender de ferramentas conectadas ou dados de produção privados.

Quando Ativar

• Uma API de agente local precisa de uma verificação de tempo de execução de ponta a ponta.
• Uma tarefa trava após o despacho e o gateway ou túnel podem estar inacessíveis.
• Um aplicativo web está temporariamente apontado para uma API local para testes de agente.
• Um teste anterior deixou o aplicativo web apontado para uma API parada.

Entradas Necessárias

• Instruções relativas ao repositório para iniciar a API e o aplicativo web.
• O caminho da rota do gateway e sua resposta anônima esperada.
• Um agente de teste isolado, um prompt sem ferramentas e sua resposta esperada exata.
• Uma maneira de inspecionar o status da tarefa e confirmar que um callback atingiu a API local.
• Credenciais do provedor, fornecidas através do armazenamento de segredos normal do projeto. Nomeie os provedores na documentação compartilhada; nunca copie valores de credenciais na skill ou no relatório de teste.

Se essas entradas não estiverem disponíveis, relate a entrada ausente em vez de adivinhar um endpoint ou usar uma conta real.

Autorização e Limpeza

Confirme a autorização para expor a API de teste local através do provedor de túnel selecionado, despache a tarefa de teste e altere temporariamente a rota do aplicativo web. Use um aplicativo web local isolado ou implantação de teste; não alterne um aplicativo de produção compartilhado como parte deste teste de fumaça. Mantenha o acesso ao túnel restrito à rota autenticada necessária.

Instale a limpeza antes de alterar a rota: em caso de sucesso, erro, tempo limite, interrupção ou cancelamento, restaure o destino registrado e verifique a saúde antes de parar a API e o túnel. Rastreie apenas os IDs de processo ou recursos criados por este teste. Se a restauração falhar, relate imediatamente e mantenha as evidências necessárias para recuperação; não reivindique sucesso.

Teste de Fumaça

1. Registre e verifique a rota original. Anote o alvo atual da API do aplicativo web e verifique se ele está saudável. Mantenha este valor localmente para restauração. Confirme se o agente de teste e os dados estão isolados de usuários reais.
2. Inicie a API local e o túnel. Use um gerenciador de processos que manterá ambos ativos durante todo o teste. Verifique a saúde da API. Sonde a rota do gateway anonimamente e confirme a resposta de autenticação documentada, geralmente 401 ou 403. Confirme se a sonda aparece no log da API local; uma resposta de borda sozinha não prova que a API foi alcançada.
3. Alterne o aplicativo web somente após ambas as verificações passarem. Verifique se uma solicitação do aplicativo web atinge a API local. Verifique a rota novamente após qualquer reinicialização do servidor web ou recarga de configuração.
4. Execute uma tarefa sem ferramentas. Use um prompt curto com uma resposta esperada exata. Confirme se o sandbox remoto chamou o gateway local, a tarefa atingiu um estado terminal e a resposta retornada corresponde. Uma tarefa enfileirada ou em execução não é uma aprovação.
5. Restaure a rota original. Reconfigure o aplicativo web para seu alvo de API registrado, verifique se esse alvo e uma página representativa carregam, em seguida, pare a API de teste e o túnel. Se a restauração falhar, relate a rota quebrada imediatamente.

Exemplos de verificações, com valores fornecidos pelo projeto:

curl --silent --show-error --output /dev/null --write-out '%{http_code}\n' "$LOCAL_API_HEALTH_URL"
curl --silent --show-error --output /dev/null --write-out '%{http_code}\n' "$PUBLIC_GATEWAY_PROBE_URL"

O primeiro comando deve retornar o status saudável do projeto. O segundo deve retornar o status de autenticação anônima documentada e aparecer no log da API local. Não coloque uma credencial em nenhum URL.

Acompanhamento de Ferramenta Conectada

Execute um teste separado somente após a tarefa sem ferramentas ser aprovada. Use uma conexão de teste explícita e permissões. Relate a presença da conexão e as ações concedidas como fatos diferentes. Não infira que uma pesquisa de ação vazia significa que nenhum aplicativo está conectado. Não execute uma ação de escrita em uma conta real como um teste de fumaça.

Tratamento de Falhas

…