위젯 도구를 사용하여 유연한 방식으로 사용자 인터페이스의 풍부한 대화형 UI 요소를 만들 수 있습니다. 이 도구를 구성할 때는 유형 (캐러셀, 비교 등)과 위젯 스키마에 관한 정보를 제공합니다. 쿼리에 응답할 때 에이전트는 이 도구와 구성을 사용하여 위젯 데이터를 클라이언트에 다시 전송할 수 있습니다. 그러면 클라이언트가 이 데이터를 처리하고 사용자 인터페이스에 위젯을 표시합니다. 사용자가 선택하면 이 정보를 에이전트에 다시 전송합니다.
구성
다음 구성 설정을 사용할 수 있습니다.
- 이름: 도구의 고유한 이름입니다 (필수).
- 설명: 도구의 기능에 관한 설명입니다 (선택사항). 이렇게 하면 에이전트의 언어 모델이 이 도구를 사용해야 하는 시점과 데이터를 채우는 방법을 이해하는 데 도움이 됩니다.
- 위젯 유형: 이 도구가 나타내는 특정 유형의 리치 콘텐츠 위젯입니다.
이 유형은 페이로드의 예상 구조와 클라이언트가 페이로드를 렌더링하는 방법을 결정합니다.
유형은 다음과 같습니다.
- PRODUCT_CAROUSEL: 스크롤 가능한 제품 캐러셀을 표시합니다.
- PRODUCT_DETAILS: 단일 제품에 관한 세부정보를 표시합니다.
- QUICK_ACTIONS: 사용자에게 표시할 수 있는 추천 답장 버튼 또는 작업 목록을 표시합니다.
- PRODUCT_COMPARISON: 여러 제품을 나란히 비교하여 표시합니다.
- ORDER_SUMMARY: 주문 요약을 표시합니다.
- 매개변수: 위젯 데이터의 입력 스키마입니다. 에이전트는 도구를 호출할 때 스키마를 사용합니다. 스키마 객체를 사용하여 정의되며 위젯 콘텐츠의 예상 필드와 데이터 유형을 지정합니다.
샘플 도구 설명
다음은 효과적인 도구 설명의 샘플입니다.
| 위젯 유형 | 샘플 도구 설명 |
|---|---|
| 제품 캐러셀 | UI 캐러셀 구성요소를 생성합니다. 사용자가 옵션 또는 카탈로그를 보려고 할 때마다 필요합니다. productDetails에 제품 목록을 제공해야 하며 시스템에서 시각적 카드를 자동으로 렌더링합니다. |
| 제품 세부정보 | 이 도구는 제품 정보를 가져온 후 사용자에게 이 제품을 표시하려고 할 때 호출해야 합니다. |
| 빠른 작업 | 이 도구는 사용자에게 비즈니스, 학교 또는 비영리 단체인지 묻는 메시지가 표시될 때마다 호출해야 합니다. '비즈니스입니다', '학교입니다', '비영리 단체입니다'라고 읽히는 빠른 작업 3개를 포함합니다. |
| 제품 비교 | 이 도구는 제품 2개를 비교하라는 메시지가 표시될 때 호출해야 합니다. |
| 주문 요약 | 사용자가 구매를 완료할 준비가 되면 이 도구를 사용합니다. 이 도구는 상품, 가격 분석 (세금 및 배송비 포함), 등록된 결제 수단의 구조화된 시각적 요약을 생성합니다. 사용자가 결제 단계로 진행하기를 원한다고 확인한 후에만 이 도구를 호출합니다. |