Skip to Content
사용자 가이드⚡️ Automation

Automation

Automation을 사용하면 지정된 시간 또는 이메일 수신과 같은 특정 트리거에 따라 에이전트를 자동으로 실행할 수 있습니다.


QueryPie AI의 Automation 기능을 사용하면 반복적인 작업을 자동화하여 워크플로우를 간소화할 수 있습니다. 특정 시간에 맞춰 주기적으로 Agent를 실행하거나, 특정 조건의 이메일이 수신되었을 때 트리거하여 원하는 작업을 수행하도록 설정할 수 있습니다.

Automation 메뉴

Automation 메뉴에서는 생성된 자동화 목록을 한눈에 볼 수 있습니다.

Automation 생성 및 수정

Automation을 새로 만들거나 기존 설정을 변경할 수 있습니다.

Trigger Type 선택

자동화를 실행할 방법을 선택합니다.

  • Schedule Trigger: 지정된 시간 또는 간격으로 자동화를 실행합니다.
  • Email Trigger: 특정 조건의 이메일을 수신했을 때 자동화를 실행합니다.
  • Webhook Trigger: Salesforce, GitHub, Jira에서 이벤트가 발생했을 때 자동화를 실행합니다.
  • Folder Watch Trigger: My Drive의 특정 폴더에 파일이 업로드되면 자동으로 자동화를 실행합니다.

1. Schedule Trigger 설정

Trigger Type을 ‘Schedule Trigger’로 선택하면, 지정된 시간 또는 간격으로 반복적인 작업을 자동화할 수 있습니다.

기본 설정
  • Schedule Name: 스케줄을 식별할 수 있는 고유한 이름을 지정합니다.
  • Selected Agent: 자동 실행할 에이전트를 선택합니다.
  • Prompt: 스케줄 실행 시 에이전트에게 전달할 명령이나 요청을 작성합니다.
반복 설정
  • One Time: 한 번만 실행되는 일회성 스케줄
  • Custom: 사용자가 지정한 요일과 시간 범위 내에서 분 단위로 반복 실행
  • Daily: 매일 지정된 시간에 반복 실행
  • Weekly: 특정 요일과 시간에 반복 실행
  • Monthly: 월 단위로 반복 실행
실행 시간 설정
  • 원하는 날짜와 시간을 정확히 지정합니다.
  • 시간대 설정을 통해 정확한 실행 시점을 보장합니다.

2. Email Trigger 설정

Trigger Type을 ‘Email Trigger’로 선택하면 다음과 같은 설정이 필요합니다.

Email Provider 선택 및 연동
  • Email Provider: Gmail 또는 Outlook 중 선택할 수 있습니다.
  • OAuth 연동: 선택한 이메일 계정을 연동하여 새로운 이메일을 확인하고 트리거를 실행할 수 있는 권한을 부여합니다.
Email 필터 설정

불필요한 트리거 실행을 방지하기 위해, 특정 조건에 부합하는 이메일에 대해서만 자동화가 실행되도록 필터를 설정합니다. 필터를 적절히 설정하면 불필요한 실행 및 비용을 줄일 수 있습니다.

참고: 자신에게 보낸 이메일은 트리거를 활성화하지 않습니다.

  • Filter by Labels/Folders (필수): 이메일 트리거를 확인할 메일박스를 선택합니다.

    • Gmail: Label 선택 (Sent, Draft 라벨은 지원하지 않음)
    • Outlook: Folder 선택 (Sent Items, Drafts 폴더는 지원하지 않음)
  • Filter Events (선택): 특정 조건을 설정하여 원하는 이메일에 대해서만 자동화가 실행되도록 합니다.

    • Conditions Match Type:
      • Match All conditions (AND): 모든 조건을 충족할 때 실행
      • Match Any condition (OR): 조건 중 하나라도 충족할 때 실행
    • Condition (조건):
      • Property: From, Cc, Subject, Bcc 중 선택
      • Operator: Contains, Equals, Is not empty 중 선택
      • Value: 조건에 해당하는 텍스트 입력

3. Webhook Trigger 설정

Trigger Type을 ‘Webhook Trigger’로 선택하면 외부 시스템의 이벤트를 수신하여 에이전트를 실행할 수 있습니다.

기본 설정
  • Webhook Name: 웹훅을 식별할 수 있는 이름을 지정합니다.
  • Selected Agent: 실행할 에이전트를 선택합니다.
  • Prompt: 에이전트에게 전달할 프롬프트를 작성합니다. 웹훅으로 전달된 데이터(Payload)를 프롬프트에서 활용할 수 있습니다.
