This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

Entrega

Test Automation

Suíte Playwright do seu repositório no executor isolado, testes escritos pela IA com aceite humano, regressão visual e o portão no CI.

#O que faz

Testes de interface e ponta a ponta em executor isolado, com regressão visual e relatórios.

FuncionalidadeO que fazNa área logada
E2E testsRoda a suíte Playwright que existe no seu repositório em executor isolado, em shards paralelos e nos navegadores escolhidos (Chromium, Firefox, WebKit), contra um ambiente com posse comprovada; cada falha volta classificada por regra (bug provável, instável, infraestrutura, teste quebrado), com trace, captura e vídeo, e serve de portão no CI (CLI, API e pipeline). Resumo por IA opcional, como sugestão./plataforma/entrega/testes
AI test authoringVocê descreve em português o que testar e aponta um ambiente com posse comprovada; um agente lê a página em modo somente leitura no executor do navegador e propõe um teste declarativo, com seletores por papel e rótulo acessível. A proposta só aparece como pronta depois de passar numa execução real (até 3 tentativas) e só vira teste salvo com o aceite de uma pessoa; o arquivo .spec.ts equivalente pode seguir para revisão pelo Code Automation. Quando um teste salvo quebra por seletor, o agente sugere o seletor novo com captura de antes e depois. Custo de IA pelo Gateway, com teto por pedido e por dia./plataforma/entrega/testes
Visual regressionCada captura dos cenários é comparada pixel a pixel com a baseline aprovada por uma pessoa, com tolerância por captura, imagem de diferença, telas de computador e de celular e histórico de instabilidade; diferença acima do limite ou dimensões diferentes falham a execução./plataforma/entrega/testes
Composable test plansPlanos de teste declarativos (lista fechada de ações, sem código) escritos com blocos reutilizáveis, parâmetros, linhas de dados e preparação por cenário, mais preparação e limpeza únicas por suíte. A plataforma expande a fonte num plano comum, que passa pelas mesmas regras de sempre, e a tela mostra cada execução passo a passo, com erro e capturas. Bloco editado não muda plano salvo: a tela avisa e uma pessoa gera a versão nova. Sem cofre para parâmetro sensível./plataforma/entrega/testes
Conditional, data and AI stepsPassos que deixam o plano declarativo cobrir fluxos reais: condição (if) com faixas então e senão, limpeza que roda mesmo depois de uma falha (finally), valor capturado de uma resposta JSON da própria origem, conferência no banco pelo conector de dados (somente leitura, só passou ou falhou), ação e conferência descritas em português e interpretadas pela IA a cada execução, e modo resiliente que troca um seletor quebrado na própria rodada. Pedidos à IA com teto de quantidade e de custo por execução./plataforma/entrega/testes
GitHub Actions, Jira and recordingAção do GitHub Actions que roda a suíte Playwright pela API v1 e usa o resultado como portão do workflow; ligação do workspace com o Jira Cloud para abrir um chamado a partir de uma execução que falhou, um por execução; e conversão do texto gravado com o npx playwright codegen num plano declarativo, sem executar nada./plataforma/entrega/testes

#Como ativar

  • Na área logada: o dono adiciona o Cortex em Produtos (veja Produtos e conta pré-paga). As telas ficam no menu do produto.
  • Pela API v1 e pela CLI: a organização precisa do Cortex ativo, de conta de faturamento válida e de uma chave de API ligada ao workspace, com o escopo da rota.
  • Cadastre o alvo (ambiente) e comprove a posse dele em Test Automation: a AIUBY só testa alvo com posse verificada.

Nota

Produto da plataforma não ativo ou módulo não liberado para a organização: a API v1 responde 404 not_found, como se a rota não existisse. Sem conta de faturamento válida: 402. Veja API v1.

#Primeiro uso

  1. Prepare a suíte

    O playwright.config usa baseURL: process.env.BASE_URL e projetos chromium, firefox, webkit.
  2. Rode pelo CI

    Chave com Rodar suítes Playwright no CI tests:run.
    bash
    curl -X POST https://aiuby.com/api/v1/tests/runs \
      -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
      -d '{"repo":"empresa/web","target":"https://staging.empresa.com.br","ref":"main","browsers":["chromium"],"shards":2}'
    
    aiuby tests run --suite empresa/web --target https://staging.empresa.com.br --shards 2 --wait
    aiuby tests status <id>
    Até 8 shards, 3 navegadores e 3 novas tentativas. gate volta pending, passed ou failed; cada falha vem classificada (bug provável, instável, infraestrutura, teste quebrado).

Para GitHub Actions, veja Portões no CI.

#Rotas da API

RotaEscopoPara quêCLI
GET /api/v1/engineering/test-plansLer a engenharia (API v1) engineering:readPlanos de teste declarativosaiuby test-plans list
POST /api/v1/tests/runsRodar suítes Playwright no CI tests:runDisparar a suíte Playwright do repositório (portão do CI)aiuby tests run
GET /api/v1/tests/runs/{id}Rodar suítes Playwright no CI tests:runEstado de uma execução de suíteaiuby tests status <id>

#O que ainda não existe

  • Rodar plano declarativo, aprovar baseline visual ou aceitar teste escrito pela IA pela API: a v1 só lista os planos.
  • Cofre para parâmetro sensível nos planos declarativos.
  • Ação no GitHub Marketplace: os arquivos da ação são entregues pela equipe.