Hawkers Agentforce — Asistente Virtual

Asistente conversacional de recomendación de gafas de sol integrado en Salesforce Agentforce y desplegado en el storefront de Salesforce Commerce Cloud (SFCC).

Permite a los clientes obtener recomendaciones personalizadas en lenguaje natural. Razona sobre los atributos estructurados del catálogo y devuelve resultados con URL y precio correctos para el locale del cliente.

---

Estado actual

Elemento	Estado
Entorno operativo	✅ Funcional en UAT Sandbox
Despliegue a producción	❌ Pendiente
Cobertura de tests	✅ ~95% (9 casos)
Locales soportados	✅ 20 locales configurados
Embed Commerce Cloud	✅ Listo para sandbox / ❌ Pendiente producción

---

Capacidades

• Responde en el idioma del cliente (20 locales configurados).
• Califica el uso antes de buscar (deporte, conducción, pantallas, moda…).
• Razona los atributos del catálogo desde el Knowledge Base.
• Filtra por: tipo de lente, forma de montura, material, estilo, color, género, colaboración.
• Devuelve productos con imagen, precio localizado y URL directa.
• Nunca recomienda marcas competidoras.
• Política D&I: no hace asunciones por género, edad o características personales.
• Relajación automática de filtros si no hay resultados exactos.

---

Arquitectura — 4 capas

Capa	Componente	Descripción
1 — Frontend	embed_snippet_sandbox.html	Widget de chat embebido en SFCC. Detecta el locale desde la URL. Carga el agente vía Messaging API.
2 — Agente IA	Agentforce Agent 0XxRR0000009yJV0AY	Motor conversacional Einstein. Usa instrucciones v3 como system prompt.
3 — Acción Apex	SS_SearchProductsAction	Recibe atributos estructurados. Ejecuta queries dinámicas sobre Product2. Devuelve JSON con hasta 5 productos.
4 — Datos	Product2 + campos SS_*	Objeto estándar con 15 campos custom. ~7.290 registros. 20 locales con URL y precio propios.

Flujo de una interacción

1. Cliente escribe en el chat del storefront.
2. Snippet detecta el locale desde la URL y lo inyecta en el contexto.
3. Mensaje llega al agente Agentforce.
4. Agente lee instrucciones v3, califica el uso (1-2 preguntas) y razona atributos.
5. Agente invoca SS_SearchProductsAction con atributos + locale.
6. Apex ejecuta query dinámica sobre Product2 con filtros AND.
7. Si 0 resultados → relaja filtro de género; si sigue vacío → fallback general.
8. Devuelve JSON con hasta 5 productos aleatorizados.
9. Agente formatea respuesta en Markdown con imágenes y links.
10. Cliente ve 2-3 productos con imagen, precio y enlace.