{"section":"tutorials","requestedLocale":"es","requestedSlug":"informacion-general-de-agent-builder","locale":"es","slug":"informacion-general-de-agent-builder","path":"docs/es/tutorials/vtex-cx-platform/agent-builder/informacion-general-de-agent-builder.md","branch":"main","content":"**Agent Builder** es una herramienta de conversación con el cliente basada en inteligencia artificial. Con esta funcionalidad, puedes personalizar agentes para interactuar con tus clientes y responder solicitudes relacionadas con pedidos en curso, el catálogo de tu tienda o la cancelación de pedidos.\n\nLa funcionalidad se centra en un agente orquestador (o manager), que es el punto de contacto con el cliente y gestiona el chat. Este agente orquestador activa agentes colaboradores que devuelven datos e información según las necesidades del usuario.\n\n> ℹ️ Para saber más sobre los agentes colaboradores, consulta el artículo [Agentes oficiales de VTEX CX Platform](https://help.vtex.com/es/docs/tutorials/agentes-oficiales-de-vtex-cx-platform).\n\nAdemás de asignar y probar estos agentes, también puedes crear agentes propios que atiendan necesidades específicas de tu empresa.\n\n> ⚠️ Para crear agentes personalizados, usa la CLI de VTEX CX Platform. Consulta la [documentación](https://developers.vtex.com/docs/guides/using-the-weni-by-vtex-cli) para crear tu propio agente.\n\n## Agent Builder\n\nPara acceder a **Agent Builder** selecciona la organización en la página de inicio de VTEX CX Platform y después el proyecto que deseas gestionar.\n\nEn **Agent Builder** están disponibles las siguientes páginas:\n\n- [**Mis agentes**](#mis-agentes)\n- [**Base de conocimiento**](#base-de-conocimiento)\n- [**Flujo de automatización**](#flujo-de-automatizacion)\n\n### Mis agentes\n\n> En esta página puedes asignar y probar agentes para tu tienda, además de editar el manager y las instrucciones que debe seguir.\n\nAprende más consultando el artículo [Asignar y probar un agente](https://help.vtex.com/es/docs/tutorials/asignar-y-probar-agentes).\n\n#### Editar manager\n\nLa opción **Editar manager** del agente orquestador tiene las siguientes pestañas:\n\n- [Perfil](#perfil)\n- [Motor](#motor)\n\n##### Perfil\n\nEn esta pestaña encontrarás campos configurables para definir la identidad y el comportamiento de tu agente orquestador.\n\nPara personalizar tu agente completa los siguientes campos:\n\n- **¿Qué nombre usa el agente para presentarse?:** nombre del agente que se mostrará a los clientes.\n- **¿Cuál es la función principal del agente?:** función principal del agente para que los usuarios entiendan su especialidad (por ejemplo: representante).\n- **¿Cuál es el objetivo principal del agente?:** objetivo principal del agente (por ejemplo: ayudar a resolver dudas).\n- **¿Cuál es el tono de voz del agente?:** tono de voz que el agente va a usar para comunicarse con los usuarios. Selecciona uno de los tonos de voz predefinidos.\n\nConsulta a continuación la descripción detallada de cada tono de voz:\n\n| Tono de voz del agente | Descripción |\n| --- | --- |\n| Amigable | Interactúa de forma cálida y acogedora, haciendo que el cliente se sienta cómodo y bienvenido, estableciendo una conexión con empatía y comprensión. |\n| Sistemático | Con un método claro y bien estructurado, sigue pasos definidos para resolver problemas. Usa un enfoque lógico y organizado, con consistencia y precisión en la comunicación y en el soporte al cliente. |\n| Analítico | Garantiza que toda la información se muestre de forma clara y accesible. Es lógico y objetivo, guiando al cliente por cada etapa de manera metódica, para que ningún detalle se pierda. |\n| Creativo | Utiliza la imaginación para comunicarse, priorizando soluciones originales. Ofrece respuestas únicas y adapta el lenguaje para hacer el contenido más relevante e impactante para el cliente. |\n| Informal | Es ligero, energético e informal. Mantiene un tono más accesible y humano. |\n\n##### Motor\n\nEn **Fuente del motor**, puedes seleccionar el modelo de agente nativo de VTEX CX Platform o un modelo de LLM para el que tengas una clave API registrada. Si deseas usar el modelo externo, selecciona la opción **Clave API propia** y completa los siguientes campos:\n\n- **Proveedor**: empresa propietaria del modelo.\n- **Modelo**: versión disponible del modelo.\n- **API key**: tu clave de API registrada en el proveedor del modelo.\n\n> ℹ️ Para activar cualquier modificación realizada en la información de las pestañas **Perfil** o **Motor**, debes hacer clic en `Guardar cambios`.\n\nSi seleccionaste el motor nativo de la plataforma, podrás elegir en **Versión del manager** entre dos opciones de agente orquestador:\n\n- **Manager 2.7** (recomendado).\n- **Manager 2.6** (modelo legado).\n\nEn **Vista previa de los agentes**, existen dos configuraciones posibles:\n\n- **Formato de mensaje múltiple:** actívalo <i class=\"fas fa-toggle-on\" aria-hidden=\"true\"></i> si deseas que el agente envíe varios mensajes, como respuestas rápidas, listas, catálogo. De lo contrario, deja el botón de alternancia desactivado <i class=\"fas fa-toggle-off\" aria-hidden=\"true\"></i>.\n\n- **Feedback progresivo de los agentes:** actívalo <i class=\"fas fa-toggle-on\" aria-hidden=\"true\"></i> si quieres que el agente envíe actualizaciones en tiempo real al usuario mientras redacta la respuesta final. De lo contrario, deja el botón de alternancia desactivado <i class=\"fas fa-toggle-off\" aria-hidden=\"true\"></i>.\n\nEn **Mensajes del sistema** puedes personalizar el mensaje de error enviado al cliente cuando un error de API impide al agente generar una respuesta. Cada proyecto puede tener su propio mensaje, adaptado al tono de voz de la marca.\n\n> ⚠️ El mensaje de error se envía exactamente como se configuró y no se traduce automáticamente. Ingresa el texto en el idioma en que tu agente atiende a los clientes.\n\nPara guardar tus ajustes haz clic en `Guardar cambios`.\n\n#### Editar instrucciones\n\nAl hacer clic en el botón `Editar instrucciones` del agente orquestador, accedes a la página **Instrucciones**, donde puedes agregar instrucciones directas para determinar cómo se comporta tu agente. No hay un límite para la cantidad de instrucciones que se pueden crear.\n\n##### Validación por IA\n\nAl crear instrucciones personalizadas puedes solicitar la validación de la IA, que analizará cada una de ellas e indicará posibles problemas o puntos de mejora. Además, también puedes solicitar una sugerencia automática, que revisará la instrucción y la editará según sea necesario.\n\nPara usar la validación de instrucciones con IA al crear una instrucción sigue estos pasos:\n\n1. Activa el botón <i class=\"fas fa-toggle-on\" aria-hidden=\"true\"></i> **Validar instrucción por IA**.\n2. Escribe tu instrucción en **Nueva instrucción personalizada** y haz clic en `Validar instrucción`.\n3. Después del análisis de la instrucción, si el resultado es **No se encontraron problemas. ¡Listo para publicar!**, haz clic en `Publicar`.\n\n> ⚠️ Si aparece un mensaje de advertencia en **Resultados de la validación**, corrige la instrucción según las indicaciones mostradas y haz clic en `Revalidar`.\n\n> ℹ️ Puedes crear una nueva instrucción personalizada sin la validación de la IA. Para hacerlo, desactiva la opción **Validar instrucción por IA**, escribe la instrucción y haz clic en `Publicar instrucción`.\n\n##### Componentes interactivos\n\nCon **Manager 2.7**, el agente orquestador puede responder usando componentes interactivos nativos de WhatsApp:\n\n| Componente | Descripción |\n| --- | --- |\n| Respuestas rápidas (`quick_reply`) | Botones con opciones predefinidas para que el cliente elija. |\n| Botones de acción (`call_to_action`) | Botones que dirigen al cliente a un enlace externo. |\n| Mensaje con lista (`list_message`) | Menú con una lista de opciones seleccionables. |\n\nPara orientar al agente a usar un componente, menciónalo directamente en una instrucción personalizada. Por ejemplo: \"Al preguntar sobre el status del pedido, usa el componente `quick_reply` con las opciones Rastrear pedido, Cancelar pedido y Hablar con un representante\".\n\n> ℹ️ Para que el agente envíe componentes interactivos, la opción **Formato de mensaje múltiple** debe estar activada en **Editar Manager > Motor**.\n\n> ⚠️ El catálogo de productos no es un componente nativo de Manager 2.7. Cuando hay un agente Concierge asignado al equipo, el orquestador activa al Concierge para enviar el catálogo. Los agentes Concierge oficiales de VTEX ya tienen esta capacidad.\n\n##### Lista de instrucciones\n\nEn la **Lista de instrucciones**, puedes verificar la siguiente información:\n\n- **Instrucciones personalizadas:** instrucciones creadas para el agente. Puedes encontrarlas usando la barra de búsqueda o copiarlas haciendo clic en el botón `Copiar instrucciones`.\n\n- **Instrucciones predeterminadas:** comportamientos definidos por la plataforma. Estas instrucciones no se pueden editar.\n\n- **Temas de seguridad:** asuntos que el agente no menciona durante un chat de soporte. Estos temas no se pueden editar.\n\nPara editar o eliminar una instrucción personalizada sigue los pasos a continuación:\n\n1. Haz clic en el botón de tres puntos <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i> junto a la instrucción deseada.\n2. Para editarla, haz clic en `Editar instrucción`, realiza los ajustes necesarios y haz clic en `Guardar`.\n3. Para eliminarla, haz clic en `Eliminar instrucción` y luego en `Eliminar`.\n\n### Base de conocimiento\n\nEn esta página puedes agregar [archivos](#archivos), [sitios web](#sitios-web) y [textos](#textos) a la base de conocimiento de tu agente. Los agentes utilizarán los datos de estos documentos para responder a los usuarios.\n\n#### Archivos\n\nPara agregar un archivo a la base de datos haz clic en <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`Agregar archivo`.\n\n> ⚠️ Los archivos deben tener extensión `.pdf`, `.doc`, `.docx`, `.txt`, `.xls` o `.xlsx` y un tamaño de hasta 50 MB.\n\nHaciendo clic en los <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i>tres puntos junto al nombre del archivo, puedes:\n\n- Descargar el archivo.\n- Remover el archivo de la base de conocimiento.\n\nTambién puedes usar el campo de búsqueda para encontrar un archivo en la base de conocimiento.\n\n#### Sitios web\n\nPara agregar un sitio web a la base de datos del agente sigue los pasos a continuación:\n\n1. Haz clic en <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`Agregar sitio web`.\n2. Luego, copia la URL del sitio web que deseas agregar y pégala en el campo vacío.\n3. Haz clic en `Finalizar`.\n\nHaciendo clic en los <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i>tres puntos junto al sitio web, puedes:\n\n- Acceder al sitio web.\n- Remover el sitio web de la base de conocimiento.\n\nTambién puedes usar el campo de búsqueda para encontrar un sitio web en la base de conocimiento.\n\n#### Textos\n\nEn esta pestaña puedes agregar contenido a la base de conocimiento, organizado en bloques de texto, cada uno con su propio título. La lista se ordena de la edición más reciente a la más antigua e indica cuándo se modificó cada texto.\n\nPara crear un texto, sigue los pasos a continuación:\n\n1. Haz clic en <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`Nuevo texto`.\n2. Ingresa un título para identificar el texto.\n3. Ingresa el contenido en la caja de texto.\n4. Haz clic en `Guardar`.\n\nHaciendo clic en los tres puntos verticales <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i> junto al texto, puedes:\n\n- Editar el contenido.\n- Cambiar el nombre del título.\n- Eliminar el bloque. La eliminación requiere confirmación.\n\nTambién puedes usar el campo de búsqueda para encontrar un texto por el título.\n\n> ℹ️ Las bases de conocimiento creadas antes de organizar el contenido de esta forma mantienen el texto original como un único texto, con un título predeterminado. No se pierde ningún contenido. Dividir el contenido en varios textos es solo un cambio de interfaz y no afecta la forma en que el agente usa el contenido de la base de conocimiento.\n\n### Flujo de automatización\n\nPuedes crear flujos de automatización para interactuar con un grupo de usuarios y determinar las respuestas del agente con base en los mensajes de los usuarios.\n\nPara más información, accede a [Introducción a los flujos](https://help.vtex.com/es/docs/tutorials/introduccion-a-los-flujos)."}