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

# 자동화 구축
<a name="building-automations"></a>

Amazon Quick Automate는 다양한 요구 사항과 기술 수준에 맞게 자동화를 생성하는 여러 방법을 제공합니다. 이 섹션에서는 사용 가능한 생성 방법 및 도구를 설명합니다.

## 사전 조건
<a name="building-prerequisites"></a>

자동화를 생성하기 전에 특정 자동화 그룹 내에 프로젝트를 생성해야 합니다. 자동화 그룹은 자동화를 구축할 때 사용할 수 있는 통합 및 자격 증명을 제어합니다. 자동화에서 상호 작용하려는 외부 시스템에 필요한 통합 및 자격 증명이 설정되어 있는지 확인합니다.

프로젝트를 생성했으면 **빌드 시작** 버튼을 클릭하여 시작합니다.

**참고**  
자동화 그룹의 통합 및 자격 증명을 관리하려면 소유자 권한이 있어야 합니다.

## 생성 방법
<a name="creation-methods"></a>

세 가지 접근 방식 중에서 선택하여 자동화를 구축합니다. Amazon Quick Automate를 처음 사용하는 경우 다음을 권장합니다.
+ 먼저 샘플 자동화 탐색
+ 자연어를 사용하여 간단한 자동화를 생성해 보세요.
+ 기본 사항에 익숙해지면 수동 편집으로 실험합니다.

### 샘플 자동화 사용
<a name="using-sample-automations"></a>

일반적인 자동화 패턴을 보여주는 사전 빌드된 샘플을 탐색하여 빠르게 시작하세요. 이러한 샘플은 다양한 자동화 기능의 실습 예제를 제공하고 Amazon Quick Automate의 기능에 익숙해지는 데 도움이 되는 학습 리소스 역할을 합니다. 샘플 자동화를 사용하려면:
+ 를 검색하여 산업별로 다양한 샘플을 탐색합니다.
+ 샘플을 클릭하여 자동화의 개요를 봅니다.
  + 통합이 필요한 경우 사전 조건으로 나열됩니다.
+ **샘플로 시작**을 클릭하여 캔버스에서 자동화를 엽니다.
+ 이제 자동화를 보고, 편집하고, 테스트할 수 있습니다.

### 자연어로 생성
<a name="creating-with-natural-language"></a>

Automation Assistant는 다음을 통해 자동화를 생성하는 AI 기반 접근 방식을 제공합니다.
+ 채팅 인터페이스 - 프로세스를 자연어로 대화로 설명
+ 문서 업로드 - 프로세스 단계 및 요구 사항을 설명하는 설명서를 가져옵니다.

두 방법 중 하나를 통해 입력을 제공하면 Automation Assistant는 2단계 안내 환경을 통해 자동화를 생성합니다.
+ **상위 수준 계획**
  + 먼저 도우미는 요구 사항을 분석하고 상위 수준 자동화 계획을 생성합니다. 계획은 자동화의 일부로 관련 작업을 논리적으로 그룹화하는 **프로세스 단계로** 구성됩니다. 각 프로세스 단계에는 처음에 자연어 지침이 포함되어 있습니다.
  + 각 프로세스 단계의 지침을 검토하고 편집한 다음 **생성을** 클릭하여 해당 단계에 대한 하위 수준 작업을 생성합니다.
+ **하위 수준 작업**
  + 다음으로 도우미는 단계 지침에 따라 하위 수준 작업 및 프로세스 로직을 빌드합니다.
  + 생성된 작업을 검토하고 편집합니다. **실행** 또는 **디버그**를 클릭하여 테스트를 시작합니다.

자연어 입력 제공 모범 사례:
+ 신규 채용자를 교육하는 것처럼 단계별 프로세스를 지정합니다.
+ 각 단계를 수행하는 데 필요한 정확한 세부 정보를 포함합니다.
  + 메시지를 보내는 경우 이메일 주소
  + 문서를 업로드/다운로드하는 경우 파일 이름 및 위치
  + 웹 사이트로 이동하는 경우 URL

