{"section":"tutorials","requestedLocale":"es","requestedSlug":"asignar-y-probar-agentes","locale":"es","slug":"asignar-y-probar-agentes","path":"docs/es/tutorials/vtex-cx-platform/agent-builder/asignar-y-probar-agentes.md","branch":"main","content":"La sección **Mis agentes** permite asignar agentes al equipo y probar su funcionamiento. Algunos agentes oficiales requieren credenciales para operar en la plataforma. Para más información, accede a [Agentes oficiales de VTEX CX Platform](https://help.vtex.com/es/docs/tutorials/agentes-oficiales-de-vtex-cx-platform).\n\n> ℹ️ Para crear agentes personalizados, utiliza la CLI de VTEX CX Platform (Weni). Para más información, consulta [Using the VTEX CX Platform (Weni) CLI](https://developers.vtex.com/docs/guides/using-the-weni-by-vtex-cli#getting-started-with-your-project).\n\nEste artículo se divide en las siguientes secciones:\n\n- [Asignar agente al equipo](#asignar-agente-al-equipo)\n- [Eliminar agente](#eliminar-agente)\n- [Probar agente](#probar-agente)\n- [Configurar constantes de agentes personalizados](#configurar-constantes-de-agentes-personalizados)\n\n## Asignar agente al equipo\n\nPara asignar un nuevo agente a tu tienda sigue los pasos a continuación:\n\n1. Accede a tu organización en el [dashboard de VTEX CX Platform](https://dash.weni.ai/orgs).\n2. En el menú lateral, haz clic en el ícono **Mis agentes**.\n3. Haz clic en <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`Asignar nuevos agentes`.\n4. En la página **Asignar nuevos agentes**, selecciona una de las opciones disponibles:\n- **Agentes oficiales:** agentes de VTEX o de integraciones externas previamente registradas en la plataforma.\n- **Agentes personalizados:** agentes creados para tu operación.\n\n> ℹ️ También puedes encontrar agentes utilizando el campo de búsqueda o filtrando por tipo de categoría.\n\n5. Después de elegir un agente, haz clic en `Ver detalles`.\n6. En el modal del agente revisa la información sobre los MCPs disponibles y el ejemplo de conversación.\n7. Haz clic en `Iniciar configuración`.\n8. En **Asignar \\{Nombre del agente\\}**, en la sección **Selección de sistema**, elige una de las opciones disponibles y haz clic en `Siguiente`.\n9. En **Selección de MCP**, selecciona una de las opciones disponibles para definir el comportamiento del agente.\n10. En **Configurar MCP \\{Nombre del sistema\\}**, si está disponible, completa o selecciona los parámetros del agente. Algunos agentes no tienen parámetros configurables.\n11. Para agentes personalizados, en **Constantes**, selecciona las constantes definidas mediante la CLI e ingresa los valores deseados. Más información en [Configurar constantes de agentes personalizados](#configurar-constantes-de-agentes-personalizados).\n12. En **Revisa la configuración e ingresa las credenciales**, revisa la información, llena los campos solicitados y haz clic en `Finalizar`.\n\n> ℹ️ Las tarjetas de agentes personalizados muestran la fecha y hora de creación o de la última actualización del agente. Los agentes oficiales no muestran esta información.\nDespués de completar estos pasos, el agente se mostrará en la sección **Agentes asignados** de la página **Mis agentes**.\n\n## Configurar constantes de agentes personalizados\n\nLas constantes son valores de configuración reutilizables, definidos a nivel del agente y compartidos entre todas sus herramientas, como URLs de entorno o identificadores de tienda. Se crean en el código del agente y se envían a la plataforma mediante la [CLI de VTEX CX Platform](https://weni-ai.github.io/weni-cli/core-concepts/constants/).\n\nAl asignar un agente personalizado puedes ver las constantes disponibles, definir el valor de cada una y aplicarlas directamente en la interfaz, sin necesidad de la CLI.\n\n> ℹ️ Las constantes no son lo mismo que las credenciales. Las credenciales son información confidencial, como claves de API, que el agente utiliza al ejecutar una herramienta específica. Las constantes son valores de configuración compartidos entre las herramientas del agente.\n\n## Eliminar agente\n\nPara remover un agente de tu tienda sigue los pasos a continuación:\n\n1. Accede a tu organización en el [dashboard de VTEX CX Platform](https://dash.weni.ai/orgs).\n2. En el menú lateral, haz clic en el ícono **Mis agentes**.\n3. En la sección **Agentes asignados**, haz clic sobre el agente deseado.\n4. Haz clic en `Ver opciones`.\n5. Haz clic en `Eliminar agente`.\n\n> ℹ️ Si deseas volver a utilizar este agente realiza la nueva asignación según se describe en [Asignar agente al equipo](#asignar-agente-al-equipo).\n\n## Probar agente\n\nPara probar el funcionamiento de un agente asignado, haz clic en `Prueba tus agentes`, en la esquina inferior derecha de la pantalla.\n\nEn la sección **Prueba tus agentes**, puedes:\n\n- Seleccionar, en el campo **Versión del Manager**, el modelo que actuará como agente orquestador durante la conversación.\n- Iniciar una conversación usando el cuadro de diálogo.\n- Enviar un mensaje de audio haciendo clic en el ícono de micrófono o en el botón <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> y, a continuación, en `Audio`.\n- Enviar archivos haciendo clic en el botón <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> y, a continuación, en `Enviar archivo`.\n- En la pestaña **Flujo visual**, visualizar en formato de diagrama los agentes que se están activando para producir la respuesta mostrada en el cuadro de diálogo.\n- En la pestaña **Logs**, verificar el registro detallado de los eventos procesados por el modelo de IA durante la conversación. Esta información ayuda a entender el procesamiento de la conversación, identificar posibles problemas y mejorar el desempeño del agente.\n\nPara buscar eventos específicos, haz clic en `Filtrar logs` y busca por palabras clave o por las siguientes categorías:\n\n| Categoría | Descripción de la etapa |\n| --- | --- |\n| Aplicando reglas de seguridad | Verificación de seguridad del contenido, incluyendo protección de datos sensibles, bloqueo de contenidos prohibidos y aplicación de políticas de uso. |\n| Asignando tarea al agente | Definición del agente especializado o recurso interno que será responsable de una etapa de la conversación. |\n| Conocimientos | Consulta la base de conocimientos, como documentación, artículos del Help Center o contenidos internos, para buscar información oficial antes de la respuesta. |\n| Enviando al manager | Transferencia al manager para definir la siguiente etapa de la conversación. |\n| Enviando a soporte humano | Transferencia de la conversación a soporte humano debido a una limitación técnica, excepción o regla de negocio. |\n| Enviando al manager | Envío del resultado de una herramienta, agente o etapa del flujo al manager para procesamiento. |\n| Enviando respuesta final | Envío de la respuesta al usuario después de la conclusión de la orquestación interna. |\n| Herramienta | Uso de un recurso externo o módulo específico, como consulta de pedidos, análisis de imagen, transcripción de audio o búsqueda en otro sistema. |\n| Pensando | Etapa en la que el modelo procesa internamente la solicitud, planea la respuesta y decide si debe accionar herramientas, consultar conocimiento o transferir la conversación a otro flujo. |\n\n> ℹ️ Para eliminar el historial de las conversaciones con el agente orquestador, haz clic en el menú <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i> al lado de **Prueba tus agentes** y, a continuación, en `Limpiar conversaciones`."}