View a markdown version of this page

웹 브라우저 - Amazon Quick
개요브라우저 세션 관리브라우저 세션 시작웹 페이지로 이동다시 시도하려면텍스트 입력자격 증명 입력드롭다운에서 선택텍스트 추출테이블 추출스크린샷 찍기시각적 Q&A파일 클릭 및 업로드키 입력 입력요소 대기일치하는 요소 찾기새 창 대기전환 창창 닫기클립보드에 저장클립보드에서 붙여넣기웹 페이지 새로 고침브라우저 다시 시작제한 사항

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

웹 브라우저

개요

브라우저 작업은 웹 상호 작용을 수행하기 위한 포괄적인 자동화 툴킷을 제공합니다. 브라우저 세션은 필요에 따라 열리고 유지 관리되며 닫힙니다. Quick Automate는 AI 기반 자연어 설명과 정확한 XPath 선택기를 통해 유연한 요소 식별을 지원합니다. 주요 기능에는 폴백 메커니즘을 사용한 지능형 요소 타겟팅, 팝업을 자동으로 처리하고 실패한 작업을 재시도하는 자체 복구 기능, 구조화된 테이블 콘텐츠를 포함한 데이터 추출, 기본 클릭 및 고급 AI 기반 다단계 작업에 대한 입력에서 전체 상호 작용 방법 제품군이 포함됩니다.

