paquete de agente de uip

uip agent pack agrupa un proyecto de agente local en un archivo .uis . Un .uis es un archivo ZIP simple del árbol del proyecto; es el formato de transporte aceptado por Studio Web (uip agent push) y la entrada al flujo de publicación de Orchestrator (uip agent publish).

Antes de empaquetar, el comando:

1. Valida la estructura del proyecto (agent.json, entry-points.json, project.uiproj, árbol de recursos).
2. Ejecuta el pase de validación del esquema de Studio Web (a menos que se establezca --skip-schema-validation ). Se muestra cualquier advertencia no grave; cualquier incidencia grave aborta el paquete con un error Schema validation failed .

El archivo producido excluye .agent-builder/ (andamiaje de desarrollo local que Studio Web regenera al importar).

Sinopsis

uip agent pack [path] [-d <dir>] [-n <name>] [--skip-schema-validation]

Todas las invocaciones uip agent pack 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.

Opciones

Marca	Predeterminado	Propósito
-d, --destination <dir>	.	Directorio de destino para el archivo .uis . Creado si no existe.
-n, --name <name>	agente metadata.name → nombre base del directorio del proyecto	Nombre del paquete. El archivo de salida es <name>.uis.
--skip-schema-validation	Desactivado	Omite el pase de validación del esquema de Studio Web. Útil para inspeccionar proyectos de trabajo en curso que serían rechazados por la API en vivo; no lo utilices en un proceso de versión.

Ejemplos

# Pack the current directory into ./my-agent.uis
uip agent pack

# Pack a specific project into ./dist/my-agent.uis
uip agent pack ./my-agent -d ./dist

# Override the archive name
uip agent pack ./my-agent -d ./dist --name invoice-agent-v1

# Skip schema validation to pack a work-in-progress project
uip agent pack ./my-agent --skip-schema-validation

Forma de datos (--json de salida)

{
  "Code": "AgentPack",
  "Data": {
    "Status": "Agent packed successfully",
    "Name": "my-agent",
    "Output": "/abs/path/dist/my-agent.uis"
  }
}

Las advertencias emitidas durante la validación del esquema se registran por separado (entradas Warning ) y no aparecen en el Data correcto. Los errores graves de esquema hacen que el comando falle antes de que se escriba el archivo.

Relación para publicar

uip agent publish ejecuta su propio proceso de empaquetado/migración/reempaquetado internamente; no necesitas ejecutar pack primero si tu siguiente paso es publish. Usa pack cuando quieras:

• Un .uis que puedes inspeccionar manualmente (cambiar el nombre a .zip y descomprimir).
• Un .uis que planeas enviar a Studio Web a través de uip agent push <file.uis>.
• Un archivo local determinista como artefacto en un trabajo de CI.

Relacionado

• uip agent validate : ejecuta el proceso de migración antes de empaquetar.
• uip agent publish : empaqueta y envía el paquete a Orchestrator en un solo paso.
• uip agent push : importa un proyecto empaquetado en Studio Web.

Ver también

• Opciones globales, códigos de salida.