### 처음부터 생성(공백 자동화)
<a name="creating-from-scratch"></a>

시각적 디자이너 인터페이스를 사용하여 수동으로 자동화를 구축합니다.
+ 프로젝트 요약으로 이동합니다.
+ **빌드 시작**을 클릭합니다.
+ **건너뛰기를** 선택하여 캔버스에 액세스합니다.

디자이너 인터페이스는 다음과 같은 몇 가지 주요 구성 요소를 제공합니다.
+ **Canvas** - 자동화를 시각화합니다. 캔버스에서 확대 및 축소, 프로세스 단계 확장 및 축소, 작업 재정렬을 수행할 수 있습니다.
+ **작업 패널** - 작업 패널에는 자동화 그룹 내에서 사용할 수 있는 모든 자동화 작업의 포괄적인 목록이 있습니다. 검색하고 필터링하여 범주(에이전트, 프로세스 흐름, 웹 브라우저 등)별로 구성된 작업을 찾을 수 있습니다. 작업을 캔버스로 Drag-and-drop서 놓아 자동화를 구축합니다. 작업 간에 마우스를 가져갈 때 찾은 더하기 기호를 클릭하여 캔버스에 직접 새 작업을 추가할 수도 있습니다.
+ **속성 패널** - 작업을 추가하거나 프로세스에서 기존 작업을 클릭하면 속성 패널을 통해 해당 작업의 작동 방식을 제어하는 입력 및 출력 파라미터를 구성할 수 있습니다.
+ **설정 패널** - 런타임 구성을 생성 및 편집하고 자동화에 사용할 수 있는 자격 증명을 탐색할 수 있습니다.
+ **변수 패널** - 자동화에 사용된 모든 변수를 표시합니다. 자동화에 직접 새 참조를 추가하여 변수를 원활하게 생성할 수 있습니다.

## 런타임 구성 및 변수
<a name="runtime-configurations-variables"></a>

런타임 구성을 사용하면 자동화에 사용되는 편집 가능한 설정을 쉽게 생성할 수 있습니다. 런타임 구성의 예는 다음과 같습니다.
+ 웹 사이트 URLs
+ 파일 이름 및 위치
+ 제목 및 발신자 목록과 같은 이메일 구성

변수는 자동화가 실행될 때 자동화의 작업 간에 정보를 저장하고 전달하는 데 사용됩니다. 출력 속성에 새 참조 이름을 제공하면 자동화에 새 변수를 추가할 수 있습니다. 일반적인 변수 유형은 다음과 같습니다.
+ 문자열 - 일반 텍스트(예: 이름, 설명)
+ 숫자 - 숫자 값(예: 수량, 점수)
+ 부울 - True/False 값
+ 배열 - 항목 수집 또는 목록
+ 객체 - 키-값 페어
+ 파일 - 문서 및 미디어(예: PDFs, 이미지)
+ 데이터 테이블 - 행과 열이 있는 스프레드시트와 유사한 데이터

## 자동화 편집
<a name="editing-automations"></a>

자동화를 생성한 후에는 Automation Assistant를 사용하거나 캔버스에서 직접 편집하여 자동화를 수정할 수 있습니다.

### Automation Assistant 사용
<a name="using-automation-assistant"></a>

Automation Assistant를 사용하면 자연어를 통해 변경할 수 있습니다. 다음을 수행할 수 있습니다.
+ 전체 자동화, 특정 단계 또는 특정 작업에 대한 업데이트를 요청합니다.
  + 먼저 특정 단계를 선택하여 채팅에 집중합니다.
+ 실제 자동화를 기반으로 질문하고 제품 내 도움말 및 제안 받기
+ 필요에 따라 표현식 및 코드 작성에 대한 도움말 요청