요소 식별 방법

  • 설명 방법: AI를 사용하여 자연어 설명(예: "로그인 버튼")을 사용하여 요소를 식별하므로 자동화가 UI 변경에 더 탄력적입니다.

  • XPath 선택기 방법: 정확한 요소 대상 지정(예: //button[text()='Log in'])에 정확한 XPath 표현식을 사용합니다.

  • 결합된 접근 방식: 두 메서드가 모두 활성화되면 설명 메서드로 돌아가기 전에 XPath를 먼저 시도하여 정밀도와 적응성을 결합합니다.

입력 및 클릭에 사용할 수 있는 자체 복구 기능

  • HandlePopups: 예상치 못한 대화 상자, 쿠키 알림 및 오버레이를 자동으로 감지하고 처리하여 차단 요소가 워크플로를 중단하지 않도록 합니다.

  • ValidateAndRetry: 스크린샷 비교를 통해 작업 성공을 확인하고 필요한 경우 재시도하여 잘못된 실패를 줄입니다.

브라우저 세션 관리

브라우저 인스턴스는 자동으로 생성되고, 워크플로 전체에서 유지 관리되며, 완료되면 올바르게 정리됩니다. 이 restart_browser 작업은 로그인 제한 시간 또는 세션 만료와 같은 시나리오에 필요한 경우 새 세션을 허용합니다.

브라우저 세션 시작

새 브라우저 세션을 엽니다. 내부 작업은이 브라우저와 상호 작용하는 범위입니다. 완료되면 브라우저가 자동으로 닫힙니다.

속성:

  • 작업 제목(텍스트 전용): 프로세스 시각화에 표시되는 작업의 제목(기본값: 브라우저)

참고

  1. 모든 브라우저 작업은 브라우저 세션 범위 내에 있어야 합니다.

  2. 각 브라우저 범위는 브라우저 세션입니다. 범위 내 작업이 완료되면 브라우저가 자동으로 닫힙니다.

웹 페이지로 이동

특정 URL로 이동합니다. 현재 브라우저 탭에서 새 웹 페이지로 이동하는 데 사용됩니다.

속성:

  • URL(필수): 탐색할 웹 주소(예: "example.com") 참고:이 작업을 수행할 때 전체 URL을 제공하십시오.

다시 시도하려면

웹 페이지 요소를 클릭합니다. 버튼, 링크 또는 기타 클릭 가능한 요소와 상호 작용하는 데 사용됩니다.

속성:

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 클릭할 브라우저 요소의 자연어 설명(예: "제출 버튼"). 요소에 작업을 사용하지 말고 요소에 대한 설명만 사용합니다.

  • Selector로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//input[@id='xyz']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

  • 마우스 버튼(드롭다운): 클릭할 마우스 버튼 - 왼쪽, 중간 또는 오른쪽(기본값: 왼쪽, 선택 사항)

  • 클릭 유형(드롭다운): 단일 또는 이중 클릭(기본값: 단일, 선택 사항)

  • 파일 다운로드 가져오기(라디오 버튼): 클릭이 파일을 다운로드하는 경우 활성화(기본값: OFF, 선택 사항)

  • 다운로드한 파일(출력, 조건부 필수): 다운로드한 파일을 저장하는 변수 이름(기본값: download_file)

요소 식별:

  • 하나 이상의 요소 식별 방법을 활성화해야 합니다.

  • 두 메서드가 모두 활성화되면 설명으로 돌아가기 전에 XPath 선택기를 먼저 시도합니다.

텍스트 입력

입력 필드에 텍스트를 입력합니다. 웹 페이지의 양식, 검색 상자 또는 기타 텍스트 입력을 작성하는 데 사용됩니다.

속성:

  • 입력할 텍스트(필수): 필드에 입력하려는 텍스트(예: "Order #12345")

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 자연어 설명(예: "주문 번호 필드")

  • 선택기로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//input[@id='xyz']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

  • 기존 텍스트 바꾸기(확인란): 입력하기 전에 필드에 있는 기존 텍스트를 지웁니다(기본값: ON).

요소 식별:

  • 하나 이상의 요소 식별 방법을 활성화해야 합니다. 요소 설명을 사용하고 필요한 경우에만 요소 선택기로 이동하는 것이 좋습니다.

자격 증명 입력

사용자 이름 또는 암호를 입력합니다. 저장된 자격 증명을 사용하여 웹 사이트에 안전하게 로그인하는 데 사용됩니다.

속성:

  • 자격 증명(드롭다운, 필수): 자동화 그룹에서 사용할 저장된 자격 증명을 선택합니다.

  • 입력할 값(드롭다운, 필수): 사용자 이름 또는 암호(기본값: 사용자 이름)를 입력할지 여부를 선택합니다.

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 자연어 설명(예: "사용자 이름 필드")

  • 선택기로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//input[@id='username']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

요소 식별:

  • 하나 이상의 요소 식별 방법을 활성화해야 합니다.

드롭다운에서 선택

드롭다운에서 값을 선택합니다. 웹 페이지의 양식, 필터 또는 기타 드롭다운 메뉴에서 선택하는 데 사용됩니다.

속성:

  • 선택할 값(필수): 드롭다운 필드에서 선택할 옵션(예: "Complete")

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 자연어 설명(예: "주문 상태 드롭다운")

  • 선택기로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//select[@id='xyz']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

요소 식별:

  • 하나 이상의 요소 식별 방법을 활성화해야 합니다.

텍스트 추출

웹 페이지에서 값을 읽습니다. 개별 필드에서 텍스트를 캡처하는 데 사용됩니다.

속성:

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 자연어 설명(예: "총 금액 필드")

  • 선택기로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//input[@id='xyz']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

  • 추출된 텍스트(출력): 추출된 텍스트를 저장하는 변수 이름(기본값: extracted_text)

요소 식별:

  • 하나 이상의 요소 식별 방법을 활성화해야 합니다.

테이블 추출

웹 페이지 테이블에서 데이터를 읽습니다. 테이블에 있는 구조화된 정보를 캡처하는 데 사용됩니다.

자연어 대상 지정 또는 XPath 선택기를 사용하여 웹 페이지에서 구조화된 데이터를 지능적으로 추출합니다. 기능에는 AI 강화 추출, 다중 속성 추출(텍스트, 링크 등), 속성에 대한 자동 열 생성, 프로그래밍 방식 조작을 위한 데이터 테이블 출력이 포함됩니다.

속성:

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 자연어 설명(예: "주문 세부 정보 테이블")

  • 선택기로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//table[@id='xyz']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

  • 여러 페이지 추출(라디오 버튼): 추가 페이지가 있는 경우 추가 페이지에서 데이터를 계속 추출합니다(기본값: OFF, 선택 사항).

  • 다음 페이지 버튼 선택기(조건부 표시): 다음 페이지 버튼의 XPath 표현식(예: "//*[@id='nextButton']", 선택 사항)

  • Intelligent Data Extraction(확인란): AI를 사용하여 복잡한 테이블에서 데이터를 추출하고 구조화합니다(기본값: ON). 행이 100개 이상인 큰 테이블 크기에는를 사용하지 마십시오. 이 옵션은 웹 브라우저에서 일반 테이블 추출이 실패하는 복잡한 테이블 또는 테이블과 유사한 구조에 사용해야 합니다.

  • 추출할 데이터(다중 선택 드롭다운): 추출할 데이터 선택 - 텍스트, 링크(Href) 또는 요소 선택기(Xpath)(기본값: 텍스트, 선택 사항)

  • 추출된 테이블(출력): 추출된 데이터 테이블을 저장하는 변수 이름(기본값: extracted_table)

요소 식별:

  • 하나 이상의 요소 식별 방법을 활성화해야 합니다.

사용 참고 사항:

  • 추가 데이터 형식은 별도의 열에 저장됩니다(예: 링크의 경우 columnName_Href).

  • 더 나은 성능을 위해 100개 이상의 행이 있는 테이블에 대해 지능형 추출 비활성화

스크린샷 찍기

웹 페이지의 이미지를 캡처합니다. 스크린샷은 나중에 프로세스에서 사용할 파일에 저장됩니다.

속성:

  • 파일 이름(선택 사항): 저장된 이미지 파일의 이름입니다. 비어 있는 경우 자동 생성됨(예: "스크린샷 이미지")

  • 파일 유형(드롭다운): 이미지 형식 - PNG 또는 JPEG(기본값: PNG, 선택 사항)를 선택합니다.

  • 스크린샷 파일(출력): 스크린샷 파일을 저장하는 변수 이름(기본값: screenshot_file)

시각적 Q&A

웹 페이지에 대한 질문에 답변합니다. AI를 사용하여 페이지를 시각적으로 분석하고 콘텐츠에 대한 참/거짓 질문에 답합니다.

속성:

  • 질문(필수): 웹 페이지 콘텐츠에 대한 참/거짓 질문(예: "제품이 재고에 있습니까?")을 입력합니다.

  • 자가 복구(확인란): AI를 사용하여 예기치 않은 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

  • 답변(출력): true/false 응답을 저장하는 변수 이름(기본값: is_true)

파일 클릭 및 업로드

웹 페이지에 파일을 업로드합니다. 파일 업로드 버튼을 클릭하고 업로드할 파일을 선택하여 파일 선택기를 자동화하는 데 사용됩니다.

속성:

  • 업로드할 파일(필수): 업로드할 파일 목록으로, 일반적으로 변수(예: [my_file1, my_file2])에 저장됩니다.

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 자연어 설명(예: "업로드 버튼")

  • 선택기로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//input[@id='xyz']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

  • 마우스 버튼(드롭다운): 클릭할 마우스 버튼 - 왼쪽, 중간 또는 오른쪽(기본값: 왼쪽, 선택 사항)

  • 클릭 유형(드롭다운): 단일 또는 이중 클릭(기본값: 단일, 선택 사항)

파일 요구 사항:

  • 미디어/파일 객체의 배열이어야 합니다.

요소 식별:

  • 하나 이상의 요소 식별 방법을 활성화해야 합니다.

키 입력 입력

키 명령 또는 바로 가기를 전송합니다. 웹 페이지에서 개별 키 또는 키 조합을 자동으로 입력하는 데 사용됩니다.

속성:

  • 특수 키(드롭다운, 필수): Ctrl, Alt, Shift와 같은 한정자 또는 Enter, Tab, Pagedown과 같은 단일 키 입력을 선택합니다.

  • 명령 키(선택 사항): 특수 키와 함께 사용할 키를 입력합니다(예: Ctrl+c의 경우 "c").

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 자연어 설명(예: "검색 창")

  • 선택기로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//input[@id='xyz']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

요소 식별:

  • 두 요소 토글 모두 OFF일 수 있습니다. 정의된 요소가 없는 경우 키 입력이 현재 활성 필드로 전송됩니다.

요소 대기

요소가 나타나는지 확인합니다. 웹 페이지에서 변경 사항을 기다리거나 조건을 검증하는 데 사용됩니다. 요소가 최대 대기 시간 내에 발견되면 true를 반환하고 그렇지 않으면 false를 반환합니다.

속성:

  • 작업 제목(텍스트 전용): 작업의 표시 이름

  • 요소 선택기(필수): 확인할 요소를 정의하는 XPath 표현식(예: "//input[@id='xyz']")

  • 최대 대기 시간(선택 사항): 요소가 나타날 때까지 초 단위로 대기하는 최대 시간(기본값: 30)

  • Element Found(출력): 요소를 찾았는지 여부를 저장하는 변수 이름(True/False)(기본값: is_found)

검증:

  • 최대 대기 시간은 정수 또는 소수여야 합니다.

일치하는 요소 찾기

패턴과 일치하는 요소를 가져옵니다. 웹 페이지에서 하나씩 처리할 수 있는 유사한 요소 목록을 가져오는 데 사용됩니다.

속성:

  • 요소 선택기(필수): 가져오려는 요소의 패턴을 정의하는 XPath 표현식(예: "//div[@class='abc']")

  • 요소 목록(출력): 찾은 요소 목록을 저장하는 변수 이름(기본값: element_list)

사용 참고 사항:

  • 일치하는 요소를 찾을 수 없는 경우 목록이 비어 있습니다.

  • 검색 결과 또는 하이퍼링크와 같은 여러 유사한 요소를 처리하는 데 사용

새 창 대기

열려는 새 창이 있는지 확인합니다. 현재 브라우저 세션에서 새 하위 창을 여는 링크 또는 버튼을 클릭한 후 사용됩니다.

속성:

  • 최대 대기 시간(선택 사항): 새 창이 나타날 때까지 초 단위로 대기하는 최대 시간(기본값: 30)

  • 창 식별자(출력): 새 창의 식별자를 저장하는 변수 이름(기본값: window_id)

사용 참고 사항:

  • 시간이 초과되고 기간을 찾을 수 없는 경우 예외가 발생합니다.

  • 창 식별자를 사용하여 포커스를 전환하거나 창을 닫을 수 있습니다.

검증:

  • 최대 대기 시간은 정수 또는 소수여야 합니다.

전환 창

브라우저 창을 변경합니다. 포커스를 지정된 창으로 전환한 후 후속 브라우저 작업은 해당 창과 상호 작용합니다.

속성:

  • 창 식별자(선택 사항): 전환하려는 창으로, 일반적으로 변수(예: window_id)에 저장됩니다. 기본 창으로 전환하려면 비워 둡니다.

창 닫기

브라우저 창을 닫습니다. 닫으면 자동화가 현재 브라우저 세션의 기본 창으로 돌아갑니다.

속성:

  • 창 식별자(필수): 닫으려는 창으로, 일반적으로 변수(예: window_id)에 저장됩니다.

클립보드에 저장

텍스트를 클립보드에 복사합니다. 나중에 붙여 넣을 수 있는 텍스트를 저장하는 데 사용됩니다. 기존 클립보드 텍스트가 대체됩니다.

속성:

  • 저장할 텍스트(필수): 클립보드에 복사하려는 텍스트(예: "Order #12345")

클립보드에서 붙여넣기

클립보드에서 텍스트를 삽입합니다. 복사한 텍스트를 웹 페이지 필드에 붙여넣는 데 사용됩니다.

속성:

  • 설명이 있는 요소 찾기(라디오 버튼): 자연어 설명을 사용하여 AI가 있는 요소를 식별합니다(기본값: ON).

    • 설명 필드(조건부 필수): 자연어 설명(예: "주문 번호 필드")

  • 선택기로 요소 찾기(라디오 버튼): XPath 표현식을 사용하여 요소를 식별합니다(기본값: OFF).

    • XPath 필드(조건부 필수): XPath 표현식(예: "//input[@id='xyz']")

  • 자가 복구(확인란): AI를 사용하여 예상치 못한 팝업을 자동으로 처리합니다(기본값: OFF, 선택 사항).

  • 기존 텍스트 바꾸기(확인란): 붙여넣기 전에 필드의 기존 텍스트를 지웁니다(기본값: ON).

요소 식별:

  • 하나 이상의 요소 식별 방법을 활성화해야 합니다.

웹 페이지 새로 고침

현재 웹 페이지를 다시 로드합니다. 일부 페이지는 새로 고침 시 리디렉션될 수 있습니다.

속성:

  • 작업 제목(텍스트 전용): 작업의 표시 이름

브라우저 다시 시작

브라우저를 닫았다가 다시 엽니다. 새 세션은 빈 페이지에서 시작됩니다.

속성:

  • 모두 다시 시작(확인란): 현재 브라우저 창뿐만 아니라 모든 브라우저 창을 닫고 다시 시작합니다(기본값: OFF, 선택 사항).

제한 사항

요소 식별 불확실성: AI가 UI 요소를 안정적으로 식별할 수 없는 경우 'LowConfidence' 오류와 함께 작업이 실패합니다. 이러한 경우 보다 구체적인 XPath 선택기 또는 요소 설명을 사용합니다. 브라우저 호환성:이 시스템은 Chrome 브라우저 인스턴스에서만 작동하며 기본 자동화 프레임워크로 Playwright를 사용합니다. 즉, 호환성은 Chrome 지원 웹 기술로 제한되며 다른 공급업체의 브라우저별 기능에서는 작동하지 않을 수 있습니다. 동적 콘텐츠 문제: 레이아웃 변경이 잦거나 JavaScript 프레임워크가 많거나 복잡한 단일 페이지 애플리케이션이 있는 매우 동적인 페이지에는 추가 대기 시간, 재시도 로직 또는 특수 처리 접근 방식이 필요할 수 있습니다. 성능 오버헤드: 자연어 요소 타겟팅 및 자가 복구 기능과 같은 AI 기반 기능은 직접 XPath 타겟팅보다 더 많은 처리 시간이 필요합니다.