Escalada del agente de UIP

gestiona uip agent escalation recursos de escalada en un proyecto de agente: los enlaces de intervención humana (HITL) que el agente puede plantear en runtime para solicitar la aprobación, aclaración o revisión de un operador humano. Las escaladas persisten junto con las herramientas y contextos como recursos de agente.

Puramente local: no es necesario iniciar sesión.

Sinopsis

uip agent escalation add    <name> [--description <text>] [--type <type>] [--path <dir>]
uip agent escalation list                                                  [--path <dir>]
uip agent escalation remove <name>                                         [--path <dir>]

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

adición de escalada de agente de uip

Añade un recurso de escalada.

Argumentos

• <name> (obligatorio) : nombre de la escalada.

Opciones

Marca	Predeterminado	Propósito
--description <desc>	—	Descripción legible por humanos, almacenada en el recurso.
--type <type>	Escalation	Tipo de escalada. Valores conocidos: Escalation, VsEscalation. Se pueden aceptar otros valores: ejecute uip agent escalation add --help para la lista actual.
--path <path>	.	Ruta al directorio del proyecto del agente.

Ejemplos

# Simplest — default Escalation type
uip agent escalation add ApprovalRequired --path ./my-agent

# With description
uip agent escalation add ApprovalRequired \
  --description "Require human approval before executing refund" \
  --path ./my-agent

# VsEscalation (Studio Desktop action-center flavour)
uip agent escalation add Review --type VsEscalation --path ./my-agent

Forma de datos (--json de salida)

{
  "Code": "AgentEscalationAdd",
  "Data": {
    "Status": "Escalation added",
    "Name": "ApprovalRequired",
    "Type": "Escalation",
    "Id": "a1b2c3d4-0000-0000-0000-000000000020"
  }
}

Id es un UUID generado. Usa Name o Id con escalation remove.

lista de escalada de agente de uip

Enumera los recursos de escalada configurados en el agente.

Opciones

Marca	Predeterminado	Propósito
--path <path>	.	Ruta al directorio del proyecto del agente.

Ejemplo

uip agent escalation list --path ./my-agent

Forma de datos (--json de salida)

{
  "Code": "AgentEscalationList",
  "Data": [
    {
      "Name": "ApprovalRequired",
      "Type": "Escalation",
      "Id": "a1b2c3d4-0000-0000-0000-000000000020"
    }
  ]
}

Los proyectos vacíos devuelven Data: { "Message": "No escalations configured" }.

eliminación de escalada de agente de uip

Eliminar un recurso de escalada.

Argumentos

• <name> obligatorio) : nombre o ID de la escalada.

Opciones

Marca	Predeterminado	Propósito
--path <path>	.	Ruta al directorio del proyecto del agente.

Ejemplo

uip agent escalation remove ApprovalRequired --path ./my-agent

Forma de datos (--json de salida)

{
  "Code": "AgentEscalationRemove",
  "Data": {
    "Status": "Escalation removed",
    "Name": "ApprovalRequired"
  }
}

Una escalada faltante falla con Escalation "<name>" not found y el código de salida 1.

Relacionado

• uip agent tool : añade recursos de herramientas que el agente puede invocar junto con las escaladas.
• uip agent context — Recursos de contexto RAG.
• uip agent validate : verifica la integridad del recurso después de las ediciones.

Ver también

• Conceptos: habilidades : cómo encajan las escaladas en el modelo de habilidades más amplio.
• Opciones globales, códigos de salida.