- Primeros pasos
- Agentes de UiPath en Studio Web
- Agentes de UiPath en Agent Builder
- Agentes de UiPath codificados
- Acerca de los agentes codificados
- Licencia para agentes codificados
- Construcción e implementación de agentes codificados
- Resolución de problemas de agentes codificados
Guía del usuario de agentes
Acerca de los agentes codificados
Los agentes codificados para UiPath® son agentes creados a través del desarrollo directo de código dentro del entorno de desarrollo integrado (IDE) preferido del desarrollador. Proporcionan a los desarrolladores un control completo sobre la lógica del agente, el comportamiento y la integración con sistemas externos.
.nupkg estándar, en una fuente de paquetes de tu elección. A continuación, se puede utilizar para crear procesos dentro de una o más carpetas.
El agente codificado se implementa como un proceso de UiPath dentro de las carpetas de Orchestrator. Una vez integrado en la plataforma, se adhiere a los mismos principios de gobernanza que los procesos estándar. Esto permite una implementación organizada dentro de las carpetas y significa que puedes programar, desencadenar y supervisar la ejecución del agente, al tiempo que lo integras en flujos de trabajo de automatización más amplios.
La siguiente ilustración describe el proceso de creación, implementación y ejecución de un agente codificado dentro de UiPath Platform.
La biblioteca del SDK de UiPath y sus lenguajes y marcos compatibles se amplían continuamente. Actualmente admitimos:
| Idioma | Repositorio | Funcionalidad |
|---|---|---|
| Python | uipath-python |
SDK de Python que cuenta con una CLI para la creación, el empaquetado y la implementación de agentes en UiPath Platform. También habilita la interacción programática con recursos de UiPath Platform como procesos, recursos, depósitos, contextualización, servicios de datos, trabajos y más. |
| Python con LangGraph | extensión de uipath-python: |
SDK de Python que permite a los desarrolladores crear e implementar agentes de LangGraph en UiPath Platform. Este paquete ofrece interacción programática con los servicios de UiPath PlatformTM y participación humana a través de Action Center. |
Para obtener la información más reciente sobre las actualizaciones del SDK de UiPath, consulta la Política de versiones.
Integración de recursos de UiPath a través de SDK
Los SDK de UiPath proporcionan a los desarrolladores la lógica necesaria para invocar e interactuar con otros recursos de UiPath directamente en su código, lo que permite una integración perfecta con las funcionalidades existentes de UiPath. Por ejemplo, los desarrolladores pueden utilizar los activos de UiPath para el almacenamiento y la gestión seguros de datos confidenciales, acceder y manipular los datos almacenados en los depósitos de almacenamiento de UiPath, y establecer y gestionar conexiones a varios sistemas y servicios. Además, los desarrolladores pueden desencadenar e interactuar con otros procesos de UiPath desde el agente codificado.
Para obtener más información sobre los recursos de UiPath que puedes utilizar en tu agente codificado, consulta la documentación del SDK.
Para obtener más ejemplos y patrones de implementación, consulta los proyectos de ejemplo en nuestro repositorio de GitHub.
Intervención humana para agentes codificados
Puedes definir puntos de interrupción dentro de tu agente para solicitar entrada humana. Cuando se activa una interrupción, la ejecución del agente se detiene y se pide intervención al usuario asignado. Tras la intervención, se reanudará la ejecución.
La forma en que se definen los puntos de interrupción varía en función del lenguaje del agente:
- Algunos marcos, como LangGraph, ofrecen patrones de interrupción nativos, que permiten la intervención humana en la ejecución del agente.
- Con los SDK de UiPath, puedes introducir una tarea de UiPath como la lógica de interrupción. Cuando se activa una interrupción, la ejecución se detiene y se crea una tarea en Action Center.
- Los usuarios pueden revisar el progreso del agente, proporcionar comentarios o tomar decisiones y actuar sobre la tarea generada a través de una aplicación de acción.
- Una vez completada la interacción humana, el agente reanudará su ejecución desde el punto de interrupción.
Configurar variables de entorno para agentes codificados
Puedes configurar tu proyecto con variables de entorno utilizando activos secretos, eliminando la necesidad de modificaciones directas del código.
Aprovechando el soporte de Orchestrator para integrarse con almacenes de credenciales externos como CyberArk para activos de credenciales, puedes vincularlo a tu almacén CyberArk y configurar una variable de entorno para que tu agente utilice ese activo secreto. En runtime, Orchestrator recupera de forma segura la clave de CyberArk a través del activo y la pone a disposición de tu agente como una variable de entorno.
Navega hasta el proceso de tu agente en Orchestrator para definir y gestionar las claves API, los parámetros de runtime y otros valores de configuración requeridos por el código de tu agente. Para obtener más información, consulta Iniciar un trabajo de agente.
Habilitar el seguimiento y la depuración con LangSmith
LANGCHAIN_TRACING_V2, LANGCHAIN_API_KEY, LANGCHAIN_PROJECT) para habilitar el seguimiento detallado de la ejecución de tu agente dentro de LangSmith.
Esta integración proporciona seguimientos completos en tu cuenta de LangSmith para cada ejecución del agente de UiPath. Esto te permite analizar el razonamiento del agente, la ruta de ejecución y las áreas de depuración y optimización del rendimiento.
