Capa de integración para agentes en tiendas

Una capa de integración de agentes es el conjunto de capacidades de tienda que puede usar el asistente de IA personal de un consumidor. Puede permitirle encontrar productos, recibir una oferta actual, iniciar un pago compatible o consultar un pedido. Un protocolo acordado define la comunicación; una pasarela conecta esas peticiones con el catálogo, el pago y los pedidos del comercio.

Tu interfaz humana atiende al cliente directamente. Tu capa de integración de agentes expone capacidades al asistente del cliente. La conversación o la pantalla de aprobación del asistente son una tercera interfaz. Mantener esos papeles separados es lo que evita confundir una integración de tienda con un chatbot.

Capa de integración de agentes, Agent UI y Agent Harness

Capa de integración de agentes es el término principal de esta documentación. Nombra la conexión del lado del comercio que pone sus capacidades a disposición de un asistente.

Agent UI es un término informal que a veces se usa para una interfaz orientada a agentes. Lo evitamos como término principal porque sugiere una pantalla para personas y porque se solapa con AG-UI, un protocolo de comunicación entre agentes y aplicaciones orientadas al usuario.

Agent Harness nombra el entorno de ejecución del lado del asistente, alrededor del modelo: el software que gestiona su contexto, herramientas, bucle de ejecución, estado y controles de seguridad. El harness llama a una capa de integración de agentes. Exponer una integración no significa que aportes el harness.

Hasta dónde llega la analogía de la tienda de aplicaciones

Un directorio puede ayudar a una persona o a un asistente a encontrar una integración, identificar a su proveedor y entender para qué sirve. Después, la integración necesita una conexión real con el negocio.

Así que una ficha es solo descubrimiento. El protocolo define la comunicación, la pasarela implementa la conexión y la tienda ejecuta la operación admitida. No des por hecho un único mercado universal que usen todos los asistentes personales.

El artículo sobre la integración con asistentes personales cubre el modelo más amplio y sus implicaciones comerciales.

Las capas

Supongamos que un cliente pide un artículo dentro de un presupuesto y un plazo de entrega. El asistente usa una integración compatible para consultar productos y pedir una oferta. El cliente aprueba el compromiso requerido y el pago avanza por el camino admitido. La integración devuelve un resultado confirmado, o un estado explícitamente sin resolver.

En qué se diferencian los protocolos

MCP ofrece una arquitectura cliente servidor por la que las aplicaciones de IA acceden a herramientas y contexto. UCP define capacidades de comercio y su descubrimiento. Responsabilidades relacionadas, pero no las mismas.

AG-UI trata la comunicación por eventos entre agentes y aplicaciones orientadas al usuario. No es un directorio de tiendas ni un protocolo universal de compra. El scaffolding del agente le aporta herramientas, contexto y reglas de ejecución.

Usar un protocolo no establece que cualquier asistente pueda transaccionar con tu tienda. Verifica versiones, capacidades admitidas, autenticación, restricciones de mercado y el camino de pago real.

Qué debe preservar una pasarela

Mantén el sistema de comercio como referencia para precios, inventario, elegibilidad y estado de pedidos. La consulta de producto puede ser pública mientras el acceso a pedidos de un cliente exige autorización. Concede acceso a las operaciones necesarias, no a la administración general de la tienda.

Una conexión no es consentimiento general de compra. El cliente debe entender el artículo, el total, el destino y las condiciones que cubre una aprobación. Si cambian las condiciones, puede hacer falta una decisión nueva.

Las peticiones repetidas no deben crear compras duplicadas. Si se pierde una respuesta, comprueba la operación existente antes de repetirla. Distingue un carrito creado, un pedido confirmado, un pago, una solicitud de cancelación y un reembolso completado. Son requisitos de diseño para una integración fiable.

Si necesitas una pasarela propia

A menudo no. Puede que tu plataforma de comercio ya aporte la integración que necesitas. Una pasarela puede ser una función de la plataforma, un adaptador o un servicio compartido que cubra los huecos entre sistemas.

Empieza por un recorrido de cliente admitido. Prueba el descubrimiento, una oferta actual, la autorización, el pago y la relectura del pedido. Incluye un producto no disponible y una petición interrumpida. El artículo sobre tiendas DTC aplica este proceso a la tienda de un anunciante.

Esta documentación describe un modelo de integración. No afirma que YieldBI ofrezca hoy una pasarela así, ni que todos los asistentes personales admitan el mismo ecosistema.