Navegador da web - Amazon Quick

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Navegador da web

Visão geral do

As ações do navegador fornecem um kit de ferramentas de automação abrangente para realizar interações na web. As sessões do navegador são gerenciadas automaticamente — abertas, mantidas e fechadas conforme necessário. O Quick Automate oferece suporte à identificação flexível de elementos por meio de descrições em linguagem natural baseadas em IA e seletores precisos. XPath Os principais recursos incluem segmentação inteligente de elementos com mecanismos alternativos, recursos de autorrecuperação que manipulam automaticamente pop-ups e repetem ações malsucedidas, extração de dados, incluindo conteúdo estruturado de tabelas, e um conjunto completo de métodos de interação, desde cliques e digitação básicos até tarefas avançadas de várias etapas orientadas por IA.

Métodos de identificação de elementos

  • Método de descrição: usa IA para identificar elementos usando descrições em linguagem natural (por exemplo, “botão de login”), tornando as automações mais resilientes às alterações da interface do usuário.

  • XPath método seletor: usa XPath expressões precisas para o direcionamento exato do elemento (por exemplo,//button[text()='Log in']).

  • Abordagem combinada: Quando os dois métodos estão habilitados, XPath é testada primeiro antes de recorrer ao método de descrição, combinando precisão com adaptabilidade.

Recursos de autorrecuperação disponíveis para digitação e cliques

  • HandlePopups: detecta e processa automaticamente diálogos inesperados, avisos de cookies e sobreposições, evitando que elementos de bloqueio interrompam fluxos de trabalho.

  • ValidateAndRetry: verifica o sucesso da ação por meio da comparação de capturas de tela e de novas tentativas, se necessário, reduzindo falhas falsas.

Gerenciamento de sessão do navegador

As instâncias do navegador são criadas automaticamente, mantidas em todos os fluxos de trabalho e devidamente limpas quando concluídas. A restart_browser ação permite novas sessões quando necessário para cenários como tempos limite de login ou expiração da sessão.

Iniciar sessão do navegador

Abre uma nova sessão do navegador. As ações dentro de seu escopo interagem com esse navegador. O navegador fecha automaticamente ao terminar.

Propriedades:

  • Título da ação (somente texto): o título da ação exibida na visualização do processo (padrão: Navegador)

nota
  1. Todas as ações do navegador devem ser colocadas dentro do escopo de uma sessão do navegador

  2. Cada escopo do navegador é uma sessão do navegador. O navegador fecha automaticamente quando as ações dentro de um escopo são concluídas.

Vá para a página da Web

Navega até um URL específico. Usado para acessar uma nova página da Web na guia atual do navegador.

Propriedades:

  • URL (obrigatório): o endereço da web para o qual navegar (por exemplo, “exemplo.com”) Observação: forneça o URL completo ao trabalhar com isso.

Clique em

Clica em um elemento da página da web. Usado para interagir com botões, links ou outros elementos clicáveis.

Propriedades:

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural do elemento do navegador no qual clicar (por exemplo, “botão Enviar”). Não use a ação no elemento, apenas a descrição do elemento

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//input [@id ='xyz']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

  • Botão do mouse (lista suspensa): em qual botão do mouse clicar - Esquerda, Central ou Direita (padrão: Esquerda, opcional)

  • Tipo de clique (menu suspenso): clique único ou duplo (padrão: único, opcional)

  • Obter download do arquivo (botão de rádio): Ative se o clique fizer o download de um arquivo (padrão: DESLIGADO, opcional)

  • Arquivo baixado (saída, exigido condicionalmente): nome da variável que armazena o arquivo baixado (padrão: downloaded_file)

Identificação do elemento:

  • Pelo menos um método de identificação de elementos deve ser ativado

  • Quando os dois métodos estão habilitados, o XPath seletor é tentado primeiro antes de retornar à descrição

Inserir texto

Digita texto em um campo de entrada. Usado para preencher formulários, caixas de pesquisa ou outras entradas de texto em páginas da web.

Propriedades:

  • Texto a ser inserido (obrigatório): o texto que você deseja digitar no campo (por exemplo, “Pedido #12345 “)

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural (por exemplo, “campo de número do pedido”)

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//input [@id ='xyz']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

  • Substituir texto existente (caixa de seleção): limpe qualquer texto preexistente no campo antes de digitar (padrão: ATIVADO)

Identificação do elemento:

  • Pelo menos um método de identificação de elementos deve estar ativado. É recomendável usar a descrição do elemento e ir para o seletor de elementos somente se necessário.

Insira a credencial

Digite um nome de usuário ou senha. Usado para fazer login com segurança em um site usando credenciais salvas.

Propriedades:

  • Credencial (lista suspensa, obrigatória): escolha qual credencial salva usar no grupo de automação

  • Valor a ser inserido (menu suspenso, obrigatório): escolha se deseja inserir nome de usuário ou senha (padrão: nome de usuário)

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural (por exemplo, “Campo de nome de usuário”)

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//input [@id ='username']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

Identificação do elemento:

  • Pelo menos um método de identificação de elementos deve ser ativado

Selecione no menu suspenso

Escolhe um valor em uma lista suspensa. Usado para fazer seleções em formulários, filtros ou outros menus suspensos em páginas da web.

Propriedades:

  • Valor a ser selecionado (obrigatório): a opção que você deseja selecionar no campo suspenso (por exemplo, “Concluído”)

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural (por exemplo, “Lista suspensa de status do pedido”)

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//select [@id ='xyz']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

Identificação do elemento:

  • Pelo menos um método de identificação de elementos deve ser ativado

Extrair texto

Lê um valor de uma página da Web. Usado para capturar o texto de um campo individual.

Propriedades:

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural (por exemplo, “Campo de valor total”)

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//input [@id ='xyz']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

  • Texto extraído (saída): nome da variável que armazena o texto extraído (padrão: texto_extraído)

Identificação do elemento:

  • Pelo menos um método de identificação de elementos deve ser ativado

Extrair tabela

Lê dados de uma tabela de páginas da Web. Usado para capturar informações estruturadas encontradas em tabelas.

Extrai de forma inteligente dados estruturados de páginas da Web usando segmentação ou seletores de linguagem natural. XPath Os recursos incluem extração aprimorada por IA, extração de vários atributos (texto, links etc.), geração automática de colunas para atributos e saída de tabela de dados para manipulação programática.

Propriedades:

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural (por exemplo, “Tabela de detalhes do pedido”)

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//table [@id ='xyz']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

  • Extrair várias páginas (botão de rádio): continue extraindo dados de páginas adicionais, se existirem (padrão: DESLIGADO, opcional)

  • Seletor do botão Próxima Página (exibido condicionalmente): XPath expressão para o botão da próxima página (por exemplo, “//* [@id ='NextButton']”, opcional)

  • Extração inteligente de dados (caixa de seleção): use a IA para extrair e estruturar dados de tabelas complexas (padrão: ATIVADO). Não use para tabelas grandes de 100 linhas ou mais. Essa opção deve ser usada para tabelas complexas ou estruturas semelhantes a tabelas, nas quais a extração normal de tabelas de um navegador da Web falha

  • Dados a serem extraídos (menu suspenso de seleção múltipla): escolha o que extrair: texto, links (Href) ou seletores de elementos (Xpath) (padrão: texto, opcional)

  • Tabela extraída (saída): nome da variável que armazena a tabela de dados extraída (padrão: extracted_table)

Identificação do elemento:

  • Pelo menos um método de identificação de elementos deve ser ativado

Notas de uso:

  • Tipos de dados adicionais são salvos em colunas separadas (por exemplo, ColumnName_href para links)

  • Desative a extração inteligente para tabelas com mais de 100 linhas para melhorar o desempenho

Faça uma captura de tela

Captura uma imagem da página da web. A captura de tela é salva em um arquivo para ser usada posteriormente em seu processo.

Propriedades:

  • Nome do arquivo (opcional): nome do arquivo de imagem salvo. Gerado automaticamente se estiver vazio (por exemplo, “Imagem de captura de tela”)

  • Tipo de arquivo (menu suspenso): escolha o formato da imagem - PNG ou JPEG (padrão: PNG, opcional)

  • Arquivo de captura de tela (saída): nome da variável que armazena o arquivo de captura de tela (padrão: screenshot_file)

Perguntas e respostas visuais

Responda a perguntas sobre uma página da web. Usa IA para analisar visualmente a página e responder true/false perguntas sobre o conteúdo.

Propriedades:

  • Pergunta (obrigatória): Insira sua true/false pergunta sobre o conteúdo da página da web (por exemplo, “O produto está em estoque?”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

  • Resposta (saída): nome da variável que armazena a true/false resposta (padrão: is_true)

Clique e faça upload de arquivos

Carrega arquivos em uma página da web. Usado para automatizar os seletores de arquivos clicando em um botão de upload de arquivo e escolhendo os arquivos a serem carregados.

Propriedades:

  • Arquivos a serem carregados (obrigatório): a lista de arquivos a serem carregados, normalmente armazenada em uma variável (por exemplo, [meu_arquivo1, meu_arquivo2])

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural (por exemplo, “Botão de upload”)

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//input [@id ='xyz']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

  • Botão do mouse (lista suspensa): em qual botão do mouse clicar - Esquerda, Central ou Direita (padrão: Esquerda, opcional)

  • Tipo de clique (menu suspenso): clique único ou duplo (padrão: único, opcional)

Requisitos de arquivo:

  • Deve ser uma matriz de media/file objetos

Identificação do elemento:

  • Pelo menos um método de identificação de elementos deve ser ativado

Digite o pressionamento de tecla

Envia um comando ou atalho de tecla. Usado para automatizar a digitação de teclas individuais ou combinações de teclas em uma página da web.

Propriedades:

  • Teclas especiais (menu suspenso, obrigatório): selecione modificadores como Ctrl, Alt, Shift ou pressionamentos de teclas singulares como Enter, Tab, Pagedown

  • Tecla de comando (opcional): insira a tecla a ser usada em combinação com a tecla especial (por exemplo, “c” para Ctrl+c)

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural (por exemplo, “Barra de pesquisa”)

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//input [@id ='xyz']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

Identificação do elemento:

  • Ambas as alternâncias de elemento podem estar DESLIGADAS - o pressionamento de tecla é enviado para o campo ativo atual se nenhum elemento for definido

Aguarde o elemento

Verifica a exibição de um elemento. Usado para aguardar alterações ou validar condições em uma página da web. Retorna verdadeiro se o elemento for encontrado dentro do tempo máximo de espera e falso se não for encontrado.

Propriedades:

  • Título da ação (somente texto): nome de exibição da ação

  • Seletor de elementos (obrigatório): XPath expressão para definir o elemento que você deseja verificar (por exemplo, “//input [@id ='xyz']”)

  • Tempo máximo de espera (opcional): tempo máximo de espera em segundos até que o elemento apareça (padrão: 30)

  • Elemento encontrado (saída): nome da variável que armazena se o elemento foi encontrado (verdadeiro/falso) (padrão: is_found)

Validação:

  • O tempo máximo de espera deve ser um número inteiro ou decimal

Encontre elementos correspondentes

Obtém elementos que correspondem a um padrão. Usado para obter uma lista de elementos semelhantes em uma página da Web que você pode processar um por um.

Propriedades:

  • Seletor de elementos (obrigatório): XPath expressão para definir o padrão dos elementos que você deseja obter (por exemplo, “//div [@class ='abc']”)

  • Lista de elementos (saída): nome da variável que armazena a lista de elementos encontrados (padrão: element_list)

Notas de uso:

  • A lista ficará vazia se nenhum elemento correspondente for encontrado

  • Use para processar vários elementos semelhantes, como resultados de pesquisa ou hiperlinks

Aguarde a nova janela

Verifica se há uma nova janela para abrir. Usado após clicar em um link ou botão que abre uma nova janela secundária na sessão atual do navegador.

Propriedades:

  • Tempo máximo de espera (opcional): tempo máximo de espera em segundos até que a nova janela apareça (padrão: 30)

  • Identificador de janela (saída): nome da variável que armazena o identificador da nova janela (padrão: window_id)

Notas de uso:

  • Se o tempo exceder e a janela não for encontrada, ocorrerá uma exceção

  • O identificador de janela pode ser usado para mudar o foco ou fechar a janela

Validação:

  • O tempo máximo de espera deve ser um número inteiro ou decimal

Janela Switch

Altera as janelas do navegador. Depois de mudar o foco para a janela especificada, as ações subsequentes do navegador interagem com essa janela.

Propriedades:

  • Identificador de janela (opcional): a janela para a qual você deseja alternar, normalmente armazenada em uma variável (por exemplo, window_id). Deixe em branco para mudar para a janela principal

Fechar janela

Fecha a janela do navegador. Depois de fechada, a automação retorna à janela principal da sessão atual do navegador.

Propriedades:

  • Identificador de janela (obrigatório): a janela que você deseja fechar, normalmente armazenada em uma variável (por exemplo, window_id)

Salvar na área de transferência

Copia o texto para a prancheta. Usado para salvar texto que você pode colar mais tarde. O texto existente da prancheta é substituído.

Propriedades:

  • Texto para salvar (obrigatório): o texto que você deseja copiar para a área de transferência (por exemplo, “Pedido #12345 “)

Colar da prancheta

Insere texto da área de transferência. Usado para colar texto copiado nos campos da página da web.

Propriedades:

  • Localizar elemento com descrição (botão de rádio): use a descrição em linguagem natural para identificar o elemento com IA (padrão: ON)

    • Campo de descrição (obrigatório condicionalmente): descrição em linguagem natural (por exemplo, “campo de número do pedido”)

  • Localizar elemento com seletor (botão de rádio): Use a XPath expressão para identificar o elemento (padrão: OFF)

    • XPath Campo (obrigatório condicionalmente): XPath expressão (por exemplo, “//input [@id ='xyz']”)

  • Autorrecuperação (caixa de seleção): use a IA para lidar automaticamente com pop-ups inesperados (padrão: DESLIGADO, opcional)

  • Substituir texto existente (caixa de seleção): limpe qualquer texto preexistente no campo antes de colar (padrão: ATIVADO)

Identificação do elemento:

  • Pelo menos um método de identificação de elementos deve ser ativado

Atualizar página da Web

Recarrega a página da web atual. Algumas páginas podem ser redirecionadas na atualização.

Propriedades:

  • Título da ação (somente texto): nome de exibição da ação

Reinicie o navegador

Fecha e reabre o navegador. Uma nova sessão começa em uma página em branco.

Propriedades:

  • Reiniciar tudo (caixa de seleção): feche e reinicie todas as janelas do navegador, não apenas a atual (padrão: DESLIGADO, opcional)

Limitações

Incerteza na identificação do elemento: se a IA não puder identificar de forma confiável os elementos da interface do usuário, as ações falharão com erros LowConfidence “”. Nesses casos, use XPath seletores ou descrições de elementos mais específicos. Compatibilidade do navegador: o sistema opera exclusivamente com instâncias do navegador Chrome e utiliza o Playwright como estrutura de automação subjacente, o que significa que a compatibilidade é limitada às tecnologias da web compatíveis com o Chrome e pode não funcionar com recursos específicos do navegador de outros fornecedores. Desafios de conteúdo dinâmico: páginas altamente dinâmicas com mudanças frequentes de layout, JavaScript estruturas pesadas ou aplicativos complexos de página única podem exigir tempos de espera adicionais, lógica de repetição ou abordagens de tratamento especializadas. Sobrecarga de desempenho: recursos baseados em IA, como segmentação por elementos de linguagem natural e recursos de autorrecuperação, exigem mais tempo de processamento do que a segmentação direta. XPath