Agentes codificados en Studio Web

Nota:

Los agentes codificados en Studio Web están en vista previa.

Los agentes codificados te permiten definir el comportamiento del agente directamente en Python mientras te beneficias de la orquestación, la evaluación y la observabilidad de UiPath. Studio Web actúa como el plano de control, mientras que tu entorno de desarrollo integrado (IDE) sigue siendo el entorno de desarrollo principal.

Después de conectar tu proyecto local, Studio Web proporciona acceso a:

• Definición: una vista de alto nivel de los puntos de entrada y la configuración del agente.
• Código de origen: una vista de solo lectura de los archivos sincronizados. Tu IDE sigue siendo el origen principal.
• Conjuntos de evaluación: casos de prueba para validar el comportamiento del agente.
• Evaluadores: evaluadores basados en la salida y la trayectoria utilizados durante las ejecuciones de evaluación.

Desde Studio Web puedes ejecutar Depurar o Depurar paso a paso, ejecutar evaluaciones en el espacio Evaluaciones y publicar el agente para su uso en producción. Los agentes publicados emiten seguimientos visibles en el espacio Seguimientos de agente y se pueden gestionar desde la página Administrar agentes de UiPath.

Requisitos previos

• Tienes Python 3.11 o posterior y tienes instalado pip o uv.
• Has creado, inicializado y probado tu proyecto de agente codificado localmente. Sigue la guía de inicio rápido para tu marco:
  • SDK principal de Python
  • LangChain (LangGraph)
  • LLamaIndex
  • Agentes de OpenAI
• Tienes acceso a Studio Web con una solución abierta o lista para crear.

Crear un agente codificado en Studio Web

1. Ve a studio.uipath.com.
2. Selecciona Crear nuevo y luego selecciona Agente.
3. Selecciona Codificado como el tipo de agente.

Resultado: Studio Web crea un shell de agente codificado y abre la página Configurar tu agente codificado.

Conecta tu proyecto local a Studio Web

En la página Configurar tu agente codificado, Studio Web te guía en el proceso de vincular tu proyecto de Python local al agente.

Copia la clave del proyecto

1. En la página Configurar tu agente codificado, copia la clave del proyecto del agente. Studio Web genera esta clave automáticamente para cada proyecto de solución.

2. En tu proyecto local, abre el archivo .env.

3. Añade la siguiente línea, reemplazando <project-id-from-studio> por la clave que copiaste:

   UIPATH_PROJECT_ID=<project-id-from-studio>
   

Esta clave vincula tu proyecto local con el agente en Studio Web.

Envía tu proyecto a Studio Web

1. Abre un terminal en tu directorio de proyecto local.

2. Ejecuta el siguiente comando:

   uipath push
   

Resultado: Studio Web sincroniza los siguientes archivos de tu proyecto local y carga automáticamente el contenido del agente codificado:

• Archivos de origen (por ejemplo, graph.py, entry-points.json)
• Archivos de configuración (pyproject.toml, uipath.json)
• Activos de evaluación (evaluadores, conjuntos de evaluación)
• Metadatos y vinculaciones