Puedes usar herramientas de widgets para crear elementos de IU interactivos y enriquecidos para tu interfaz de usuario de una manera flexible. Cuando configuras esta herramienta, proporcionas un tipo (carrusel, comparación, etcétera) y la información sobre el esquema del widget. Cuando responde preguntas, el agente puede decidir usar esta herramienta y configuración para enviar datos del widget a tu cliente. Luego, tu cliente procesa estos datos y presenta el widget en tu interfaz de usuario. Cuando el usuario realiza una selección, le envías esta información al agente.
Configuración
Están disponibles los siguientes parámetros de configuración:
- Nombre: Es un nombre único para la herramienta (obligatorio).
- Descripción: Una descripción de lo que hace la herramienta (opcional). Esto ayuda al modelo de lenguaje del agente a comprender cuándo usar esta herramienta y cómo completar los datos.
- Tipo de widget:
Es el tipo específico de widget de contenido enriquecido que representa esta herramienta.
Esto determina la estructura esperada de la carga útil y cómo el cliente debe renderizarla.
Los tipos son los siguientes:
- PRODUCT_CAROUSEL: Muestra un carrusel desplazable de productos.
- PRODUCT_DETAILS: Muestra información detallada sobre un solo producto.
- QUICK_ACTIONS: Presenta una lista de botones de respuestas sugeridas o acciones que el usuario puede realizar.
- PRODUCT_COMPARISON: Muestra una comparación en paralelo de varios productos.
- ORDER_SUMMARY: Muestra un resumen de un pedido.
- Parámetros: Es el esquema de entrada para los datos del widget. El agente usa el esquema cuando invoca la herramienta. Esto se define con un objeto de esquema, que especifica los campos y los tipos de datos esperados para el contenido del widget.
Ejemplos de descripciones de herramientas
Estos son ejemplos de descripciones de herramientas eficaces:
| Tipo de widget | Descripción de la herramienta de ejemplo |
|---|---|
| Carrusel de productos | Genera un componente de carrusel de IU. Se requiere siempre que el usuario solicite ver opciones o un catálogo. Debes proporcionar la lista de productos en productDetails, y el sistema renderizará automáticamente la tarjeta visual. |
| Detalle del producto | Se debe llamar a esta herramienta después de obtener la información de un producto y tratar de mostrárselo al usuario. |
| Acción rápida | Se debe llamar a esta herramienta cada vez que se le pregunte al usuario si es una empresa, una institución educativa o una organización sin fines de lucro. Incluye exactamente 3 acciones rápidas que digan "Soy una empresa", "Soy una escuela" y "Soy una organización sin fines de lucro". |
| Comparación de productos | Se debe invocar esta herramienta cuando se te solicite que compares 2 productos. |
| Resumen del pedido | Usa esta herramienta cuando un usuario esté listo para finalizar una compra. Genera un resumen visual estructurado del artículo, el desglose del precio (incluidos los impuestos y el envío) y la forma de pago registrada. Llama a esta herramienta solo después de que el usuario confirme que desea continuar con la fase de confirmación de compra. |