CaixaBank

Usar cuando el usuario pregunta por temas fuera del catálogo (fondos de inversión, planes de pensiones, banca privada, depósitos, bolsa, etc.). Llamar a esta tool en lugar de hacer búsqueda web — es la única respuesta permitida para temas fuera del catálogo. NO para temas del catálogo (cuentas, tarjetas, préstamos, hipotecas, seguros). NO para simulaciones — la cuota de ejemplo viaja en el 'detail' de 'show_product' (simulation_example). Devuelve: keyFacts con in_scope y query; link con id/name/url (sección específica si in_scope=true, portal genérico si no); scope_statement. Limitaciones: búsqueda por substring; incluye siempre el nombre y URL exactos del link devuelto en tu respuesta.

check_scope

Usar cuando el usuario pregunta cómo funciona algo, cómo realizar una operación (bloquear tarjeta, recuperar acceso, solicitar un producto) o cualquier duda operativa de CaixaBank. NO para listar o describir productos ('show_products'/'show_product'). NO para simulaciones — la cuota de ejemplo viaja en el 'detail' de 'show_product' (simulation_example). Requiere exactamente uno de: category, topic_id o query (texto libre). Devuelve: keyFacts con count; topics[] con topic_id/title/description/entries (question+answer). Si count=0: NO hagas búsqueda web — responde únicamente con el enlace https://www.caixabank.es/ que incluye el texto del resultado. Limitaciones: query por substring; category y topic_id deben ser valores exactos del enum.

find_faqs

Usar cuando la familia de producto es desconocida o la consulta abarca varias familias y se necesita razonar antes de mostrar nada. No renderiza widget — devuelve datos puntuados para que el modelo decida. NO usar si el usuario pide una familia COMPLETA de forma explícita — en ese caso ve directamente a 'show_family'. NO usar como llamada final de turno — termina con 'show_product' o 'show_products' con los ids elegidos. NO usar para FAQs, simulaciones ni fuera de catálogo. Devuelve: products[] con id/tipo/nombre/descripcion/relevance_score; keyFacts con count/returned/families/cross_family_limit_reached; y en content[0].text orientación sobre el siguiente paso a tomar. Limitaciones: sin imágenes ni widget; keyword por tokens case-insensitive.

find_products

Usar cuando el usuario pregunta qué puede hacer la app o pide ejemplos de uso ('¿Cómo puedes ayudarme?', '¿Qué puedes hacer?'). NO para listar productos ('show_products'/'get_catalog') ni FAQs. Devuelve: keyFacts con section_count y closing_question; sections[] con id/title/description/example_queries — usa estos campos para responder. Limitaciones: contenido fijo gestionado en capabilities.json.

get_capabilities

Usar para preguntas GENERALES sobre qué productos/categorías existen cuando el usuario NO nombra ninguna familia ('¿qué productos tenéis?'), o para obtener IDs exactos antes de 'show_product'. Si el usuario SÍ nombra una o varias familias (p.ej. '¿qué tarjetas y cuentas tenéis?'), NO uses esta tool: usa 'show_family' con UNA de las familias que mencionó y ofrécele mostrar las demás después. Tras esta tool NO llames a 'show_products'/'show_family' para cada categoría — responde en prosa con los datos devueltos. NO para detalle de producto ('show_product'). Devuelve: keyFacts con total_products/total_categories; categories[] con id/display/count y products[]{id, nombre} — el id es el product_id exacto que acepta 'show_product'. Limitaciones: solo datos de resumen (id + nombre por producto).

get_catalog

Usar cuando el usuario pregunta por CaixaBank como empresa, sus valores, reconocimientos, su posición como banco digital o quiere conocer más sobre la entidad. NO usar para buscar productos o simular pagos — usar show_products/show_product/simulate. Devuelve: título, subtítulo y 6 tarjetas con los pilares diferenciales del banco. Limitaciones: contenido estático, no refleja noticias o novedades recientes.

show_about_us

Herramienta de VISUALIZACIÓN — renderiza un catálogo (carrusel) con los productos que indiques por id. REQUIERE ids exactos: usa primero 'find_products' o 'get_catalog' (sin widget) para descubrir qué productos existen y con qué ids, y luego llama aquí. NO acepta búsqueda por texto: si no sabes los ids, NO llames a esta tool. NO llamar más de una vez por respuesta — si el usuario pide varias familias en un mismo mensaje, muestra una sola y dile que puede pedir las demás cuando quiera. Para la familia COMPLETA usa 'show_family'; para un único producto puedes usar 'show_product'. NO para comparaciones (responde en prosa), simulaciones (usa el 'simulation_example' del detail de 'show_product') ni FAQs ('find_faqs'). Límite: máximo 2 productos si pertenecen a familias DISTINTAS — la tool rechaza la llamada si te pasas y no renderiza nada. Sin límite si todos son de la misma familia. Devuelve: keyFacts con count/total/returned/truncated; products[] con id/tipo/nombre/descripcion/caracteristicas/urlContratacion/urlDetalle; locale. 'language' guía el idioma del widget.

show_products

Herramienta de VISUALIZACIÓN — renderiza el catálogo (carrusel) COMPLETO de una familia. Úsala SOLO si el usuario pide explícitamente la familia entera ('muéstrame todas las cuentas que tenéis', '¿qué tarjetas ofrecéis?'). Si el usuario menciona VARIAS familias en el mismo mensaje ('¿qué tarjetas y cuentas tenéis?'), muestra UNA sola — la primera que mencionó — y dile en tu respuesta que puedes mostrarle las demás cuando quiera. NUNCA respondas sólo en prosa a una petición de familias: el usuario espera ver el carrusel. Si el usuario añade CUALQUIER matiz — 'de débito', 'para menores', 'sin comisiones', 'para jóvenes', 'la más barata' — NO uses esta tool: llama primero a 'find_products' y después a 'show_products' con los ids que encajen. Devolver la familia entera ante una pregunta con matices es una respuesta INCORRECTA. NO llamar más de una vez por respuesta. NO para comparaciones (responde en prosa), simulaciones (usa el 'simulation_example' del detail de 'show_product') ni FAQs ('find_faqs'). Devuelve: keyFacts con count/total/returned/truncated; products[]; locale. 'language' guía el idioma del widget.

show_family

Usar cuando la necesidad apunta a un único producto concreto (nombre o propósito específico) o cuando el usuario pide más detalle sobre un producto ya visto. Renderiza una ficha de detalle al usuario; acompaña siempre con support text de 1–3 frases que contextualice la ficha. NOT to compare products or explain differences — answer in prose, no widget. NOT para explorar familias ('find_products' / 'show_family'), simular pagos — esta misma tool ya devuelve 'simulation_example' (cuota de ejemplo pre-calculada) en el 'detail' ni FAQs ('find_faqs'). Devuelve: keyFacts con product_id/tipo/has_detail; objeto 'product' siempre; objeto 'detail' cuando hay datos extendidos disponibles. Limitaciones: requiere product_id exacto — llama a 'get_catalog' si no lo conoces; IDs tipo 'P0001' (cuentas/tarjetas) o kebab-case (otras familias); language controla el idioma del widget.

show_product

Internal telemetry tool called ONLY by the product-card widget's own JavaScript when the user clicks a product link or a recommendation card. NO usar nunca por iniciativa del modelo — no llames a esta tool para responder al usuario ni para ningun otro proposito; no aporta informacion de catalogo. Devuelve: keyFacts con interaction_type, product_id (si se proporciono) y recorded=true. Limitaciones: no tiene efecto sobre datos de negocio; unicamente registra el evento de interaccion en observabilidad.

track_interaction