Error al ejecutar el proceso creado por el SDK de Python de UiPath

Hola, compañeros autómatas, tengo un problema interesante sobre el que no parece haber información. Tengo una automatización que actualmente utiliza una combinación de actividades tradicionales y actividades de Python para ejecutar un script que realiza la mayor parte del trabajo. Dado que tiene sentido que todo el proceso sea en Python, he estado investigando el uso del SDK de Python de UiPath para crear el proceso de manera que se pueda invocar a través de Orchestrator como un proceso normal.

Intentando seguir la (desactualizada e incompleta) documentación del SDK de Python de UiPath y profundizando en el código fuente, pude publicar un proceso muy simple que simplemente devuelve lo que se le ingresó con alguna concatenación de cadenas.

Puedo ejecutarlo localmente usando uipath run main <INPUT> y lo publiqué en Orchestrator, pero no puedo invocar el proceso desde Orchestrator. Lo desplegué tanto en mi carpeta de espacio de trabajo personal como en una carpeta compartida separada, y recibo el siguiente error al intentar ejecutarlo: Serverless.Api.CreditsExceeded - No hay suficientes Unidades Agénticas para ejecutar la automatización. Por favor, contacte a su administrador.

Esto, por supuesto, no tiene sentido ya que el proceso no es un agente codificado y no debería requerir unidades de agente. Curiosamente, cuando publiqué en la carpeta compartida e intenté ejecutarlo, obtuve un error diferente al intentar ejecutarlo: Cloud - Licencia de tiempo de ejecución sin servidor seleccionada. No hay tiempos de ejecución sin servidor de Cloud configurados en las plantillas de esta carpeta. (#2818) Este error en realidad tenía sentido, así que añadí la máquina [Default] Cloud Robots - Serverless a la carpeta, lo que cambió el error de vuelta al mencionado anteriormente Serverless.Api.CreditsExceeded - No hay suficientes Unidades Agénticas para ejecutar la automatización. Por favor, contacte a su administrador.

Buscando que alguien de UiPath opine sobre esto, ya que podría ser un error. Supongo que crear un proceso utilizando el SDK de Python es lo suficientemente especializado como para que nadie haya encontrado esto antes.

Estoy más confundido sobre si estoy usando el SDK de Python para su uso previsto. En el repositorio del SDK de Python hay ejemplos, como [pizza-order-function](uipath-python/packages/uipath/samples/pizza-order-function at main · UiPath/uipath-python · GitHub)

Noté que mientras el archivo UiPath.json tiene:

  "functions": {
    "main": "main.py:main"
  }
}

lo que, según mi comprensión de lo que significa función frente a agente, significa que debería ser un proceso normal que se puede invocar desde orquestador, etc. Pero el README.md dice explícitamente Un agente programado que fija y confirma pedidos de pizza...

Al mirar main.py, no hay nada que implique que el proceso sea un agente programado, no hay llamada de LLM, no hay indicaciones, nada. Simplemente acepta entradas y devuelve salidas determinísticas. ¿Estoy malinterpretando todo el punto y resulta que las funciones se suponen que son herramientas que los agentes programados llaman?

Para reiterar mi caso de uso, tengo un proceso que es híbrido en el sentido de que descargo un montón de cosas de una base de datos, luego invoco un script de Python que asume que las actividades anteriores descargaron archivos en ciertas ubicaciones en el directorio del proyecto y se vuelve desordenado. Todo podría hacerse en un solo script de Python, pero el problema es que hay mucha variabilidad y, si ocurriera un error o un problema, presentar eso fuera de las actividades de invocación de Python al orquestador es difícil, si no imposible. Así que crear el proceso usando el SDK de Python aliviaría completamente ese dolor, si tan solo pudiera invocarlo.

Cualquiera con información sería muy apreciado, especialmente si contribuyes o estás involucrado en el desarrollo del SDK de Python de UiPath :slight_smile:

Saludos,

Ewen

Hola @hivesew

Tuve EXACTAMENTE el mismo problema recientemente para una presentación ante un cliente, jaja.

Terminé teniendo que usar Unidades Agénticas para ejecutar mi agente codificado. Pero quería crear deliberadamente un agente codificado en UiPath utilizando el SDK.

Después de investigar, me di cuenta de que si alguna vez utilizas el SDK de Python de UiPath, asume inmediatamente que estás creando un agente codificado y lo despliega como tal. Así que probablemente esta sea la razón por la que estás recibiendo el error. Y no es un error, creo que literalmente espera que lo ejecutes como tal.

Si quieres evitar usar Unidades Agénticas por completo, te sugeriría intentar lo siguiente: (no lo he probado antes, así que veámoslo juntos)