어시스턴트를 사용하여를 편집하려면:
+ 도구 모음에서 **Build with Assistant**를 클릭합니다.
+ 변경하려는 사항 설명
+ 제안된 수정 사항 검토 및 확인
  + 채팅에는 변경 사항 요약이 포함되어 있습니다. **변경 사항 거부**를 클릭하여 이전 버전으로 되돌립니다.
+ 업데이트된 자동화 테스트

### 캔버스에서 편집
<a name="editing-on-canvas"></a>

시각적 디자이너에서 직접 변경합니다.
+ 수정할 단계 또는 작업 선택
+ 속성 패널을 사용하여 설정 조정
+ drag-and-drop 사용하여 단계 재정렬

**참고**  
모든 작업에는 작업 복제 또는 삭제와 같은 일반적인 작업이 포함된 옵션 메뉴가 있습니다.

**편집 모범 사례:**
+ 증분 변경 수행
+ 각 중요한 수정 후 테스트

**참고**  
변경 사항은 라이브 버전에 자동으로 저장됩니다. 이러한 변경 사항을 배포하려면 업데이트된 버전을 커밋하고 배포합니다.

**작은 정보**  
빌드 중에 문제가 발생하는 경우:  
Automation Assistant를 사용하여 도움말 가져오기
작업 설명서에서 특정 요구 사항을 확인합니다.

## 자동화 입력 및 출력
<a name="automation-inputs-outputs"></a>

입력 및 출력 스키마를 정의하여 Amazon Quick Automate에서 재사용 가능하고 파라미터화된 자동화를 생성합니다. 시작 및 종료 노드를 사용하여 입력 및 출력 스키마를 정의하면 정적 자동화를 실행할 때마다 서로 다른 데이터를 허용하는 재사용 가능한 워크플로로 변환할 수 있습니다. 값을 하드코딩하는 대신 런타임에 제공되는 입력 파라미터와 자동화가 완료될 때 캡처되는 구조화된 출력 값을 정의합니다. 입력 및 출력은 수동 실행, API 호출, 예약된 트리거 등 모든 호출 방법에서 작동합니다.

입력 및 출력 사용의 주요 이점:
+ **재사용성** - 자동화 자체를 수정하지 않고 다른 데이터로 동일한 자동화를 실행합니다.
+ **유형 안전** - Amazon Quick Automate는 실행이 시작되기 전에 스키마에 대해 입력 데이터를 검증하므로 잘못된 데이터가 실행되지 않습니다.
+ **API 통합** - 자동 생성된 스키마를 통해 프로그래밍 방식으로 검색하고 외부 시스템과 통합할 수 있습니다.
+ **관찰성** - 구조화된 출력은 감사 및 검토를 위해 실행 아티팩트로 캡처됩니다.

### 지원되는 데이터 유형
<a name="automate-supported-data-types"></a>

입력 및 출력 필드에는 다음 데이터 형식이 지원됩니다.
+ **텍스트** - 일반 텍스트 값(예: text1, text2)
+ **숫자** - 10진수를 포함한 숫자 값(예: 3.14, 100)
+ **부울** - 참 또는 거짓 값
+ **파일** - 최대 크기가 5MB인 파일 객체

### 노드 시작 및 종료
<a name="start-and-end-nodes"></a>

모든 자동화에는 시작 노드와 기본적으로 비어 있는 종료 노드가 포함됩니다. 이러한 노드를 편집하여 스키마를 생성하고, 자동화에서 입력을 사용하고, 자동화에서 반환되도록 출력 데이터를 업데이트할 수 있습니다. 시작 노드는 런타임에 입력 데이터를 수신하는 반면, 종료 노드(종료 프로세스 노드 포함)는 실행 중에 출력 데이터를 수집하여 자동화가 완료될 때 구조화된 아티팩트로 반환합니다.

#### 시작
<a name="start-node"></a>

시작 노드는 자동화가 트리거될 때 입력 파라미터를 수락하는 진입점입니다. 기본적으로 비어 있습니다.

