Contextualización de UIP

Sintaxis y opciones para `contexto-conexión a tierra de uip`, un puente a la UiPath CLI de Python para operaciones de conexión a tierra de contexto.

uip context-grounding es un puente delgado a las operaciones de contextualización del SDK de UiPath basado en Python. Detecta un intérprete de Python adecuado, confirma que el paquete uipath de Python está instalado y reenvía todo lo demás a la CLI de Python como uipath context-grounding <args>: esta herramienta no define subcomandos nativos propios más allá de setup.

A diferencia de uip codedagent, que solo reenvía una lista blanca fija de nombres de subcomandos, context-grounding-tool reenvía cualquier comando no reconocido: no hay lista de permisos que consultar antes de que un nuevo verbo del lado de Python funcione aquí.

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

Sinopsis

uip context-grounding setup [--force]
uip context-grounding <any-command> [args...]
uip context-grounding help
uip context-grounding

setup y 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 contextualización de 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 context-grounding 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 context-grounding setup
uip context-grounding setup --force

Forma de datos (--output json)

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

Comprobaciones del entorno

• 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 que no sea setup o help se reenvía a la CLI de Python uipath como uipath context-grounding <args> — no hay una lista blanca fija para comprobar; un nuevo verbo que el paquete Python añade mañana funciona aquí hoy, con una excepción:

Nota:

auth está bloqueado. La llamada uip context-grounding auth ... falla inmediatamente con Result: ValidationError (código de salida 3) y el mensaje "Usar 'uip login' para la autenticación". — a menos que pases --force, que omite este filtro y permite que la llamada auth pase a Python. Esto es lo contrario del efecto de --force en uip codedagent, donde --force siempre se elimina silenciosamente y nunca llega a Python: aquí es una escotilla de escape real, aunque estrecha.

Ejemplos

# Hand off to the Python CLI's index command
uip context-grounding index ./my-index

# Search a context grounding index
uip context-grounding search "invoice total" --index my-index

# Blocked without --force
uip context-grounding auth login
# Result: ValidationError — "Use 'uip login' for authentication."

# Bypasses the auth filter
uip context-grounding auth login --force

Nota:

Debido a que los comandos reenviados 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 de argumentos, ejecuta uip context-grounding <command> --help.

Retransmisión de formato de salida: cuando el global --output es json, la CLI añade automáticamente --format json al comando reenviado (se omite para las llamadas --help o cuando los argumentos reenviados ya contienen --format) — la CLI de Python debe admitir --format json para que esto tenga algún efecto; ningún otro formato de salida se transmite de esta manera.

La invocación simple y help reenvían , a diferencia de uip codedagent (donde help simple muestra la propia ayuda de Commander), uip context-grounding sin argumentos reenvía a exec --help y uip context-grounding help reenvía explícitamente a la misma llamada exec --help . Ambos muestran el propio texto de ayuda del paquete Python, no el de esta herramienta.

Retransmisión de autenticación: antes de reenviar, la CLI lee la sesión creada por uip login y la inyecta en el entorno del subproceso de Python, el mismo mecanismo que utiliza uip codedagent . Si no has iniciado sesión, el reenvío sigue funcionando; la CLI de Python se ejecuta sin esas variables.

Códigos de salida

Se aplican los códigos de salida estándar, más 3 específicamente para el comando bloqueado auth descrito anteriormente. De lo contrario, el código de salida del subproceso reenviado se retransmite directamente al shell principal.

Relacionado

• Herramientas (complementos) : modelo de herramienta de envoltura fina.
• uip codedagent : el mismo patrón de puente de Python, con una lista blanca de reenvío fija en lugar de reenviar todo.
• 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 context-grounding-tool .