escalade d’agent UiP

uip agent escalation gère les ressources d'escalade sur un projet d'agent — les hooks in-the-loop que l'agent peut soulever au moment de l'exécution pour demander l'approbation, la clarification ou l'examen d'un opérateur humain. Les escalades sont conservées avec les outils et les contextes en tant que ressources d’agent.

purement local — aucune connexion requise.

Synthèse

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

Toutes les sous-commandes respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

ajout d'escalade d'agent uip

Ajoutez une ressource d’escalade.

Arguments

• <name> (obligatoire) : nom de l’escalade.

Options

Drapeau	Default	Objectif
--description <desc>	—	Description lisible par un humain, stockée sur la ressource.
--type <type>	Escalation	Type d’escalade. Valeurs connues: Escalation, VsEscalation. D’autres valeurs peuvent être acceptées — exécutez uip agent escalation add --help pour la liste actuelle.
--path <path>	.	Chemin d’accès au répertoire du projet d’agent.

Exemples

# 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

Format des données (--sortie json)

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

Id est un UUID généré. Utilisez Name ou Id avec escalation remove

liste d’escalade d’agents UiP

Énumérez les ressources d’escalade configurées sur l’agent.

Options

Drapeau	Default	Objectif
--path <path>	.	Chemin d’accès au répertoire du projet d’agent.

Exemple

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

Format des données (--sortie json)

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

Les projets vides renvoient Data: { "Message": "No escalations configured" }.

Suppression de l’escalade d’agent uip

Supprime une ressource d’escalade.

Arguments

• <name> (obligatoire) : nom ou ID de l'escalade.

Options

Drapeau	Default	Objectif
--path <path>	.	Chemin d’accès au répertoire du projet d’agent.

Exemple

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

Format des données (--sortie json)

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

Une escalade manquante échoue avec Escalation "<name>" not found et le code de sortie 1.

Associé

• uip agent tool — ajoutez des ressources d'outil que l'agent peut invoquer avec les escalades.
• uip agent context — Ressources de contexte RAG.
• uip agent validate — vérifie l'intégrité de la ressource après les modifications.

Voir également

• Concepts: compétences - comment les escalades s'intègrent dans le modèle de compétence plus large.
• Options globales, codes de sortie.