Provider별 추가 설정

선택한 Provider에 따라 추가 설정이 필요할 수 있습니다.

  • Salesforce:
    • Salesforce Organization ID: 연동할 Salesforce 조직의 ID를 입력합니다.
  • GitHub / Jira:
    • Webhook secret: HMAC-SHA256 서명 검증을 위한 Webhook Secret을 입력합니다.
Webhook URL 관리

Automation을 생성한 후 상세 화면에서 Webhook URL을 확인하고 관리할 수 있습니다.

  • URL 확인 및 복사: 생성된 고유 Webhook URL을 복사하여 Salesforce, GitHub, Jira 등의 외부 시스템 웹훅 설정에 등록합니다.
  • URL 재생성: 보안상의 이유로 URL을 변경해야 할 경우 Regenerate URL 기능을 사용하여 새로운 URL을 발급받을 수 있습니다.

4. Folder Watch Trigger 설정

Trigger Type을 ‘Folder Watch Trigger’로 선택하면, My Drive의 특정 폴더에 파일이 업로드될 때 자동으로 에이전트를 실행할 수 있습니다.

기본 설정
  • Automation Name: 자동화를 식별할 수 있는 이름을 지정합니다.
  • Selected Agent: 파일 업로드 시 자동 실행할 에이전트를 선택합니다.
  • Prompt: 에이전트에게 전달할 명령을 작성합니다. 업로드된 파일의 메타데이터(파일명, 크기, 형식 등)와 파일 내용이 에이전트에게 자동으로 전달되어, 에이전트가 파일을 직접 읽고 처리할 수 있습니다.
폴더 감시 설정
  • Folder to Watch: 감시할 My Drive 폴더를 선택합니다.
  • Files to Watch: 감시할 파일 유형을 선택합니다. 카테고리를 복수 선택할 수 있으며, 커스텀 확장자를 직접 추가할 수도 있습니다.
    • All files: 모든 파일을 감시합니다.
    • Documents: 문서 파일을 감시합니다. (pdf, docx, xlsx, pptx, doc, xls, ppt)
    • Images: 이미지 파일을 감시합니다. (jpg, jpeg, png, gif, webp)
    • Text/Data: 텍스트 및 데이터 파일을 감시합니다. (csv, tsv, txt, md, json, xml)
    • Add custom extensions: 위 카테고리에 포함되지 않는 확장자를 직접 추가할 수 있습니다. (예: epub, zip)

참고: Folder Watch Trigger는 파일 업로드(생성) 이벤트만 감지합니다. 파일 수정, 삭제, 이동은 트리거되지 않습니다.

참고: Folder Watch Trigger는 현재 My Drive만 지원합니다. Google Drive, OneDrive 등 외부 드라이브는 지원하지 않습니다.

참고: 여러 파일을 동시에 업로드하면 파일마다 개별적으로 에이전트가 실행됩니다.

참고: Folder Watch Trigger는 이벤트 기반으로만 동작하므로 Run Now 기능을 사용할 수 없습니다.


Automation 상세 화면 및 관리

생성된 Automation을 효율적으로 관리할 수 있습니다.

  • 알림 설정: Automation별로 알림 수신 여부를 개별적으로 on/off 설정할 수 있습니다. 백그라운드에서 자동으로 처리만 하려는 경우 알림을 끄고, 실행 결과를 확인하고 싶은 경우 알림을 켤 수 있습니다. 알림은 알림 센터에서 확인할 수 있습니다.
  • 상태 관리: Active(정상 실행), Paused(일시 중단) 상태를 변경할 수 있습니다.
  • 즉시 실행: Run Now 기능을 통해 스케줄된 시간을 기다리지 않고 즉시 실행할 수 있습니다.
  • 실행 취소: Automation이 ‘Running’ 상태일 때 Cancel running schedule 아이콘을 통해 작업을 즉시 중단할 수 있습니다.
  • Trigger가 EmailWebhook인 경우, Run Now 버튼이 표시되지 않으며 설정된 필터 정보가 표시됩니다.

실행 이력 확인

Automation의 실행 결과를 상세히 확인할 수 있습니다.

  • 실행 결과: Success(성공), Failure(실패), Canceled(취소) 상태와 상세 결과를 확인할 수 있습니다.
  • 채팅 이력: 각 실행마다 새로운 채팅방이 생성되며, 채팅 아이콘을 클릭하여 상세한 대화 내용을 확인할 수 있습니다. 에이전트가 삭제되어도 채팅 이력은 유지됩니다.
Last updated on