En lugar de seguir la ruta de Proceso de UiPath → Invocar Python → dependencias de archivos desordenadas, expón una función Main() del código Python que maneje tu trabajo importante, y luego desplégalo normalmente, PERO intenta invocarlo utilizando una API de Orchestrator (que puedes encontrar en la interfaz de usuario Swagger de UiPath).

Podría resolver tu problema.

Dime cómo te va :slightly_smiling_face:

Me gustaría que UiPath confirmara esto, porque para mí no tiene mucho sentido. Todo lo que quiero es poder crear un proceso de Python codificado que pueda ser invocado desde Orchestrator para obtener los beneficios de registro/rastreo. No estoy seguro de por qué eso requeriría unidades de agente.

Mi proceso actual se invoca a través de un desencadenador de cola e implica usar un script de Python almacenado en el proyecto con una función principal que se invoca utilizando las actividades de Python, pero es un lío usarlo. Realmente sólo busco saber si el sdk de Python está destinado únicamente para uso de agente codificado o también para procesos codificados como el guía de inicio publicita.

Déjame etiquetar a @Alexandru_Bizon aquí, quien sabrá mejor cómo responder y corregirme si estoy equivocado.

Según mi comprensión, estamos trabajando en extender el SDK de Python y las dependencias de plataforma necesarias para cubrir tu caso de uso.

Hola @hivesew - gracias por el exhaustivo informe, y @JarrydScott por intervenir.

Una rápida aclaración para despejar la confusión: el UiPath Python SDK está en GA, pero específicamente para construir agentes codificados. Por eso, todo lo que publicas a través de él hoy se enruta como un agente, incluyendo tu “proceso de encadenamiento muy simple que devuelve una cadena”. Desde la perspectiva de la plataforma en este momento, cualquier cosa del SDK es un agente, que es la razón por la que te aparece Serverless.Api.CreditsExceeded - Unidades Agentes insuficientes. La interpretación de Jarryd sobre esto es correcta.

Lo que realmente quieres es UiPath Functions — un nuevo producto que estamos construyendo sobre la infraestructura existente del Python SDK. Functions extiende el mismo SDK, empaquetado y uipath CLI que ya estás utilizando, así que cuando se implemente tu trabajo se trasladará; el proyecto simplemente se tipa y enruta de manera diferente.

Qué serán UiPath Functions

Una forma de primera clase para publicar e invocar automatizaciones codificadas como procesos adecuados de Orchestrator: comenzando con Python, con JavaScript / TypeScript en la hoja de ruta. Functions se ejecuta en el tiempo de ejecución estándar del robot con su propio modelo de precios (que aún está siendo finalizado). Tu escenario exacto, un proceso híbrido donde la mayor parte de la lógica es Python y solo quieres una invocación limpia en Orchestrator, es uno de los casos de uso principales que impulsa el diseño.

Estado actual

  • Python SDK: GA, para agentes codificados.
  • UiPath Functions para Python (construido sobre el SDK): WIP, vista previa pública en las próximas semanas. Hasta entonces, cualquier cosa publicada a través del SDK se enruta a través del tiempo de ejecución de agentes y consume Unidades Agentes.
  • UiPath Functions para JS/TS: WIP - un SDK dedicado está en camino que desbloqueará algunos casos de uso genuinamente nuevos. Avance: estamos apuntando a tiempos de respuesta por debajo de 100ms.
  • La lectura errónea del README de pizza-order-function al etiquetarlo como un agente codificado es un error de documentación, el bloque "functions" de UiPath.json es la señal correcta. Lo corregiremos.

Mi recomendación

Para ser sincero contigo: hoy no hay una solución limpia. Esa es precisamente la brecha que UiPath Functions está diseñado para cerrar, llevando el código como un ciudadano de primera clase en la Plataforma UiPath.

El mejor camino es esperar la vista previa pública. Es la única que realmente entrega lo que buscas: código Python limpio, invocación nativa de Orchestrator, sin consumo de Unidades Agentes. Mantente en tu configuración híbrida actual un poco más, la migración debería ser sencilla ya que ya has hecho el trabajo de exploración del SDK.

Publicaré aquí tan pronto como llegue la vista previa pública. Agradezco tu paciencia mientras terminamos de preparar esto.

Alex Bizon

@hivesew @JarrydScott ¡tenemos funciones de Python disponibles ahora para todos en la comunidad!

:snake: Las funciones de Python ahora están en Vista Previa Pública - Noticias / Noticias del Producto - Foro de la Comunidad de UiPath

¡Aha! He estado esperando esto, ¡muchas gracias @Alexandru_Bizon! ¿Hay alguna forma para que las organizaciones empresariales obtengan acceso mientras aún está en vista previa pública? De lo contrario, no puedo esperar a que esto se active para empresas para poder convertir mi desordenado proceso RPA de escritorio en Studio que ejecuta Python a esto :slight_smile:

Planeo habilitarlo para todos en la empresa en una semana aproximadamente.