Agentes codificados en Studio Web (vista previa)

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, evaluación y observabilidad de UiPath. Studio Web actúa como 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 fuente : una vista de solo lectura de los archivos sincronizados. Tu IDE sigue siendo la fuente autorizada.
• 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 pueden gestionarse desde la página Gestionar agentes de UiPath .

Requisitos previos

• Tienes Python 3.11 o superior y pip o uv instalado.
• Se ha autenticado con UiPath Automation Cloud ejecutando uipath auth en el directorio de su proyecto.
• Has creado, inicializado y probado tu proyecto de agente codificado localmente. Sigue la guía de inicio rápido para tu marco:
  • SDK básico 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 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 a través de la vinculación de tu proyecto local de Python al agente.

Copiar la clave del proyecto

1. En la página Configurar tu agente codificado , copia la clave del proyecto 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 al agente en Studio Web.

Envía tu proyecto a Studio Web

1. Abre un terminal en el directorio de tu 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