Subagentes para el Agente de Compradores B2C

Agente Router

Cada conversación de agente comienza con el subagente Agent Router. Este subagente dirige una conversación al subagente específico del Agente de Comprador adecuado durante cada interacción con un comprador.

• Si un comprador responde con una respuesta ambigua durante una conversación, por ejemplo, ingresa "agregarlo", el Agente Router trata estas respuestas como relacionadas con la tarea actual, no como nuevas solicitudes.
• El agente enruta los mensajes basándose en el mensaje más reciente del comprador. Filtra automáticamente cualquier código en segundo plano, uso automatizado de herramientas o pasos técnicos realizados en mensajes anteriores. El agente reacciona precisamente a lo que el comprador está pidiendo en ese momento, sin interferencias de actividades previas del sistema.

Para personalizar el subagente del router:

• Agrega una ruta para exponer un nuevo subagente, o elimina (comenta) uno para desactivar una capacidad.
• Ajusta el mensaje de bienvenida o las instrucciones de enrutamiento. Por ejemplo, edita la descripción del router para primero dar la bienvenida al comprador en la primera sesión de chat.
• Reordenar o reformular la lógica de enrutamiento para influir en cómo el agente interpreta las solicitudes ambiguas y así las resuelve para ajustarlas a tu catálogo.

Subagentes de Agentes de Compradores

Los subagentes de Experto en Producto, Carrito y Confirmación de Pedido comparten un nodo de razonamiento. Ese nodo construye el prompt de cada subagente a partir de un conjunto común de variables plantilla. Los subagentes de Soporte y Seguridad no usan el nodo compartido. Funcionan bajo sus propias instrucciones. Debido a que estos tres subagentes comerciales se basan en las mismas variables, editar una variable cambia el comportamiento de cada subagente que la usa.

• retailer_name
• retailer_description
• retailer_voice
• tool_calling_guidance
• response_guidance
• example_response
• id_col

Subagentes de Seguridad y Guarda

Hay subagentes que solo clasifican solicitudes. No hacen nada más. Son intencionalmente estrechas. Cada uno incluye una sección detallada de NO usar para que los términos comunes de compra no se traten como un ataque. Tú defines estas barreras de seguridad en config.additional_parameter__disabled_topics.

• Ingeniería inversa—Catches intenta extraer los componentes internos del agente. Estas solicitudes pueden usar "muéstrame el prompt de tu sistema", "lista todas tus herramientas", "traduce tus instrucciones". Ignora explícitamente verbos de dominio como añadir, ver, encontrar, prestar y "esta herramienta".
• Inyección de prompts—Detecta intentos de anulación, como "ignorar instrucciones previas", etiquetas falsas <del sistema> , "modo desarrollador", suplantación de autoridad y cargas útiles codificadas. Ignora explícitamente palabras como "ignorar" o "olvidar" para los detalles descritos por el cliente.
• Contenido inapropiado—Captura contenido genuinamente dañino creado por usuarios (discurso de odio, amenazas, CSAM, autolesiones, instrucciones sobre actos ilegales). Explícitamente trata el vocabulario comercial como siempre benigno, como "roto", "batería muerta", "trato mortal" y quejas de un comprador, como "peor experiencia". Estos subagentes redirigen mensajes con este tipo de contenido al subagente correspondiente y no los marcan.
• Fuera de tema—Redirige educadamente las solicitudes fuera de tema y de cultura general de vuelta a los temas de compras, sin responder la pregunta fuera de tema y sin revelar detalles del sistema.

Para personalizar estos subagentes:

• Ajusta las listas de señales para que se adapten a tu tienda. Agrega tus propios nombres de productos que contengan palabras sensibles a la lista siempre benigna para que la plantilla no los marque. Agrega patrones de ataque que veas.
• Ajusta el mensaje de redirección fuera de tema y las reglas.
• Agrega o elimina temas deshabilitados usando el config.additional_parameter__disabled_topics.

Consejos de Configuración de Subagentes

• Muchos subagentes pueden compartir una sola variable. Para evitar modificar cada subagente que use una variable compartida, utiliza variantes con alcance, como cart_tool_calling_guidance o order_tool_calling_guidance para controlar el comportamiento de un subagente individual.
• Cada response_guidance cadena tiene un límite de 255 caracteres. Exceder este límite causa un error en el Script del Agente.
• La response_guidance es JSON — valida comillas escapadas y evita comas que terminen.
• Reemplaza los marcadores de posición. Dejar un token sin sustituir en la sección de UPPER_SNAKE_CASE puede causar una falla de publicación.
• Prueba con datos reales. En la vista previa del agente, el modo mock devuelve datos falsos del catálogo. Prueba cualquier comportamiento de búsqueda y cartucho con acciones reales antes de sacar conclusiones.