agente de código UIP

uip codedagent un puente delgado al flujo de trabajo de agentes codificados de UiPath basado en Python. Detecta un intérprete de Python adecuado, confirma que el paquete de Python uipath está instalado y luego reenvía todos los subcomandos a la CLI de Python, por lo que los verbos nuevo, dev, pack, Publish y otros verbos de ciclo de vida provienen del paquete de Python en lugar de esta herramienta .

Consulta Herramientas (complementos) para ver en qué se diferencian los envoltorios delgados de las herramientas completas.

Sinopsis

uip codedagent setup [--force]
uip codedagent <any-command> [args...]

Tanto el comando de configuración como cualquier comando reenviado respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

configuración de agente de código uip

Detecta Python y verifica que el paquete uipath esté instalado. Los resultados se almacenan en caché en un archivo por usuario para que los comandos codedagent posteriores puedan resolver el binario de Python al instante.

Argumentos

Nada.

Opciones

• --force — Vuelve a ejecutar la detección incluso si hay un resultado almacenado en caché.

Ejemplos

uip codedagent setup
uip codedagent setup --force

Data shape (--output json)

{
  "Code": "CodedAgentsSetup",
  "Data": {
    "PythonPath": "/usr/bin/python3.11",
    "Package": "uipath",
    "PackageInstalled": "Yes",
    "PackageVersion": "1.0.0"
  }
}

Environment checks

• Las versiones de Python permitidas se configuran a través de la variable de entorno PYTHON_TOOL_PYTHON_VERSIONS Una lista vacía genera Failure en el momento de la configuración.
• Si existe un directorio .venv en el directorio de trabajo actual, pero no hay ningún entorno virtual activado, la configuración se niega a ejecutarse y sugiere activarlo primero (.venv\Scripts\activate en Windows, source .venv/bin/activate en otros lugares).

Comandos reenviados

Cualquier subcomando distinto de setup, exec o help se reenvía de forma transparente a la CLI de Python uipath como codedagent exec <subcommand> .... Esto significa que la propia superficie de comandos del paquete Python ( new, dev, run, pack, publish y cualquier otra cosa que se envíe) es accesible a través de uip codedagent.

Ejemplos

# Hand off to the Python CLI's new command
uip codedagent new my-agent

# Run the Python CLI's help for a sub-verb
uip codedagent init --help

# Execute a dev loop defined by the Python package
uip codedagent dev

Nota:

Debido a que estos comandos están definidos por el paquete Python uipath , sus marcadores y forma de salida son lo que emite ese paquete, no el sobre Code/Data estándar de CLI. Trata el CLI aquí como un transporte. Para la superficie del argumento, ejecuta uip codedagent help o uip codedagent <command> --help, ambos se reenvían a Python.

Retransmisión de autenticación: antes de reenviar, la CLI lee la sesión creada por uip login e inyecta estas variables de entorno en el subproceso de Python para que el SDK las recoja automáticamente:

• UIPATH_ACCESS_TOKEN
• UIPATH_URL (compuesto como <baseUrl>/<org>/<tenant>)
• UIPATH_ORGANIZATION_ID, UIPATH_ORGANIZATION_NAME
• UIPATH_TENANT_ID, UIPATH_TENANT_NAME

Si no has iniciado sesión, el reenvío sigue funcionando; la CLI de Python se ejecuta sin esas variables.

Marcadores bloqueados: el reenviador se niega a pasar --force a través de algunos subcomandos destructivos de Python (la lista exacta la aplica la capa de configuración de la herramienta) y emite ValidationError cuando ve uno. Utilice la alternativa no--force que sugiere el mensaje de error.

Códigos de salida

Se aplican los códigos de salida estándar. El código de salida del subproceso reenviado se transmite directamente al shell principal, por lo que un fallo del lado de Python sale de uip codedagent con el mismo estado distinto de cero.

Relacionado

• Herramientas (complementos) : modelo de herramienta de envoltura fina.
• uip login : crea la sesión que se retransmite al tiempo de ejecución de Python.
• uip tools — instala, actualiza y desinstala el propio paquete codedagent-tool .