{"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, permitiéndoles solicitar información sobre un pedido en curso, el catálogo de tu tienda y la cancelación de un pedido, por ejemplo.\n\nLa funcionalidad se centra en un agente orquestador (o manager), que es el punto de contacto con el cliente y asume el control del chat. Este 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, lee 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 se adapten a las necesidades específicas de tu empresa.\n\n> ⚠️ Para crear agentes personalizados, utiliza el 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, a continuación, el proyecto que deseas gestionar.\n\nEn **Agent Builder**, las siguientes páginas están disponibles:\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\nPara entender cómo asignar agentes, lee 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 personalizables para personalizar 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 comprendan su especialidad (por ejemplo: asistente de atención al cliente).\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 utilizará para comunicarse con los usuarios. Selecciona uno de los tonos de voz predefinidos.\n\nLee 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. Utiliza un enfoque lógico y ordenado, con consistencia y precisión en la comunicación y en el soporte al cliente. |\n| Analítico | Garantiza que toda la información esté dispuesta de forma clara y accesible. Es lógico y objetivo, guiando al cliente por cada etapa de manera metodológica para que ningún detalle se pierda. |\n| Creativo | Utiliza la imaginación para comunicarse, priorizando soluciones originales. Es capaz de ofrecer respuestas diferenciadas y adaptar el lenguaje para hacer el contenido más relevante y atractivo 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 en el que tengas una Clave API registrada. Si deseas utilizar el modelo externo, selecciona la opción **Clave de API propia** y completa los campos a continuación:\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**, es necesario 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, déjalo desactivado <i class=\"fas fa-toggle-off\" aria-hidden=\"true\"></i>.\n\n- **Feedback progresivo de los agentes (Solo disponible para el Shopping Assistant):** actívalo <i class=\"fas fa-toggle-on\" aria-hidden=\"true\"></i> si deseas que el agente envíe actualizaciones en tiempo real al usuario mientras redacta la respuesta final. De lo contrario, déjalo 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 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 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 utilizar la validación de instrucción por IA al crear una instrucción, sigue los pasos a continuación:\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 orientaciones mostradas y haz clic en `Re-validar`.\n\n> ℹ️ Es posible crear una nueva instrucción personalizada sin la validación de la IA. Para realizar esta acción, 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. Es posible localizarlas utilizando 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 no mencionados por el agente durante una atención. 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, a continuación, 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\nAl hacer clic en los <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i> tres puntos junto al nombre del archivo, es posible:\n\n- Descargar el archivo.\n- Eliminar 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 insertar un sitio en la base de datos del agente, sigue estos pasos:\n\n1. Haz clic en <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`Agregar sitio web`.\n2. A continuación, copia la URL del sitio que deseas agregar y pégala en el campo vacío.\n3. Haz clic en `Finalizar`.\n\nAl hacer clic en los <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i> tres puntos junto al sitio, es posible:\n\n- Acceder al sitio.\n- Eliminar el sitio de la base de conocimiento.\n\nTambién puedes usar el campo de búsqueda para encontrar un sitio en la base de conocimiento.\n\n#### Textos\n\nEn esta página, puedes insertar contenidos e información en la caja de texto **Escribir contenido**.\n\nDespués de insertar un 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 según 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)."}