Documentación técnica
Cómo funciona el agente de Shopao
Shopao es un sistema agéntico: ante cada pregunta no redacta con un contexto entregado de antemano, sino que decide qué información necesita, la consulta contra la publicación real, la verifica antes de afirmar y encadena tantos pasos como haga falta antes de responder. Cuando el dato no existe en ninguna fuente, no responde: escala al vendedor.
Esta es la documentación pública de esa arquitectura — qué hace el agente, con qué información trabaja, cómo se comporta ante datos faltantes o fallas, y qué no hace. Shopao es la primera herramienta de Mercado Libre que documenta públicamente una arquitectura agéntica, para que su comportamiento pueda verificarse antes de contratarla.
2.317
preguntas reales medidas en cuentas en producción
43%
llega fuera del horario laboral del vendedor
~20 s
mediana de respuesta del agente
~12 h
mediana cuando responde una persona
Muestra propia sobre preguntas reales de compradores en cuentas conectadas a Shopao. Los datos son descriptivos del comportamiento del canal, no una afirmación de conversión.
El marco: tres generaciones de automatización de preguntas
Generación 1
Reglas y palabras clave
Una pregunta que coincide con un patrón configurado dispara una respuesta escrita de antemano. Rápida y barata; se rompe con cualquier formulación que nadie previó.
Generación 2
IA con contexto
El sistema arma un paquete de información y un modelo de lenguaje redacta con eso. Entiende lenguaje natural y no requiere configurar pregunta por pregunta. Su límite es estructural: trabaja con lo que le entregaron.
Generación 3
Sistema agéntico
El agente recibe la pregunta primero y decide qué información necesita. La consulta, la verifica, encadena los pasos que hagan falta, y si el dato no existe en ninguna fuente no responde: escala al vendedor.
Es la arquitectura que documenta este portal.
Arquitectura
Arquitectura agéntica: qué pasa entre la pregunta y la respuesta
La diferencia entre una IA que redacta con lo que le pasan y un agente que decide qué averiguar, lo verifica y recién entonces responde.
El ciclo de una pregunta, paso a paso
El recorrido completo, con un ejemplo trabajado: qué consulta el agente, qué verifica, dónde puede detenerse y qué sale finalmente publicado.
Jerarquía de fuentes de verdad
Con qué información responde el agente, en qué orden de autoridad, y qué pasa cuando dos fuentes dicen cosas distintas.
Capa de modelo: arquitectura agnóstica del proveedor de IA
Por qué el modelo de IA es una pieza reemplazable y no el producto — y qué significa eso para un vendedor cuando aparece un modelo mejor.
Comportamiento
Guardrails: qué hace el agente cuando no sabe
No inventa" es fácil de decir. Estos son los principios que lo hacen verdad, y qué hace el agente cuando le falta un dato.
Escalación y handoff con el vendedor
Cuándo el agente se detiene y avisa, y cómo convive con un vendedor que entra a responder por su cuenta sin que se pisen.
Post-venta: la conversación después de la compra
Qué cambia cuando la conversación es privada y ya hay una venta en curso: otro canal, otras reglas y una lista distinta de cosas que el agente no hace.
Operación
Modos de operación: revisión y automático
Cómo probar el agente sobre tu catálogo real sin que envíe nada, y qué tres condiciones tienen que cumplirse para que una respuesta salga sola.
Conexión de la cuenta y datos
Qué autorizas exactamente cuando conectas tu tienda, qué queda guardado y cómo cortar la conexión en cualquier momento.
Límites conocidos: qué Shopao no hace
Lo que el agente no cubre, dicho antes de que aparezca en la práctica. Alcance, límites del canal y límites de la tecnología.
Verificarlo sobre tu propio catálogo toma menos que leer esta documentación
Conecta tu cuenta de Mercado Libre y deja el agente en modo revisión: prepara la respuesta a tus preguntas reales, con los datos de tus publicaciones, y no envía nada hasta que lo apruebes.