Herramientas de widgets

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 a las consultas, 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

Los siguientes parámetros de configuración están disponibles:

  • Nombre: Es un nombre único para la herramienta (obligatorio).
  • Descripción: Es 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 propagar 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 producto específico.
    • QUICK_ACTIONS: Presenta una lista de botones de respuesta o acciones sugeridas 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

A continuación, se muestran ejemplos de descripciones de herramientas eficaces:

Tipo de widget Ejemplo de descripción de la herramienta
Carrusel de productos Genera un componente de carrusel de la IU. Es obligatorio cuando el usuario solicita 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 institución educativa" y "Soy una organización sin fines de lucro".
Comparación de productos Se debe invocar esta herramienta cuando se te solicite comparar 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 de precios (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 la compra.