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

# 오케스트레이션
<a name="actions-orchestration"></a>

오케스트레이션을 사용하면 복잡한 end-to-end 프로세스를 자동화하여 필요한 경우 자동화된 작업을 인간의 결정에 맞게 조정할 수 있습니다. Amazon Quick Automate의 오케스트레이션 기능에는 작업 항목을 추적하기 위한 사례 관리와 human-in-the-loop 루프 통합이 포함됩니다.

## 사례 관리
<a name="case-management"></a>

사례는 새 클레임, IT 지원 티켓, 고객 불만 또는 새 인보이스와 같이 자동화가 처리할 개별 작업 항목을 추적합니다. 각 사례에는 다음이 포함됩니다.
+ 고유한 참조 이름(예: "Order-12345")
+ 관련 작업을 그룹화하기 위한 사례 유형(예: "판매 주문")
+ 키-값 페어로 저장된 사용자 지정 데이터
+ 상태 추적 및 감사 추적이 포함된 정의된 수명 주기
+ 해당하는 경우 연결된 human-in-the-loop 작업

### 사례 상태 수명 주기
<a name="case-status-lifecycle"></a>

자동화를 통한 작업 진행 상황을 추적하기 위해 사례는 특정 상태 전환과 함께 정의된 수명 주기를 따릅니다.
+ `Ready` - 사례가 생성되었으며 처리를 위해 픽업되기를 기다리고 있습니다. 이는 모든 새 사례의 초기 상태입니다.
+ `In Progress` - 자동화에서 사례를 적극적으로 처리하고 있습니다. 로그를 통해 실시간 진행 상황을 모니터링할 수 있습니다.
+ `Pending Resolution` - 케이스가 처리를 계속하기 전에 human-in-the-loop 루프 작업이 완료될 때까지 기다리고 있습니다. 작업이 해결되면 사례가 자동으로 준비 상태로 돌아갑니다.
+ `Successful` - 사례가 예외 없이 모든 처리 단계를 완료했습니다.
+ `Failed` - 사례에 다음 예외 유형 중 하나가 발생했습니다.
  + 비즈니스 예외 - 사례에서 처리된 비즈니스 규칙 위반이 발생하여 처리가 중지되었습니다. 자세한 예외 정보는 로그에서 확인할 수 있습니다.
  + 시스템 예외 - 사례에 기술 오류가 발생하여 처리가 중지되었습니다. 자세한 오류 정보는 로그에서 확인할 수 있습니다.

### 작업
<a name="case-actions"></a>

Amazon Quick Automate는 수명 주기 동안 사례를 생성, 처리 및 관리하기 위해 다음과 같은 작업을 제공합니다.

새 사례 생성  
단일 사례를 생성하여 작업을 추적합니다. 각 사례에는 참조 이름(예: "Order-12345")이 있으며 사용자 지정 데이터를 키-값 페어로 저장합니다. 사례는 조직 및 보고를 위해 유형(예: “판매 주문”)별로 그룹화됩니다. 속성:  
+ `Title` (선택 사항) - 프로세스 시각화에 표시된 작업 이름(예: "판매 주문 사례 생성")
+ `Reference name` (필수) - 모니터링 대시보드에서 사례를 검색하고 추적하는 데 사용되는 비즈니스 식별자(예: "Order-12345")
+ `Case type` (필수) - 비즈니스 목적별로 관련 사례를 그룹화하는 레이블입니다. 조직 및 지표 추적 제공(예: "판매 주문", "지원 티켓")
+ `Custom data` (필수) - 키-값 페어로 저장된 추가 사례 정보입니다. 이 데이터는 사용자에게 표시되며 사례 처리 중에 검색, 업데이트 또는 추가할 수 있습니다(예: \$1"Product": "ABC-12345", "Qty": "100", "Priority": "High"\$1).

여러 사례 생성  
대량은 데이터 테이블에서 사례를 생성합니다. 각 행은 지정된 사례 유형을 상속하고 참조 이름에 지정된 열을 사용하여 새 사례가 됩니다. 다른 모든 열은 사용자 지정 데이터 필드가 됩니다. 속성:  
+ `Title` (선택 사항) - 프로세스 시각화에 표시된 작업 이름(예: "인보이스 배치에서 사례 생성")
+ `Case type` (필수) - 비즈니스 목적별로 관련 사례를 그룹화하는 레이블(예: "인보이스 처리")
+ `Cases data table` (필수) - 각 행이 새 사례를 생성하는 데이터 테이블입니다. 모든 열은 사용자 지정 데이터(예: cases\$1table)로 저장됩니다.
+ `Reference column name` (필수) - 각 사례에 대한 참조 이름 식별자가 포함된 열의 이름(예: "인보이스 번호")

