Criar um teste a partir de um prompt
Descreva o fluxo para o Claude, o ChatGPT ou um modelo de IA local que fornecemos ou que você traz, e ele grava, verifica e executa o teste na sua tela, edita um teste existente no lugar, ou cria um a partir de um design do Figma.
Testes criados a partir de um prompt
Descreva um fluxo ao seu assistente de IA, o Claude, o ChatGPT ou um modelo de IA local, fornecido por nós ou trazido por você, e ele grava o teste para você: abre o aplicativo ou a página web no seu computador, realiza as etapas como cliques e teclas reais, verifica enquanto avança e salva um teste comum do GUI Test Studio.Abra-o no GUI Test Studio, execute-o no GUI Test Runner-Recorder, coloque-o no seu pipeline com o gtr-cli: nada no teste diz que um modelo o criou.
É a segunda forma de criar um teste, ao lado de gravá-lo você mesmo: o resultado é o mesmo teste de qualquer forma.O assistente também edita um teste existente no lugar, cria um teste a partir de um design do Figma, executa um teste e mostra o Relatório de confiança dele.
Funciona no Claude Desktop, no Claude Code (o terminal e suas extensões para VS Code e JetBrains), no ChatGPT com o Codex (o aplicativo de desktop do ChatGPT, a linha de comando do Codex e a extensão do Codex para VS Code) e no Copilot Chat do VS Code.Sem nenhum assistente, um modelo de IA local roda neste computador, um que fornecemos no mecanismo integrado do GUI Test Studio ou um que você traz, e cria o teste com exatamente as mesmas ferramentas.O conector é instalado com o GUI Test Studio; ele precisa apenas da sua conta conectada neste computador, na avaliação gratuita ou em um plano pago, e de mais nada: nenhuma chave, nenhuma configuração.Esta página diz Claude; o ChatGPT e um modelo local fazem o mesmo.
A janela Criar teste a partir de um prompt
No GUI Test Runner-Recorder, clique em Criar teste a partir de um prompt: ele fica ao lado de Gravar na página inicial, no cartão Criar um novo teste, e na barra de ferramentas.Os dois aplicativos também o têm em Ajuda, Usar com Claude ou ChatGPT....A janela tem quatro partes, de cima para baixo.
1. O que o teste deve fazer?
Escreva o que o teste deve fazer e verificar, como você explicaria a um testador.A caixa é tudo o que o assistente recebe, então diga o nome do aplicativo ou o endereço, as etapas e o resultado esperado.
2. Ou comece por um exemplo
Seis blocos tracejados preenchem a caixa com um pedido pronto: Aplicativo inteiro, Um fluxo, Navegadores e dispositivos, Executar um teste, Alterar um teste e A partir de um design do Figma.Para os dois primeiros, a linha Para diz o que você testa: um aplicativo de desktop, um aplicativo web ou um aplicativo no seu celular.Todo exemplo começa com “Com o GUI Test Studio, ...” e marca entre « » o que deve ser substituído; a primeira parte fica selecionada, então você só precisa digitar por cima.
3. Execute este prompt com seu assistente de IA
Um cartão por assistente: Claude Desktop, Claude Code, ChatGPT e Codex e VS Code, cada um com seu estado e um botão que faz o que vem a seguir.
| O cartão diz | O botão |
|---|---|
| Não instalado | Obter: abre a página de download do assistente. |
| Ainda não conectado | Conectar: o conector do GUI Test Studio é adicionado às configurações do assistente para você, sem nada para digitar e nenhum arquivo para editar.O Claude Desktop ou o aplicativo do ChatGPT que estava aberto mostra Reiniciar e abrir, e faz as duas coisas. |
| Conectado | Abrir: o prompt chega ao assistente.O Claude Desktop abre um novo chat com o prompt já digitado (leia-o, pressione Enter), o Claude Code e o Codex abrem em um console com ele como primeira mensagem, o aplicativo do ChatGPT abre com ele na área de transferência (inicie uma conversa do Codex, cole-o), o VS Code abre o Copilot Chat no modo agente com ele. |
O Claude Code é um único cartão para o terminal e para suas extensões para VS Code e JetBrains: eles executam o mesmo programa e compartilham a conexão.ChatGPT e Codex também é um único cartão: o aplicativo de desktop do ChatGPT, a linha de comando do Codex e a extensão do Codex para VS Code leem uma mesma configuração, então um único Conectar serve aos três; o ChatGPT na web e no celular não consegue alcançar um programa no seu computador.O cartão do VS Code é o modo agente do Copilot Chat.
Qualquer outro assistente que aceite um conector também funciona: Copiar o caminho do conector, abaixo dos cartões, copia o único comando de que o assistente precisa; cole-o onde ele pedir um conector.Em outro computador, ou em um terminal seu, este único comando faz a configuração do Claude Code (o “?” da janela o mostra):
claude mcp add --transport stdio --scope user gui-test-studio -- "C:\Program Files\GUI Test Studio\Runner\gts-mcp.exe"E este faz a configuração do ChatGPT e do Codex (o aplicativo do ChatGPT o lê ao iniciar):
codex mcp add gui-test-studio -- "C:\Program Files\GUI Test Studio\Runner\gts-mcp.exe"Para um único projeto, um arquivo .mcp.json na raiz do projeto faz o mesmo para o Claude Code, e um arquivo .vscode/mcp.json para o VS Code.
4. Ou crie neste computador
O cartão Este computador, abaixo dos assistentes, cria o teste com um modelo de IA local, fornecido por nós ou trazido por você: Configurações... o configura uma vez, Criar aqui começa.Veja a próxima seção.
Neste computador, com um modelo de IA local
Nenhum assistente de IA é necessário: o cartão Este computador cria o teste com um modelo de IA local, um que fornecemos no mecanismo integrado do GUI Test Studio ou um que você traz pelo LM Studio ou por qualquer servidor local compatível com a OpenAI.Seu pedido e sua tela nunca saem do computador, e não há conta em uma empresa de IA nem custo por teste.O modelo recebe exatamente as mesmas ferramentas que o Claude e o ChatGPT recebem, então o teste é do mesmo tipo.
Configure uma vez
Clique em Configurações... no cartão Este computador.A janela diz o que esperar, mostra a placa de vídeo e a memória deste computador, e recomenda o modelo que roda melhor nele.Clique em Configurar para mim, ou escolha outro modelo e clique em Baixar: ele é baixado uma vez, direto de quem o publica, e guardado para todos os testes.
| Configuração | O que faz |
|---|---|
| Provedor | Integrado ao GUI Test Studio, a escolha recomendada, ou um servidor local: um servidor compatível com a OpenAI que você já executa, como o LM Studio ou o Ollama, no endereço dele, com um dos modelos dele. |
| Modelo e Precisão | Qual modelo cria o teste, e em que forma: uma precisão maior lê a tela um pouco melhor e precisa de mais memória. |
| Avançado: Janela de contexto | Quanto da conversa o modelo guarda de uma vez, 32768 por padrão.Um servidor local precisa carregar o modelo dele com o mesmo número. |
| Avançado: Tempo limite por etapa | Quanto tempo uma etapa do modelo pode levar antes que a execução desista. |
Essas escolhas são separadas das da Análise inteligente com IA: um modelo pode criar seus testes aqui enquanto outro, ou um provedor na nuvem, explica as asserções reprovadas.
Crie o teste
Escreva o prompt, depois clique em Criar aqui.Um cartão no canto da tela nomeia cada etapa à medida que o modelo a realiza.Tire as mãos do mouse e do teclado enquanto isso: o cartão sai da frente enquanto o modelo clica e digita, e nunca aparece nas imagens do teste.No final, ele diz onde o teste foi salvo e se ele passou, com Abrir no GUI Test Studio e Mostrar na pasta.
O que pedir
Diga o que o teste deve fazer e o que ele deve verificar, como você explicaria a um testador:
Open the calculator, compute 5 + 5 and verify the result shows 10.Create a test for my app C:\Apps\Shop.exe: add a client named Atlas Textiles and verify it is listed.Test the sign-up form at https://shop.example/signup in Chrome, Edge and Firefox and on an iPhone 15.Run the Checkout test and tell me what failed.With GUI Test Studio, test the whole of C:\Apps\Shop.exe: list its main workflows and create one test per workflow, each verifying its outcome.Show me the report of the Checkout test.In the Checkout test, rename the check "Visual Assert #3" to "Pay button" and let it wait 10 s.Create a test from my Figma design C:\Designs\Login.gtsdesign.Comece com “Com o GUI Test Studio, ...” quando o aplicativo a quem você pede puder fazer de outro jeito: as tarefas comuns da janela formulam assim todos os pedidos.Para um aplicativo em um celular Android conectado por USB (com a depuração USB ativada), diga “no meu celular”: o teste mostra o celular em uma janela nesta tela e o Claude trabalha por essa janela.
Toda tarefa termina do mesmo jeito: o Claude diz onde o teste foi salvo e o veredito da execução dele, e pergunta o que vem a seguir, se deve executá-lo de novo, editá-lo no GUI Test Studio ou abri-lo no GUI Test Runner-Recorder para ler o Relatório de confiança dele.Uma execução que falha é explicada a partir do relatório, nunca respondida gravando o teste de novo, a menos que você peça isso.
Diga “edite o teste no GUI Test Studio” e o Claude o abre ali; “abra no GUI Test Runner-Recorder” abre a janela em que você mesmo o executa; “mostre o relatório” abre o teste ali com o Relatório de confiança mais recente na tela.O menu de prompts do seu aplicativo do Claude (o “+” no Claude Desktop) lista os pedidos comuns, criar um teste, testar uma página web em vários navegadores, testar um aplicativo inteiro, executar, editar, abrir no GTR, cada um ocupando uma linha curta; os detalhes vão no chat.
O Claude faz exatamente o fluxo que você pediu.Ele só explora um aplicativo por conta própria quando você pede (“teste todos os recursos básicos deste aplicativo”), e então cria um teste por fluxo que encontrar, cada um com seus próprios cenários e asserções.
O que o assistente faz na sua tela
Tire as mãos do mouse e do teclado enquanto o Claude trabalha: ele usa a tela real.Ele inicia o aplicativo ou abre a página, olha a tela, clica e digita, e depois de cada etapa verifica o resultado como o gravador faria.O tempo que o Claude passa pensando entre duas etapas fica fora do teste; uma pausa que o Claude pede de propósito vira uma etapa de Espera.
| O Claude pode | O que isso vira no teste |
|---|---|
| Clicar, digitar, pressionar teclas, rolar, arrastar, mover o mouse | Eventos do mouse e do teclado, cada um com as asserções visuais que o gravador adiciona sozinho. |
| Verificar um texto, o formato de um valor, uma contagem, uma imagem, uma ausência, uma disposição, uma caixa de diálogo inteira | Asserções textuais, textuais dinâmicas, de contagem, visuais, visuais de ausência, de layout e de grupo: cada asserção é testada na hora e recusada se não puder passar. |
| Agrupar etapas e deixar notas | Cenários (aninhados se preciso) e marcadores na linha do tempo. |
| Adicionar uma etapa que não é uma interação | Executar aplicativo, Fechar aplicativo, Executar JavaScript, Executar script Python, Enviar arquivo, Ficar offline / Ficar online. |
| Desfazer uma ação errada, pausar para voltar o aplicativo a um estado | Nada disso entra no teste. |
| Executar um teste salvo, ler o que ele contém, abri-lo no GUI Test Studio | A mesma execução que o GUI Test Runner-Recorder faz, com o Relatório de confiança ao lado do teste. |
| Mostrar o relatório para você | O teste abre no GUI Test Runner-Recorder com o Relatório de confiança mais recente na tela. |
| Editar um teste existente | A mudança que você pediu, feita no lugar depois que você confirma: nada é gravado de novo. |
| Adicionar uma asserção a um teste salvo | Uma nova asserção, testada primeiro na própria gravação do teste naquele momento e recusada se não puder passar ali. |
| Ver por que uma execução falhou, e desde quando | O que cada falha esperava e encontrou, com as imagens e o que a Análise inteligente com IA disse; todas as execuções anteriores, e se o teste é instável. |
| Aceitar o que uma execução encontrou, depois que você concordar | O que o teste espera dali em diante, como faz o Aceitar do Relatório de confiança. |
| Escrever um relatório de bug | Um relatório em PDF ou Excel com suas evidências, ou uma issue do Jira depois que você confirmar. |
| Preparar um teste para um pipeline | Um teste somente de execução (.GTR), e o comando e o trecho de pipeline para sua ferramenta de CI. |
| Criar um teste a partir de um design do Figma | A importação que o GUI Test Studio faz do pacote de design: uma asserção por elemento, o caminho de cliques de um fluxo do protótipo. |
O teste vai para Documentos\GUI Test Studio, a menos que você indique outra pasta, em uma pasta própria, com os resultados ao lado.
Editar um teste existente por prompt
O Claude pode alterar um teste que você já tem sem gravá-lo de novo: renomear uma etapa, mudar o texto que uma asserção espera, dar a uma asserção um tempo limite maior, decidir o que acontece se ela falhar, remover ou ignorar uma etapa, adicionar uma espera, mudar o nome ou a descrição do teste.Diga o nome do teste e o que mudar:
In the Checkout test, let the "Order confirmed" check wait 10 s and continue the test if it fails.In the Sign in test, ignore the step that clicks "Remember me", and add a 2 s wait before the Sign in click.Rename the Checkout test to "Checkout with a coupon" and describe it as the coupon scenario.Ele também pode mudar onde uma asserção busca, quão rigorosa é uma comparação de imagens e o que é dito à IA sobre uma asserção, mover uma etapa, agrupar etapas em um cenário e adicionar uma etapa do Fluxo do teste ou um marcador.Uma nova asserção é testada primeiro na própria gravação do teste naquele momento, e recusada se não puder passar ali.
In the Checkout test, also verify that the total is shown after step 12.In the Checkout test, group steps 3 to 9 as a Scenario called Payment.Antes de escrever qualquer coisa, o Claude mostra o que vai mudar e pede que você confirme, todas as vezes: uma edição sobrescreve o arquivo do teste.Gravar o teste inteiro de novo só acontece quando você pede.Depois, abra o teste no GUI Test Studio para ver a mudança na linha do tempo: uma edição por prompt é uma edição comum do teste, e a próxima execução a usa.
Depois de uma execução: por que ela falhou, e o que fazer
Pergunte o que falhou e o Claude lê os resultados da própria execução, sem executar nada: o que cada asserção esperava e o que a execução encontrou, com as imagens e cada diferença contornada, e o que a Análise inteligente com IA disse.Ele também lê o histórico do teste: desde quando ele falha, e se ele oscila entre passar e falhar.
Why did the Checkout test fail? Show me the difference.When did the Checkout test start failing? Is it flaky?The new button is correct: accept what the last run found.File this failure as a Jira bug in project SHOP.Run the Checkout test from step 12 on, and retry it once if it fails.Put the Checkout test in TeamCity.O Claude não decide nada por você.Aceitar um resultado torna correto, dali em diante, o que a execução encontrou, e uma issue do Jira é lida por outras pessoas: as duas coisas só acontecem depois que você confirma o que o Claude mostra.Um relatório em PDF ou Excel é escrito na hora.
Um teste a partir de um design do Figma
Dê ao Claude o pacote de design que seu designer exportou com o plugin do Figma da suíte, um arquivo .gtsdesign, e ele cria um teste a partir dele pela mesma importação que o GUI Test Studio oferece: cada tela vira uma imagem de referência, cada elemento uma asserção, e um fluxo do protótipo vira o caminho de cliques.O design de uma página de login dá um teste do cenário de login, pronto antes de o recurso ser construído.
Create a test from C:\Designs\Login.gtsdesign, following its prototype flow.O design é exportado do Figma como explica Importar um design do Figma; o que o teste pode fazer antes de o recurso existir está em Testar um recurso antes que ele exista.
Aplicativos web: navegadores, dispositivos, condições
Para uma página web, peça os outros navegadores, dispositivos e condições na mesma frase (“no Edge e em um iPhone 15, em francês e com zoom de 150%”): o Claude grava a página uma vez, gera o teste para cada combinação depois de salvo, e pode executar cada uma.A gravação roda com uma janela de navegador, como foi gravada; os navegadores e dispositivos gerados rodam sem janela.
Um teste web salvo pode pedir mais navegadores e dispositivos depois, e gerá-los de novo depois que a página mudou.Gerar um de novo substitui o que ele contém, então o Claude pergunta antes.
Todos os navegadores e dispositivos a partir de uma gravação
O que o assistente pode e não pode fazer
| Regra | Por quê |
|---|---|
| Somente um computador conectado, na avaliação gratuita ou em um plano pago | O conector consulta sua conta a cada pedido; uma avaliação gratuita que terminou ou uma saída da conta o interrompe na hora. |
| O Claude vê ferramentas, nunca o mecanismo | Ele recebe o que um testador faz (clicar, verificar, executar); como uma asserção é avaliada fica dentro do GUI Test Studio. |
| Nada é explorado a menos que você peça | Um teste é o que você descreveu, nada mais. |
| Uma asserção que falharia agora é recusada | Assim o teste que você recebe passa na tela em que foi criado. |
Se algo não funcionar
| O que você vê | O que fazer |
|---|---|
| O Claude diz que o GUI Test Studio recusa porque ninguém entrou | Entre pelo GUI Test Studio ou pelo GUI Test Runner-Recorder, depois peça de novo. |
| O Claude diz que é necessária uma atualização do GUI Test Studio | Inicie qualquer um dos aplicativos: ele baixa e instala a atualização, e o Claude volta a funcionar. |
| O Claude Desktop não oferece o GUI Test Studio | Abra Criar teste a partir de um prompt (ou Ajuda > Usar com o Claude...), clique em Conectar no cartão do Claude Desktop, depois em Reiniciar e abrir.Depois de conectado, ele aparece em Configurações > Conectores, como GUI Test Studio. |
| Onde o GUI Test Studio aparece no VS Code | Na lista de ferramentas do Copilot Chat (o botão de ferramentas do chat) e no comando MCP: List Servers; no Claude Code, digite /mcp. |
| O aplicativo do ChatGPT não oferece o GUI Test Studio | Clique em Conectar no cartão ChatGPT e Codex, depois em Reiniciar e abrir: o aplicativo lê as configurações ao iniciar.Depois de conectado, ele aparece em Settings > MCP servers; em um terminal, codex mcp list o mostra. |
| O Claude Desktop mostra uma nota de cautela ao lado do pedido | É a nota dele para qualquer pedido que chega por um link, nada do GUI Test Studio: leia o pedido e envie-o. |
| O Claude respondeu sem o GUI Test Studio | Comece o pedido com “Com o GUI Test Studio, ...”(as tarefas comuns da janela fazem isso), ou diga “teste”: um simples “abra X e verifique Y” também é um teste, e o conector diz isso ao Claude. |
| O cartão Este computador diz que nenhum modelo foi baixado | Clique em Configurações..., depois em Configurar para mim: o modelo recomendado é baixado uma vez, e Criar aqui fica pronto. |
| O modelo local é lento ou não termina | Peça um fluxo mais curto, escolha um modelo menor em Configurações..., fornecido por nós ou trazido por você, ou clique em Usar o Claude ou o ChatGPT no lugar... no cartão: os assistentes na nuvem criam testes longos muito mais rápido. |
| O teste falha na execução seguinte | Abra-o no GUI Test Studio: cada asserção que o Claude adicionou fica na faixa Verifications, e o Relatório de confiança diz qual e por quê. |
O log do próprio conector é %LOCALAPPDATA%\GUI Test Studio\logs\claude-connector.log.
Ainda com problemas?Conte o que você estava tentando fazer, e respondemos em até um dia útil.Ask our team