속성:
+ **입력 형식** - 자동화가 허용하는 입력 파라미터의 스키마를 정의합니다. 입력 및 출력 스키마 정의에 설명된 입력 스키마 편집기를 사용하여를 편집합니다.
+ **입력 변수** - 입력 형식으로 정의되고 사용자가 제공하는 자동화의 입력 값을 저장하는 변수입니다.

#### 종료
<a name="end-node"></a>

종료 노드는 자동화가 성공적으로 완료될 때 출력 값을 수집하고 반환하는 종료 지점입니다. End 노드의 속성을 사용하여 자동화의 변수에서 출력 값을 설정할 수 있습니다. 자동화 구조에 따라 자동화에 여러 엔드 노드(엔드 프로세스)가 있을 수 있습니다.

속성:
+ **출력 형식** - 자동화가 반환하는 출력 파라미터의 스키마를 정의합니다. **입력** 및 출력 스키마 정의에 설명된 출력 스키마 편집기를 사용하여 스키마 편집을 선택하고 스키마를 추가하거나 수정합니다.
+ **출력 데이터** - 자동화의 변수에서 정의한 출력 필드에 값을 매핑합니다. 종료 노드(출력 스키마)에서 생성하는 각 출력 변수에 대해 반환하려는 데이터가 포함된 자동화 변수를 지정합니다. **출력 데이터 편집** 편집기를 사용하여 **출력 값** 필드에서 이러한 매핑을 구성합니다.

### 입력 및 출력 스키마 정의
<a name="defining-input-output-schemas"></a>

스키마는 자동화가 입력으로 수락하고 출력으로 생성하는 데이터의 구조를 정의합니다. 작성 스튜디오는 자동화 캔버스에서 직접 입력 및 출력 스키마를 정의하기 위한 시각적 양식 빌더를 제공합니다.

입력 스키마를 정의하려면:
+ Amazon Quick Automate에서 자동화를 엽니다.
+ 캔버스에서 **시작** 노드를 선택하여 스키마 편집기를 엽니다. 속성 창에서 스키마 편집기를 열 수도 있습니다. 이렇게 하려면 **시작** 노드를 선택한 다음 속성 창에서 **입력 형식으로** **편집**을 선택합니다.
+ **\+필드 추가**를 선택하여 입력 필드를 추가합니다.
+ 각 입력 필드에 대해 다음 속성을 구성합니다.
  + **이름** - 필드의 고유 식별자입니다.
  + **유형** - 필드가 수락하는 데이터의 유형입니다. 자세한 내용은 지원되는 데이터 유형을 참조하세요.
  + **필수** - 자동화를 실행할 때 필드를 제공해야 하는지 여부입니다.
  + **기본값**(선택 사항) -이 옵션은 **필수** 필드가 선택 취소된 경우에만 활성화됩니다. 테스트를 실행하거나 자동화를 트리거하면 기본값이 입력 양식에 미리 채워져 나타납니다.
  + **설명** - 필드가 나타내는 내용에 대한 설명입니다.
+ **저장**을 선택하여 자동화와 함께 스키마를 저장합니다.

출력 스키마를 정의하려면:
+ 캔버스에서 **종료** 노드를 선택하여 출력 스키마 편집기를 엽니다. 속성 창에서 스키마 편집기를 열 수도 있습니다. 이렇게 하려면 **종료** 노드를 선택한 다음 속성 창에서 **출력 형식**의 **편집**을 선택합니다.
+ **\+필드 추가**를 선택하여 출력 필드를 추가합니다.
+ 각 출력 필드에 대해 다음 속성을 구성합니다.
  + **이름** - 필드의 고유 식별자입니다.
  + **유형** - 출력의 데이터 유형입니다.
  + **설명** - 출력이 무엇을 나타내는지에 대한 설명입니다.
+ **저장**을 선택합니다.