프로세스 사례  
'Ready' 상태의 사례를 루프스루합니다. 처리 중에 사례를 '진행 중'으로 이동하고 완료에 따라 성공 또는 실패로 표시하여 사례 상태를 자동으로 관리합니다. 프로세스 사례 루프 내에 작업을 추가할 때 발견되지 않은 예외가 처리되어 관련 오류 세부 정보와 함께 사례를 실패로 표시하고 다음 사례로 이동합니다. 또한이 작업은 처리 중에 사례 데이터에 대한 액세스를 제공합니다. 속성:  
+ `Title` (선택 사항) - 프로세스 시각화에 표시된 작업 이름(예: "처리 보류 중 인보이스")
+ `Case type` (필수) - 처리할 사례 유형(예: "인보이스 처리")
+ `Current case` (출력) - 각 루프에서 처리 중인 사례를 포함하는 변수입니다. current\$1case["custom\$1data"]["key\$1name"]를 사용하여 사례 데이터에 액세스

사례 데이터 업데이트  
처리 중에 사례 정보에 대한 변경 사항을 저장합니다. 새 필드를 추가하거나 기존 데이터를 수정할 수 있습니다. 사례가 '진행 중'인 경우에만 사용할 수 있습니다. 처리 결과를 추적하고 사례 수명 주기를 관리하는 데 사용됩니다. 속성:  
+ `Title` (선택 사항) - 프로세스 시각화에 표시된 작업 이름(예: " 사례 상태 업데이트")
+ `Case ID` (필수) - 업데이트할 사례의 고유 식별자(예: current\$1case["case\$1id"])
+ `Data to update` (필수) - 키-값 페어로 저장할 새 정보 또는 수정된 정보(예: \$1"Status": "Approved", "ProcessedDate": "2024-01-20"\$1)
+ `Updated case` (출력) - 수정된 사례를 포함하는 변수입니다. update\$1case["custom\$1data"]["key\$1name"]를 사용하여 업데이트된 데이터에 액세스

사례 검색  
보고 및 분석을 위한 사례를 검색합니다. 사례 유형, 상태 또는 참조 이름을 기준으로 필터링합니다. 결과를 사례 정보 및 사용자 지정 데이터가 포함된 데이터 테이블로 반환합니다. 속성:  
+ `Title` (선택 사항) - 프로세스 시각화에 표시된 작업 이름(예: "연체 사례 찾기")
+ `Case type` (필수) - 검색할 사례 유형(예: "지원 티켓")
+ `Filter by status` (선택 사항) - 현재 상태를 기준으로 사례를 필터링합니다(예: “해결 보류 중”).
+ `Filter by reference name` (선택 사항) - 특정 참조 이름(예: "Ticket-12345")이 있는 사례를 필터링합니다.
+ `Maximum results` (선택 사항) - 반환할 사례 수를 제한합니다. 최대 10,000개(예: 100개)의 모든 사례를 반환하려면 비워 둡니다.
+ `Search results` (출력) - 검색으로 검색된 사례의 데이터 테이블을 저장할 변수 이름(예: cases\$1table)

## HITL(Human-in-the-Loop)
<a name="human-in-the-loop"></a>

많은 결정을 자동화할 수 있지만 일부 시나리오에서는 사람의 판단이 필요합니다. Amazon Quick Automate의 HITL 기능을 사용하면 인간의 의사 결정을 자동화된 프로세스에 원활하게 통합할 수 있습니다. HITL 작업을 생성하는 방법에는 두 가지가 있습니다.
+ 사용자 작업 생성 작업 사용
+ 사용자 지정 에이전트를 통한 HITL 채팅 사용

### 사용자 작업 생성
<a name="create-user-task"></a>

인적 입력에 대한 작업을 생성합니다. 작업은 사용자가 검토하거나 결정을 내리거나 정보를 제공할 수 있도록 목록에 표시됩니다. 작업은 사례가 진행되는 동안 사례 처리 루프에 있을 때만 생성할 수 있습니다. 작업을 생성하면 사례가 '작업 보류 중' 상태로 이동하고 자동화는 다음 사례로 계속됩니다. 작업이 해결되면 케이스는 추가 처리를 위해 '준비됨' 상태로 돌아갑니다. 속성:
+ `Title` (필수) - 사용자의 작업 목록에 나타나는 제목 줄입니다. 수행해야 할 작업을 명확하게 설명해야 합니다(예: "대출 신청 검토", "비용 보고서 승인").
+ `Description` (필수) - 작업을 완료하는 사용자에게 제공되는 세부 지침 및 컨텍스트(예: "첨부된 애플리케이션 세부 정보를 검토하고 다음 기준에 따라 승인 또는 거부하십시오...")
+ `Form` (필수) - 사용자로부터 구조화된 입력을 수집하기 위한 인터페이스
+ `Severity` (필수) - 사용자가 작업을 분류하는 데 도움이 되는 우선순위 수준:
  + 심각 - 긴급 주의 필요, 최우선 순위
  + 보통 - 일반 우선 순위(기본값)
  + 낮음 - 긴급하지 않은 작업
