{"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##### 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\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##### 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#### Texto\n\nPara agregar información, haz clic en **Nuevo texto** e ingresa el contenido deseado en el cuadro de texto.\n\nDespués de ingresar el texto haz clic en `Guardar cambios`.\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)."}