inserción/extracción del agente uip

uip agent push y uip agent pull son las dos mitades del ida y vuelta de Studio Web. Comparten el mismo formato de transporte (.uis, un archivo ZIP del proyecto de agente), el mismo modelo de autenticación y la misma superficie de error. Usa push para enviar un proyecto local a Studio Web para que se muestre en la IU de Agent Builder; utiliza pull para descargar una solución de Studio Web como .uis que puedes inspeccionar, extraer o empaquetar de nuevo en una implementación de Orchestrator.

Ambos verbos requieren una sesión CLI activa (uip login).

Todos los subcomandos respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

---

inserción de agente de uip

Importa un proyecto de agente en Studio Web como una nueva solución o sobrescribe una solución existente.

Cuando la entrada es un directorio, push valida la estructura del proyecto, ejecuta el pase de validación del esquema de Studio Web (a menos que --skip-schema-validation), empaqueta en un temporal .uis excluyendo .agent-builder/ y publica el archivo en la solución Studio Web Importar API. Cuando la entrada ya es un .uis, el archivo se carga tal cual.

En una inserción de directorio correcta, SolutionStorage.json en la raíz del proyecto se actualiza con la solución en la nube devuelta y los ID del proyecto; las invocaciones posteriores de uip agent eval run pueden utilizar esos ID sin que pases --solution-id.

Sinopsis

uip agent push [path] [-n <name>] [--overwrite <solutionId>] [--skip-schema-validation] [--login-validity <minutes>]

Argumentos

• [path] (opcional, predeterminado .) : ruta al directorio del proyecto del agente o un archivo .uis .

Opciones

Marca	Predeterminado	Propósito
-n, --name <name>	agente metadata.name → nombre base de la ruta	Nombre de la solución en Studio Web.
--overwrite <solutionId>	—	Sobrescribir una solución existente por ID en lugar de crear una nueva. Cambia el punto final de POST /api/Solution/Import a POST /api/Solution/<id>/Overwrite.
--skip-schema-validation	Desactivado	Omite el pase de validación del esquema de Studio Web. Solo entradas de directorio: una entrada .uis nunca ejecuta la validación del esquema.
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos.

Ejemplos

# Push the current directory as a new solution
uip agent push

# Push a specific directory
uip agent push ./my-agent

# Overwrite an existing solution in place
uip agent push ./my-agent --overwrite a1b2c3d4-0000-0000-0000-000000000001

# Push a pre-packed archive
uip agent push ./dist/my-agent.uis

Forma de datos (--json de salida)

{
  "Code": "AgentPush",
  "Data": {
    "Status": "Agent imported into Studio Web",
    "Name": "my-agent",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectCount": 1,
    "CloudProjectId": "a1b2c3d4-0000-0000-0000-000000000002"
  }
}

Con --overwrite, Status es "Solution overwritten successfully" y SolutionId repite el valor que pasaste. CloudProjectId es "-" si la respuesta no incluye una matriz de proyectos.

---

extracción de agente de uip

Descarga una solución de Studio Web como archivo .uis . Opcionalmente, extrae el archivo en un directorio relacionado.

Sinopsis

uip agent pull <solutionId> [-d <dir>] [-n <name>] [--extract] [--login-validity <minutes>]

Argumentos

• <solutionId> (obligatorio) : UUID de la solución. Obtenga uno de uip agent list.

Opciones

Marca	Predeterminado	Propósito
-d, --destination <dir>	.	Directorio de destino para el archivo descargado. Se crea si es necesario.
-n, --name <name>	<solutionId>	Nombre del archivo de salida (sin extensión). .uis se adjunta si no está presente.
--extract	Desactivado	Después de la descarga, extrae el .uis en un directorio con el mismo nombre junto a él.
--login-validity <minutes>	10	Minutos mínimos de validez del token requeridos.

Ejemplos

# Download by ID into the current directory
uip agent pull a1b2c3d4-0000-0000-0000-000000000001

# Download into a specific directory
uip agent pull a1b2c3d4-0000-0000-0000-000000000001 -d ./downloads

# Download with a friendly filename and extract
uip agent pull a1b2c3d4-0000-0000-0000-000000000001 \
  -d ./downloads \
  -n invoice-agent \
  --extract

Forma de datos (--json de salida)

{
  "Code": "AgentPull",
  "Data": {
    "Status": "Solution exported successfully",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Output": "/abs/path/downloads/a1b2c3d4-0000-0000-0000-000000000001.uis"
  }
}

Con --extract, la carga útil incluye además ExtractedTo: "/abs/path/downloads/<name>".

---

Ejemplo de ida y vuelta

# Iterate locally, push to Studio Web, edit in the UI, pull back
uip agent init ./my-agent
uip agent validate ./my-agent
uip agent push ./my-agent               # captures SolutionId

# (edit in Studio Web)

uip agent pull <SolutionId> -d ./downloads --extract
# compare ./my-agent with ./downloads/<SolutionId>/ to reconcile

Relacionado

• uip agent list : enumera los ID de solución para alimentar pull.
• uip agent pack : produce un .uis sin involucrar a Studio Web.
• uip agent validate : se ejecuta antes de push para evitar rechazos del lado del servidor.
• uip agent share : compartir una solución después del envío.

Ver también

• Autenticación : sesiones y --login-validity.
• Conceptos: habilidades : cómo los puntos de entrada de una solución importada se convierten en habilidades.
• Opciones globales, códigos de salida.