Agente de comercio
Crea un agente de compras y un agente para comerciantes en Claude con Claude for commerce, un blueprint de código abierto con implementaciones funcionales en la Messages API, el Claude Agent SDK y Claude Managed Agents.
Esta guía muestra cómo crear agentes de comercio en Claude. El primero es un agente de compras que los clientes usan dentro de tu aplicación. El segundo es un agente para comerciantes, dirigido a las personas que gestionan la tienda, ya sea el propio personal de operaciones del negocio o los vendedores de su plataforma. Para ello usa Claude for commerce, un "blueprint" (plano de referencia) de código abierto que incluye:
- Una implementación funcional de cada agente en la Messages API, el Claude Agent SDK y Claude Managed Agents.
- Ejemplos ejecutables para comercio minorista, viajes, telecomunicaciones y entretenimiento.
- Un plugin de Claude Code que genera la estructura del mismo diseño sobre tus propios sistemas.
El código, las instrucciones de configuración y la documentación de seguridad están en el repositorio de Claude for commerce en GitHub. El artículo de ingeniería Una guía sobre la anatomía de los agentes de comercio eficaces explica cómo se construyen los agentes y por qué. Cubre el diseño de un solo agente con "skills" (habilidades), los componentes de interfaz de usuario como herramientas, la seguridad aplicada por el "harness" (entorno de ejecución), el "prompt caching" (almacenamiento en caché de prompts), la memoria y las "evals" (evaluaciones).
El agente de compras
El agente de compras vive dentro de tu aplicación. Accede a tus sistemas a través de una única interfaz de backend que implementas sobre tus servicios de catálogo, carrito, preferencias, pedidos, políticas y cumplimiento de pedidos. Ningún método de esa interfaz realiza un pedido ni mueve dinero. En una conversación, el agente puede:
- Buscar en el catálogo, comparar finalistas y convertir una necesidad descrita en una lista corta y una recomendación.
- Planificar un conjunto coordinado de artículos orientado a un objetivo, como un viaje, un evento o una habitación, y ajustarlo a un presupuesto.
- Mostrar productos, comparaciones, planes, el estado de los pedidos y el carrito como componentes de interfaz de usuario renderizados en la conversación.
- Llenar el carrito y transferir al cliente a tu proceso de pago.
- Responder preguntas sobre pedidos, entregas, devoluciones y políticas a partir de tus propios sistemas de pedidos y políticas.
- Recordar lo que un cliente le pide que recuerde y aplicarlo en sesiones posteriores.
Cinco skills se cargan bajo demanda:
- Búsqueda y descubrimiento
- Investigación de compras
- Planificación orientada a un objetivo
- Atención al cliente
- Memoria y personalización
Las reglas que el agente necesita en la mayoría de los turnos viven en el "system prompt" (indicación del sistema). Entre ellas están la fundamentación en datos, la semántica del carrito y del pago, y la presentación.
El agente solo menciona productos, precios, disponibilidad y condiciones de la tienda a partir de los resultados de herramientas presentes en la conversación. Las escrituras en el carrito solo aceptan ID de producto que una herramienta de catálogo o de pedidos haya devuelto en esa sesión. El proceso de pago prepara un resumen que el cliente confirma en tu aplicación. Si usas un proceso de pago alojado, tu backend devuelve su URL y la aplicación anfitriona la renderiza sin pasarla por el modelo.
El agente para comerciantes
El agente para comerciantes da soporte a las personas que gestionan la tienda. Accede a tus sistemas de analítica, catálogo, inventario, precios y campañas a través de su propia interfaz de backend, y puede:
- Explicar cómo le va al negocio: por qué cambió una métrica, qué segmento lo impulsó y el ritmo frente a un período comparable. Un delegado de análisis opcional ejecuta consultas de solo lectura dentro de un presupuesto de tiempo y tamaño.
- Presentar un resumen diario de lo que requiere atención, incluidos el stock bajo, los productos de baja rotación y las excepciones en pedidos.
- Mejorar el contenido de los listados y corregir los datos del catálogo a partir del material que proporciona el operador.
- Recomendar cambios de precio y promociones dentro de las "guardrails" (barreras de protección) de la tienda, con una vista previa del margen.
- Redactar borradores de campañas de marketing con audiencias, ubicaciones y presupuesto.
Sus cinco skills cubren información sobre el rendimiento, inventario y operaciones, catálogo y listados, precios y promociones, y campañas de marketing.
Cada escritura que propone el agente para comerciantes es un cambio preparado con un ID generado por el servidor, que el operador ve como una tarjeta de vista previa. Esto incluye actualizaciones de listados, cambios de precio, acciones de inventario, promociones y campañas.
Las barreras de protección se verifican cuando se prepara el cambio y de nuevo cuando se aplica. Entre ellas están la variación máxima de precio, la profundidad de las promociones, el tamaño de reabastecimiento, el presupuesto de campaña y los campos protegidos.
El cambio solo se aplica después de que una persona lo aprueba fuera de la conversación:
- En la ruta de la Messages API, con un botón en el portal del comerciante.
- En el Agent SDK, con una solicitud de confirmación en la consola.
- En Claude Managed Agents, con una política de permisos de preguntar siempre en la herramienta de aplicación.
Una aprobación escrita en el chat no aprueba nada.
Ejemplos por sector
Cada ejemplo incluye una tienda para clientes y un portal para comerciantes sobre datos ficticios.
| Sector | Tienda | Portal para comerciantes |
|---|---|---|
| Comercio minorista | Búsqueda, comparación, planes, carrito, pago y memoria sobre los componentes integrados | Resumen diario, reabastecimientos y correcciones de listados preparados, y el delegado de análisis sobre una vista SQL |
| Viajes | Inventario sujeto a fechas y un componente de itinerario | Calendario de ocupación y cambios de tarifa por rango de fechas |
| Telecomunicaciones | Contexto de la cuenta, una matriz de planes y divulgaciones de tarifas redactadas por el servidor | Combinación de planes, cambios de precio que indican las líneas afectadas y tarifas reguladas protegidas |
| Entretenimiento | Reservas temporales, listas de espera, transferencias, un mapa del recinto y divulgaciones de tarifas con todo incluido | Ritmo de ventas de eventos, liberaciones de reservas que añaden capacidad real y cambios de precio que preservan las tarifas |
Dónde se ejecuta
Los entornos de ejecución de la Messages API y del Agent SDK funcionan con la Claude API, Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry, o a través de tu propia puerta de enlace. La ruta de Claude Managed Agents se ejecuta en la Claude API. La guía de despliegue del repositorio muestra dónde selecciona cada ruta su plataforma y qué formato de ID de modelo espera cada una.
Crea el tuyo con el plugin de Claude Code
El blueprint incluye un plugin de Claude Code que usa el repositorio clonado como referencia y crea un agente sobre tus propios sistemas. Sus cuatro comandos cubren el camino desde cero hasta un agente probado:
| Comando | Qué hace |
|---|---|
/scaffold-commerce-agent | Te entrevista sobre tu stack, te presenta el plan y genera la estructura de un agente de compras, un agente para comerciantes o ambos sobre los paquetes de referencia |
/add-commerce-flow | Añade un flujo a un agente existente: copia su skill, conecta las herramientas que llama y escribe sus primeros casos de evaluación |
/author-commerce-evals | Crea un conjunto de evaluaciones con un ejecutor, los primeros casos sobre tu propio catálogo y una compuerta de reproducción para CI |
/review-commerce-agent | Mapea un agente que ya ejecutas, lo compara con la referencia y convierte las partes que elijas |
El plugin también incluye seis skills, que se cargan cada vez que una conversación de Claude Code coincide con ellas:
- Arquitectura
- Almacenamiento en caché de prompts
- Interfaz de usuario como herramientas
- Confianza y seguridad
- Evaluaciones
- Operaciones de comerciantes
Las instrucciones de instalación están en el README del repositorio.
Para adaptar la referencia manualmente:
- Implementa la interfaz de backend de compras o de comerciantes sobre tus servicios.
- Desactiva con los indicadores de configuración los sistemas que no tengas, para que se eliminen sus herramientas y sus líneas del prompt.
- Configura el nombre de tu marca, el nombre del asistente y su tono.
La guía de backend del repositorio explica la identidad y las credenciales, los flujos ordenados, la transferencia al proceso de pago y los productos con opciones. Un piloto puede implementar la búsqueda y los detalles de producto y dejar el resto como stubs.
Primeros pasos
Clona el blueprint y ejecuta ambos agentes localmente.
Lee cómo se construyen los agentes y por qué.
Was this page helpful?