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

# UI 에이전트
<a name="ui-agents"></a>

UI 에이전트는 복잡한 브라우저 작업을 수행하기 위한 자연어 지침을 이해하는 네이티브 에이전트입니다. 웹 사이트를 자율적으로 탐색하고, 데이터를 클릭, 입력, 읽고, 다운스트림 자동화 단계에 최적화된 구조화된 출력을 생성할 수 있습니다. 예제 사용 사례에는 웹 페이지의 제품 요약 또는 웹 사이트 탐색을 통한 데이터 가져오기가 포함됩니다.

## 속성
<a name="ui-agent-properties"></a>

제목  
단계/UI 에이전트의 이름

지침  
이 필드에서는 에이전트에 대한 프롬프트를 자연어로 작성합니다. 프롬프트 작성 모범 사례:  
+ 원하는 사항에 대해 명확하고 명시적으로 설명합니다.
+ 프롬프트를 구성합니다. 먼저 '작업' 또는 '역할'을 언급한 다음 '지침'을 참조하여 번호가 지정된 단계로 작업을 수행합니다.
+ 제약 조건 추가(예: 제품 섹션만 검토) 및 중지/종료 시기 지정(예: 관련 정보를 찾을 때 중지)
+ 긍정적 및 부정적(이렇게 하지 않음) 예제 제공
+ 길이 요구 사항(예: 100단어 미만) 또는 출력 형식(예: MM/DD/YY 형식의 날짜)을 명확하게 지정
텍스트를 트리플 따옴표(“"”)로 래핑하여 여러 줄 프롬프트를 작성합니다. 예제:  

```
"""Task: Locate the company's latest annual report.
* Visit the provided URL.
* Look for the annual report. The report may be titled 'Annual Report', 'Financial Report', 'Year in Review', or similar variations..."""
```

구조화된 출력(선택 사항)  
에이전트 응답:이 작업의 출력을 할당할 변수의 이름입니다.

## 구조화된 출력 필드를 구성하는 방법
<a name="ui-agent-structured-output"></a>

**필드 추가**
+ 필드 추가를 클릭하여 새 출력 필드를 생성합니다.
+ 출력 이름 입력 - JSON 속성 이름이 됩니다.
+ 드롭다운에서 유형을 선택합니다.
+ 필드가 항상 있어야 하는 경우 필수 확인
+ AI 에이전트를 안내하는 설명 추가

**필드 유형**
+ *문자열* - 텍스트 값(이름, 설명, 요약)
+ *숫자* - 숫자 값(개수, 점수, 백분율)
+ *부울* - True/false 값(상태 플래그, 예/아니요 질문)
+ *객체* - 중첩 구조(복잡한 데이터 그룹화)
+ *배열* - 항목 목록(태그, 범주, 여러 값)
+ *파일* - 파일 참조(문서 첨부 파일, 이미지)
+ *데이터 테이블* - 테이블 형식 데이터(구조화된 데이터 세트, 보고서)

**복합 유형 작업**

객체 및 어레이에는 중첩된 필드가 포함될 수 있습니다.
+ 객체 또는 배열 필드 옆의 확장 화살표(▶)를 클릭합니다.
+ 중첩 구조 내에서 필드 추가 사용
+ 최적의 성능을 위해 중첩을 최대 2\~3개 수준으로 유지

**구성의 예제**

다음은 고객 피드백을 요약하기 위한 간단한 구성입니다.

```
{
  "orderId": "12345",
  "numberOfOrders": 3,
  "hasShipped": true,
  "orderDetails": {
    "quantity": 2,
    "productName": "ABC",
  },
  "tags": ["electronics", "urgent"]
}
```

이 구조는 다음과 같이 구성됩니다.
+ orderId(문자열, 필수)
+ numberOfOrders(숫자, 필수)
+ hasShipped(부울, 필수)
+ orderDetails(객체, 필수)
  + 수량(숫자, 필수)
  + productName(문자열, 필수)
+ 태그(문자열 배열, 선택 사항)

**모범 사례**
+ 설명 필드 이름 사용 - AI가 추출할 데이터를 이해하도록 지원
+ 명확한 설명 추가 - 복잡한 필드에 대한 컨텍스트 제공
+ 필수 필드를 필수로 표시 - 필수 데이터가 항상 존재하는지 확인
+ 중첩 깊이 제한 - 더 나은 성능을 위해 구조를 단순하게 유지
+ 구성 테스트 - 에이전트 단계를 실행하고 응답을 확인하여 출력이 예상과 일치하는지 확인합니다.

**중요 정보**
+ JSON 지식: JSON에 익숙하지 않으신가요? json.org 기본 사항을 알아봅니다.
+ 검증 없음: 현재 시스템은 출력 구조를 검증하지 않습니다. 자동화가 누락되거나 잘못된 형식의 데이터를 처리하는지 확인합니다.