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