- Primeros pasos
- Agentes de UiPath en Studio Web
- Acerca de los agentes de UiPath
- Licencia
- Ejecución de agentes
- Agentes y flujos de trabajo
- Mejores prácticas para construir agentes.
- Elegir el mejor modelo para tu agente
- Mejores prácticas para publicar e implementar agentes
- Mejores prácticas para el diseño de contexto.
- Prácticas recomendadas para DeepRAG y Transformación por Lote: JIT frente a estrategias basadas en índice.
- Trabajar con archivos
- Contextos
- Escaladas
- Evaluaciones
- Seguimientos de agente
- Puntuación del agente
- Gestión de agentes de UiPath
- Agentes de UiPath codificados
- Crear con agentes de codificación
Publica e implementa un agente de conversación en Orchestrator para que esté disponible para los usuarios una vez que se completen el diseño y las pruebas.
Después de diseñar y probar tu agente conversacional, debes publicarlo e implementarlo para ponerlo a disposición de los usuarios. La publicación y la implementación son dos pasos independientes:
- Publicar: empaqueta tu agente como solución y lo carga en Orchestrator.
- Implementación: hace que la solución publicada esté disponible para la ejecución con los recursos de runtime necesarios.
Requisitos de la carpeta de Orchestrator
Antes de publicarlo, asegúrate de que tu carpeta de destino de Orchestrator tenga los recursos necesarios configurados.
| Recurso | Propósito | Obligatorio |
|---|---|---|
| Plantilla de máquina de robot sin servidor | Ejecuta el agente conversacional y las llamadas a herramientas específicas (automatizaciones RPA multiplataforma) | Siempre |
| Cuenta de Unattended Robot | Proporciona una identidad de ejecución cuando el agente se utiliza de forma anónima | Si se accede al agente a través de un canal utilizando acceso anónimo |
| MáquinaVirtual | Ejecuta automatizaciones de RPA basadas en Windows | Si utilizas automatizaciones de Windows |
| Conexiones compartidas | Proporciona acceso a los conectores de Integration Service cuando no hay disponible una conexión personal configurada por el usuario | Si las herramientas utilizan conectores |
Si tu agente no se inicia en Gestión de instancias, verifica que:
- Estás en el tenant correcto donde reside la solución de agente.
- Se asigna una plantilla de máquina de robot sin servidor a la carpeta de la solución.
- Si se utiliza un canal de acceso anónimo, se asigna una cuenta de Unattended Robot a la carpeta de la solución.
Identidad de ejecución
- Cuando se accede al agente conversacional a través de un canal de implementación que se autentica con la cuenta de UiPath del usuario, el agente conversacional se ejecuta bajo la identidad del usuario. Cuando el agente invoca herramientas que son procesos de Orchestrator, también se ejecutan bajo la identidad del usuario.
- Cuando se utiliza un canal de implementación con acceso anónimo, el agente de conversación se ejecuta en su lugar bajo la identidad de una cuenta de Unattended Robot dentro de la carpeta.
Publicar
Al publicar se empaqueta tu agente conversacional como solución y se carga en Orchestrator.
Pasos de publicación
- En Studio Web, abre tu agente conversacional.
- Selecciona Publicar en la barra de herramientas superior.
- Selecciona el destino de Orchestrator (recomendamos la fuente del tenant de Orchestrator).
- (opcional) Introduce una nota de registro de cambios que describa tu cambio.
- Selecciona Publicar.
Para ver opciones de publicación detalladas, consulta publicar un Proyecto.
Implementación
Después de publicar, debes realizar la implementación de la solución para que esté disponible para su ejecución. La implementación asocia la solución publicada con los recursos de runtime en tu carpeta de Orchestrator.
Pasos de implementación
- Ve a tu Orchestrator.
- Localiza la solución publicada.
- La implementación (o actualización) de la solución asegura que tenga acceso a las cuentas y conexiones de robot necesarias.
Una vez implementado, el agente aparece en Gestión de instancias y está disponible a través de los canales configurados.
Para ver opciones de implementación detalladas, consulta publicar un proyecto.
Gestión de conexión
El agente necesita acceso a las mismas conexiones utilizadas en tiempo de diseño. Los agentes conversacionales admiten dos tipos de conexiones: conexiones compartidas configuradas por administradores y conexiones personales configuradas por usuarios individuales.
Conexiones compartidas
Las conexiones compartidas las configuran los administradores en una carpeta de Orchestrator y están disponibles para todos los usuarios del agente. Para configurar conexiones compartidas:
- Crea conexiones de Integration Service en una carpeta compartida de Orchestrator.
- Usa estas conexiones compartidas durante el diseño y la depuración.
- Publica la solución como una subcarpeta dentro de la misma carpeta compartida.
Esta configuración garantiza que la solución herede automáticamente las conexiones de la carpeta principal.
Conexiones personales
Las conexiones personales permiten a los usuarios individuales seleccionar qué conexiones de Integration Service utiliza el agente en su nombre. Esto es útil cuando los usuarios necesitan que el agente actúe con sus propias credenciales, por ejemplo, enviando correos electrónicos desde su propia cuenta o accediendo a su calendario personal.
Habilitar conexiones personales
Para que las conexiones personales funcionen, se deben configurar dos ajustes en cada proceso de herramienta en Orchestrator. Para obtener información general sobre la configuración de ejecución, consulta Vincular la configuración de ejecución.
- En Orchestrator, navega a la carpeta donde se implementa la solución de agente y abre la pestaña Procesos .
- Selecciona Editar en el proceso de la herramienta que utiliza un conector (por ejemplo, un flujo de trabajo de API que envía correos electrónicos).
- En la configuración del proceso, establece la Cuenta en Heredar la identidad del trabajo principal. Esto permite que la herramienta se ejecute bajo la identidad del usuario, que es necesaria para que la herramienta acceda a las conexiones personales del usuario.
- Establece la conexión del conector en Configurable por los usuarios. Esto permite a los usuarios seleccionar sus propias conexiones para el conector en runtime.
Ambos ajustes son obligatorios. Sin ninguna de las dos configuraciones, las conexiones personales no son visibles para los usuarios y la herramienta puede devolver un error en tiempo de ejecución.
Experiencia del usuario
Cuando las conexiones personales están habilitadas para un agente:
- Los usuarios pueden abrir el panel Configuración del agente y seleccionar la pestaña Conexiones disponibles para ver y gestionar sus conexiones.
- Para cada conector necesario (por ejemplo, Slack, Outlook o Salesforce), los usuarios pueden seleccionar una de sus conexiones disponibles o crear una nueva.
- De forma predeterminada, el agente selecciona automáticamente una conexión coincidente del espacio de trabajo personal del usuario para el conector que utilizan el agente y otras herramientas de la carpeta.
El agente intenta configurar automáticamente las conexiones desde el espacio de trabajo personal del usuario. Si el usuario tiene una conexión coincidente para un conector en su espacio de trabajo personal, el agente lo utiliza automáticamente, lo que hace que la configuración sea fluida y normalmente una experiencia única. Si la conexión configurada automáticamente falla o no se encuentra ninguna conexión coincidente, se solicita al usuario que seleccione o cree una nueva.
Si un usuario no ha configurado una conexión personal para un conector, el agente recurre a la conexión predeterminada del agente. Las conexiones personales seleccionadas tienen prioridad sobre las conexiones compartidas y siempre se utilizan cuando están presentes. Cuando se utilizan aplicaciones externas, solo están disponibles las conexiones del espacio de trabajo personal del usuario; las conexiones de carpetas compartidas no se muestran.
Los usuarios pueden seleccionar y gestionar conexiones personales solo en canales que admitan la configuración del perfil de usuario (consulta Disponibilidad de características por canal). Una vez configuradas, las conexiones personales son utilizadas por el agente en todos los canales.
Para aprender a diseñar un agente para conexiones personales, consulta Consideraciones de conexión en la guía de diseño.
Canales de implementación
Después de publicarlo, los usuarios pueden acceder a tu agente conversacional a través de varios canales. Cada canal ofrece diferentes capacidades y es adecuado para diferentes casos de uso.
Descripción general del canal
| Canal | Mejor para | Autenticación de usuario |
|---|---|---|
| Gestión de instancias | Pruebas de administración, usuarios internos | Cuenta de UiPath |
| Autopilot for Everyone | Centro de productividad interno | Cuenta de UiPath |
| Microsoft Teams | Colaboración en equipo | Cuenta de Microsoft y cuenta de UiPath |
| Slack | Colaboración en equipo | Cuenta de Slack y cuenta de UiPath |
| Incrustación de iFrame | Apps de terceros y Apps de UiPath | Cuenta de UiPath o anónima |
| UiPath TypeScript SDK | Aplicaciones personalizadas | Determinado por tu aplicación |
Disponibilidad de características por canal
No todas las características de chat están disponibles en todos los canales. La gestión de instancias proporciona el conjunto de características completo; otros canales pueden tener limitaciones.
| Función | Gestión de instancias | Autopilot for Everyone | Microsoft Teams | Slack | Iframe | SDK de TypeScript* |
|---|---|---|---|---|---|---|
| Iniciar nuevo chat | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Historial de chat | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Eliminar sesión de chat | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Configuración del perfil de usuario | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Conexiones personales | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Iniciar solicitudes | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Cargas de archivos | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Entradas de conversación | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Confirmaciones de llamadas de herramientas | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Citas | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Vista previa de HTML | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Copiar respuesta | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Comentarios (pulgares) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
* Todas las características del SDK pueden ser configuradas por el desarrollador en su implementación personalizada.
Elegir un canal
Ten en cuenta estos factores al seleccionar los canales de implementación:
Usuarios internos con acceso a UiPath
- Usa la gestión de instancias para las pruebas de administrador y los usuarios avanzados.
- Usa Autopilot for Everyone como centro para todos los agentes.
Colaboración en equipo
- Usa Teams o Slack para llevar el agente a donde ya trabajan los equipos.
Aplicaciones personalizadas
- Usa la incrustación de iFrame para aplicaciones de terceros o apps de UiPath.
Usuarios externos o anónimos
- Usa la incrustación de iFrame con el servidor de autenticación anónimo.
Aplicaciones personalizadas
- Usa el UiPath TypeScript SDK para integrar agentes conversacionales a tus propias aplicaciones o portales web.
Comportamiento de la sesión de chat
Los agentes conversacionales mantienen sesiones persistentes:
- Cada conversación se ejecuta como un proceso de Orchestrator dedicado (activo durante hasta 8 horas de inactividad).
- Las sesiones permanecen activas para habilitar respuestas inmediatas.
- Las sesiones inactivas consumen recursos mínimos.
Usar herramientas de UiPath en plataformas externas
Puedes exponer las capacidades de UiPath (automatizaciones, flujos de trabajo, procesamiento de documentos) a plataformas de chat externas como ChatGPT y Microsoft Copilot Studio utilizando herramientas de MCP (Protocolo de contexto de modelo). Este enfoque utiliza llamadas de herramientas directas en lugar de agentes conversacionales.
Para ver más detalles sobre la integración de MCP, consulta Servidores MCP.
Próximos pasos
Selecciona un canal para obtener más información sobre la configuración:
- Requisitos de la carpeta de Orchestrator
- Identidad de ejecución
- Publicar
- Pasos de publicación
- Implementación
- Pasos de implementación
- Gestión de conexión
- Canales de implementación
- Descripción general del canal
- Disponibilidad de características por canal
- Elegir un canal
- Comportamiento de la sesión de chat
- Usar herramientas de UiPath en plataformas externas
- Próximos pasos