+ `Due in` (필수):
  + 숫자 - 시간 단위의 양(예: 24)
  + 단위 - 시간 또는 일
+ `Case ID` (필수) -이 작업이 사용되는 사례의 고유 식별자(예: current\$1case["case\$1id"])

**중요**  
HITL 작업을 생성할 때:  
사례 처리 루프는 사례 상태를 해결 보류 중으로 자동 업데이트하고 다음 사례로 이동합니다.
현재 사례에 대해 실행되지 않으므로 프로세스 사례 루프 내에 작업을 생성한 후 작업을 추가하지 마십시오.

#### 양식 작성
<a name="building-forms"></a>

HITL 작업을 생성할 때 사용자 지정 양식을 작성하여 인적 검토자로부터 필요한 정보를 정확히 수집할 수 있습니다. 양식 설계에 사용할 수 있는 구성 요소는 다음과 같습니다.
+ 텍스트 필드 - 사용자 입력을 수집하기 위한 단일 또는 다중 줄 텍스트 입력(예: "거부 이유를 자세히 제공하십시오")
+ 드롭다운 - 사전 정의된 옵션(예: ["Approve", "Reject", "Escalate"]) 중에서 선택
+ 날짜/시간 선택기 - 달력 기반 입력
+ 미디어 - 검토할 이미지 또는 문서 표시
+ 텍스트 표시 - 컨텍스트를 제공하는 읽기 전용 정보(예: 사례 세부 정보, 정책 참조)

### HITL 채팅
<a name="hitl-chat"></a>

보다 동적인 상호 작용이 필요한 시나리오의 경우 Amazon Quick Automate는 사용자 지정 에이전트를 통한 HITL 채팅도 지원합니다. 이렇게 하면 에이전트와 인적 검토자 간의 자연어 대화가 가능합니다. 에이전트는 인적 입력이 필요할 때 HITL 작업을 생성할 수 있습니다. 에이전트가 인적 검토자와 채팅하는 동안 사례는 진행 중으로 유지됩니다. 충분한 입력이 제공되면 에이전트가 계속됩니다.

```
# Example agent prompt for HITL chat
"""
Review the data and if any values are outside normal ranges,
create a HITL task for human review. Include the specific
values and acceptable ranges in the task description.
"""
```

**참고**  
HITL 채팅 작업에는 기본 심각도(보통)가 부여되며 기한은 (24시간)입니다.

### 작업 해결 및 사례 재입력
<a name="task-resolution-case-reentry"></a>

사람이 HITL 작업을 완료하면 자동화가 사례의 처리 복귀를 처리해야 합니다. 작업 해결 데이터로 작업하는 방법을 이해하는 것은 효과적인 human-in-the-loop 워크플로우를 구현하는 데 중요합니다. 작업이 해결된 경우:
+ 연결된 사례가 자동으로 준비 상태로 돌아갑니다.
+ 사례 처리를 통해 사례를 다시 처리할 수 있게 됩니다.
+ latest\$1task\$1resolution 필드에는 모든 양식 입력 및 결정이 포함됩니다.

HITL 해상도를 확인하고 이에 따라 사례를 처리하는 예:

```
# Example handling HITL resolution
if current_case["latest_task_resolution"]:
    # Handle case returning from HITL
    resolution_data = current_case["latest_task_resolution"]["form_data"]
    if resolution_data["decision"] == "Approve":
        # Process approved case
    else:
        # Handle rejected case
else:
    # First time processing this case
```

HITL 해상도 처리 모범 사례:
+ 사례를 처리할 때 항상 latest\$1task\$1resolution 확인
+ 새로운 사례와 HITL에서 반환되는 사례를 모두 처리하도록 로직 구성
+ 사람의 결정에 따라 다양한 처리 경로를 구현하는 것을 고려하세요.
+ 누락되거나 잘못된 해결 데이터에 대한 오류 처리 포함