escalonamento do agente da UIP

Sintaxe e opções para "escalonamento de agente uip", que gerencia recursos de escalonamento humanos em um projeto de agente.

uip agent escalation gerencia recursos de escalonamento em um projeto de agente — os ganchos do human-in-the-loop (HITL) que o agente pode gerar no runtime para solicitar aprovação, esclarecimento ou revisão de um operador humano. Os escalonamentos são mantidos ao lado de ferramentas e contextos como recursos do agente.

Somente local — sem necessidade de login.

Resumo

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 os subcomandos respeitam as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

adição de escalonamento do agente uip

Adicione um recurso de escalonamento.

Argumentos

• <name> necessário) — Nome do escalonamento.

Opções

Bandeira	Padrão	Finalidade
--description <desc>	—	Descrição legível por humanos, armazenada no recurso.
--type <type>	Escalation	Tipo de escalonamento. Valores conhecidos: Escalation, VsEscalation. Outros valores podem ser aceitos — execute uip agent escalation add --help para a lista atual.
--path <path>	.	Caminho para o diretório do projeto do agente.

Exemplos

# 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

Formato dos dados (--output json)

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

Id é um UUID gerado. Use Name ou Id com escalation remove.

lista de escalonamento de agentes do uip

Enumerar os recursos de escalonamento configurados no agente.

Opções

Bandeira	Padrão	Finalidade
--path <path>	.	Caminho para o diretório do projeto do agente.

Exemplo

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

Formato dos dados (--output json)

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

Os projetos vazios retornam Data: { "Message": "No escalations configured" }.

remoção de escalonamento do agente uip

Remova um recurso de escalonamento.

Argumentos

• <name> necessário) — Nome ou ID do escalonamento.

Opções

Bandeira	Padrão	Finalidade
--path <path>	.	Caminho para o diretório do projeto do agente.

Exemplo

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

Formato dos dados (--output json)

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

Um escalonamento ausente falha com Escalation "<name>" not found e código de saída 1.

Relacionado

• uip agent tool — adicione recursos de ferramenta que o agente pode invocar junto com os escalonamentos.
• uip agent context — Recursos de contexto de RAG.
• uip agent validate — verifica a integridade do recurso após edições.

Veja também

• Conceitos: habilidades — como os escalonamentos se encaixam no modelo de habilidades mais amplo.
• Opções globais, Códigos de saída.