**참고**  
시작 노드의 입력과 종료 노드의 출력을 정의할 수 있습니다. 자동화에 여러 End 노드가 있는 경우 한 End 노드의 스키마를 추가하거나 수정하면 모든 End 노드 스키마가 수정됩니다.

### 시작 노드의 입력 값 사용
<a name="using-input-values"></a>

자동화에 시작 노드에 정의된 입력 스키마가 있는 경우 `inputs` 사전을 사용하여 워크플로 전체에서 해당 입력 값에 액세스할 수 있습니다. 런타임은 자동화가 실행될 때 제공된 값으로이 사전을 자동으로 검증하고 채웁니다.

```
# Access required input fields
value = inputs["field_name"]

# Example usage
customer_id = inputs["customer_id"]  # Retrieves a required string input
```

### 종료 노드에서 출력 값 설정
<a name="setting-output-values"></a>

종료 노드는 자동화에서 출력으로 반환되는 값을 정의합니다. 편집기에서 **출력 값을 설정하기 위한 두 가지 상호 작용 모드를 제공하는 출력 데이터** 속성을 사용하여 이를 구성합니다. **출력 값** 필드 옆에 있는 코드 아이콘(`</>`)을 선택하여 모드 간에 전환합니다.

출력을 설정하는 두 가지 모드:
+ **변수 선택 모드(드롭다운)** - 기본 인터페이스에는 자동화에서 사용 가능한 모든 변수의 드롭다운 목록이 표시됩니다. 각 출력 필드에 할당할 변수를 선택합니다.
+ **표현식 모드(코드)** - 출력 값 필드 옆에 있는 코드 아이콘(`</>`)을 선택하여 표현식 모드로 전환합니다. 이 모드를 사용하면 사용자 지정 표현식을 입력하거나, 계산을 수행하거나, 중첩 데이터에 액세스하거나, 리터럴 값을 설정할 수 있습니다.

### 어시스턴트로 빌드를 사용하여 스키마 정의
<a name="defining-schemas-with-assistant"></a>

Build with Assistant는 입력 및 출력 스키마를 직접 생성하거나 수정할 수 있습니다. 입력 및 출력 요구 사항을 자연어로 설명하면 어시스턴트가 스키마 정의를 생성합니다. 어시스턴트가 Studio 시각적 양식 빌더와 자동으로 동기화하는 모든 변경 사항입니다.

### 고려 사항
<a name="inputs-outputs-considerations"></a>

자동화 입력 및 출력을 사용할 때는 다음 사항에 유의하세요.
+ 입력 및 출력 스키마는 선택 사항입니다. 스키마가 없는 기존 자동화는 변경되지 않고 계속 작동합니다.
+ 파일 입력의 최대 크기는 5MB입니다. 더 큰 파일의 경우 파일 위치(예: Amazon S3 경로)를 대신 텍스트 입력으로 전달합니다.
+ 입력 및 출력 값은 관찰성 및 감사 목적으로 실행될 때마다 저장됩니다.
+ 스키마를 업데이트할 때 배포된 실행에 변경 사항을 적용하려면 자동화를 재배포해야 합니다. 테스트 실행은 항상 최신 초안 스키마를 사용합니다.

