publicación del agente de uip

uip agent publish empaqueta un proyecto de agente y envía el paquete resultante a Orchestrator como una nueva versión del paquete de soluciones. El PackageVersionKey devuelto es la entrada a uip agent deploy.

Internamente, publish ejecuta un proceso de varias etapas:

1. Si la entrada es un directorio, valida la estructura del proyecto y la empaqueta en un .uis temporal.
2. Extrae el .uis, migra cualquier agent.json / resource.json al storageVersion esperado (actualmente 44.0.0) y lo vuelve a empaquetar.
3. Se envía a uip solution pack para producir una solución .zip (que contiene uno o más archivos .nupkg ).
4. Carga la solución, ya sea a través de la API de soluciones estándar (predeterminada) o directamente a la fuente del paquete de Orchestrator cuando se establece --direct .

Requiere una sesión CLI activa (uip login).

Sinopsis

uip agent publish [path] [-t <tenant>] [-l <locationKey>] [-n <name>]
                  [--package-version <version>]
                  [--folder-id <id>] [--direct]
                  [--login-validity <minutes>]

Todas las invocaciones uip agent publish respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

Argumentos

• [path] (opcional, predeterminado .) : ruta al directorio del proyecto del agente o un archivo .uis ya empaquetado. Una entrada .uis omite el paso de empaquetado; todo lo demás (migrar, reempaquetar, paquete de soluciones, cargar) sigue ejecutándose.

Opciones

Marca	Predeterminado	Propósito
-t, --tenant <tenant>	tenant de inicio de sesión	Tenant de destino. Obligatorio si la sesión de inicio de sesión no tiene tenant predeterminado.
-l, --location-key <guid>	—	GUID opcional reenviado a la llamada de la API de soluciones packagesUpload (utilizado solo por la ruta de carga predeterminada).
-n, --name <name>	agente metadata.name → nombre base de la ruta	Nombre del paquete. Se convierte en el nombre de archivo .uis / .zip y el nombre del paquete en Orchestrator.
--package-version <version>	1.0.0	Cadena de versión para el paquete cargado.
--folder-id <id>	ID de la unidad organizativa de la carpeta de inicio de sesión	ID de la unidad organizativa de la carpeta de Orchestrator. Solo se consulta cuando se establece --direct ; la ruta de carga de soluciones predeterminada la ignora.
--direct	Desactivado	Carga cada .nupkg directamente a la fuente del paquete de Orchestrator y crea un Release por paquete, sin pasar por la API de soluciones. Utilízalo cuando la ruta de implementación de soluciones falle o quieras que las versiones se creen inmediatamente en una carpeta específica.
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos. Consulta Autenticación.

Ejemplos

# Publish the current project to the login tenant
uip agent publish --package-version 1.0.0

# Publish a specific project folder
uip agent publish ./my-agent --package-version 1.0.0

# Publish a pre-packed .uis
uip agent publish ./dist/my-agent.uis --package-version 1.0.0

# Direct upload into a specific folder (creates releases in that folder)
uip agent publish ./my-agent \
  --package-version 1.1.0 \
  --direct --folder-id 42

# Override tenant and name
uip agent publish ./my-agent \
  -t production \
  -n invoice-agent \
  --package-version 2.0.0

Forma de datos (--json de salida)

Ruta de carga predeterminada (Code: "AgentPublish"):

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published successfully",
    "Name": "my-agent",
    "Version": "1.0.0",
    "PackageVersionKey": "a1b2c3d4-0000-0000-0000-000000000050"
  }
}

El PackageVersionKey es lo que pasas a uip agent deploy.

--direct Ruta

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published to Orchestrator (direct)",
    "Name": "my-agent",
    "Version": "1.0.0",
    "Releases": [
      {
        "Name": "InvoiceAgent",
        "Key": "a1b2c3d4-0000-0000-0000-000000000055",
        "ProcessKey": "com.uipath.agent.InvoiceAgent"
      }
    ]
  }
}

En el modo --direct , cada .nupkg dentro de la solución .zip se carga por separado y se crea una versión por paquete. No hay PackageVersionKey; el concepto correspondiente es el Key por versión, que se puede utilizar directamente con uip agent run start.

Comportamiento de la migración

publish espera un storageVersion no superior a 44.0.0, mientras que los proyectos nuevos de Studio Web pueden ser 47.0.0. Reescribe silenciosamente los archivos agent.json y la herramienta resource.json dentro del directorio de extracción temporal al esquema esperado antes de volver a empaquetar. Tu proyecto en disco nunca se modifica.

Cada archivo migrado produce una entrada de registro Message (por ejemplo, Migrated /tmp/…/agent.json: storageVersion 47.0.0 → 44.0.0).

Relacionado

• uip agent pack : el paso de empaquetado local (incluido internamente).
• uip agent deploy — instala y activa la versión del paquete cargado.
• uip agent validate : ejecuta comprobaciones estáticas y migraciones en tu proyecto en disco antes de publicarlo.

Ver también

• Autenticación : sesiones, tenants y --login-validity.
• Orchestrator: trabajos : donde se ejecutan en última instancia los procesos de agente liberados.
• Opciones globales, códigos de salida.