다음과 같은 방법으로 입력 및 출력 값을 사용할 수 있습니다.
+ 캔버스에서 자동화를 테스트하고 실행합니다. 자세한 내용은 [자동화 테스트를 참조하세요](https://docs.aws.amazon.com/quicksuite/latest/userguide/testing-automations.html#running-and-debugging).
+ 배포된 자동화를 수동으로 트리거합니다. 자세한 내용은 [자동화 배포를 참조하세요](https://docs.aws.amazon.com/quicksuite/latest/userguide/deploying-automations.html#deploy-run-inputs-outputs).
+ 배포된 자동화에 대한 예약된 트리거입니다. 자세한 내용은 [자동화 배포를 참조하세요](https://docs.aws.amazon.com/quicksuite/latest/userguide/deploying-automations.html#deploy-run-inputs-outputs).

## 자동화 버전 관리
<a name="managing-automation-versions"></a>

Amazon Quick Automate는 자동화 업데이트 기록을 추적 및 유지 관리하고 이전 버전을 쉽게 복원하는 데 도움이 되는 버전 관리 기능을 제공합니다.

### 주요 개념
<a name="version-key-concepts"></a>
+ **라이브 버전** - 캔버스에서 편집할 수 있는 자동화의 현재 작업 복사본입니다. 변경 사항은 편집할 때 라이브 버전으로 자동 저장됩니다.
+ **커밋된 버전** - 배포할 수 있는 자동화의 읽기 전용 스냅샷입니다. 자동화의 새 버전을 커밋하여 중요한 업데이트를 추적하고 필요한 경우 되돌릴 수 있습니다.
+ **배포된 버전** - 커밋된 버전을 일정에 따라 배포하고 활성화하여 실행할 수 있습니다.

**참고**  
각 버전은 자체 런타임 구성 값을 유지합니다. 라이브 버전의 런타임 설정을 변경해도 이전에 커밋되거나 배포된 버전에는 영향을 주지 않습니다.

### 커밋 버전
<a name="committing-versions"></a>

버전을 커밋하려면:
+ 캔버스 도구 모음에서 **커밋**을 클릭합니다.
+ 변경 사항을 설명하는 설명 메모 추가
+ 버전 번호를 늘리는 방법을 선택합니다.
  + 소규모 업데이트를 위한 마이너 버전(예: 1.05 → 1.06)(기본값)
  + 주요 변경 사항에 대한 메이저 버전(예: 1.0 → 2.0)
+ **커밋**을 클릭합니다.

**중요**  
자동화에 검증 오류가 있는 경우 버전을 커밋할 수 없습니다. 커밋을 시도하기 전에 모든 오류를 해결합니다.

버전을 커밋하는 경우:
+ 커밋된 버전은 읽기 전용 스냅샷이 됩니다.
+ 현재 런타임 구성은 커밋된 버전과 함께 저장됩니다.
+ 편집을 계속하기 위해 해당 스냅샷을 기반으로 새 라이브 버전이 생성됩니다.

**중요**  
커밋된 버전만 배포할 수 있습니다. 라이브 버전을 배포하려면 먼저 커밋해야 합니다.

### 버전 보기
<a name="viewing-versions"></a>

다음 두 위치에서 버전을 봅니다.
+ **캔버스의 버전 드롭다운** - 기본적으로 라이브 버전으로 설정됩니다. 드롭다운에서 이전 버전을 선택하여 캔버스에서 읽기 전용 모드로 봅니다.
+ **버전 탭** - 프로젝트 세부 정보에서 찾을 수 있습니다. 버전 번호, 버전이 커밋된 시간, 버전을 커밋한 사용자 및 버전 정보를 포함한 전체 버전 기록을 표시합니다. 작업 메뉴를 클릭하여 버전 세부 정보를 보거나 버전을 배포합니다.

### 이전 버전 복원
<a name="restoring-previous-versions"></a>

이전 버전을 복원하고 라이브 버전으로 계속 편집하려면:
+ 캔버스 위의 버전 드롭다운에서 버전을 선택합니다.
+ **라이브 버전 복원**을 선택합니다.
+ 선택한 버전이 현재 라이브 버전을 대체합니다.
+ 라이브 버전을 계속 편집하여 필요한 조정 수행
+ 스냅샷을 생성하거나 업데이트를 배포하려면 새 버전으로 커밋합니다.

**참고**  
버전을 복원하면 새 작업 복사본이 생성되지만 버전 기록은 삭제되지 않습니다.

### 모범 사례
<a name="version-best-practices"></a>
+ 명확한 버전 정보를 추가하여 변경 목적을 추적합니다.
+ 중요한 업데이트 후 버전 커밋
+ 커밋하기 전에 변경 사항 테스트
+ 커밋하기 전에 런타임 구성 검토