Eskalation mit UIP-Agents

uip agent escalation verwaltet Eskalationsressourcen in einem Agent-Projekt – die Human-in-the-Loop (HITL)-Hooks, die der Agent zur Runtime auslösen kann, um eine Genehmigung, Klärung oder Überprüfung von einem menschlichen Operator anzufordern. Eskalationen werden neben Tools und Kontexten als Agent-Ressourcen beibehalten.

Rein lokal – keine Anmeldung erforderlich.

Zusammenfassung

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

Alle Unterbefehle berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

UIP-Agent-Eskalation hinzufügen

Fügen Sie eine Eskalationsressource hinzu.

Argumente

• <name> (erforderlich) – Name der Eskalation.

Optionen

Markieren	Standard	Zweck
--description <desc>	–	Für Menschen lesbare Beschreibung, die auf der Ressource gespeichert ist.
--type <type>	Escalation	Eskalationstyp. Bekannte Werte: Escalation, VsEscalation. Andere Werte können akzeptiert werden – führen Sie uip agent escalation add --help für die aktuelle Liste aus.
--path <path>	.	Pfad zum Agent-Projektverzeichnis.

Beispiele

# 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

Datenform (--output json)

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

Id ist eine generierte UUID. Verwenden Sie entweder Name oder Id mit escalation remove.

Eskalationsliste für UIP-Agent

Listen Sie die für den Agent konfigurierten Eskalationsressourcen auf.

Optionen

Markieren	Standard	Zweck
--path <path>	.	Pfad zum Agent-Projektverzeichnis.

Beispiel

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

Datenform (--output json)

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

Leere Projekte geben Data: { "Message": "No escalations configured" } zurück.

UIP-Agent-Eskalation entfernen

Eine Eskalationsressource entfernen.

Argumente

• <name> (erforderlich) – Name oder ID der Eskalation.

Optionen

Markieren	Standard	Zweck
--path <path>	.	Pfad zum Agent-Projektverzeichnis.

Beispiel

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

Datenform (--output json)

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

Eine fehlende Eskalation schlägt mit Escalation "<name>" not found und Exitcode 1 fehl.

Zugehörig

• uip agent tool – Fügen Sie Toolressourcen hinzu, die der Agent neben Eskalationen aufrufen kann.
• uip agent context – RAG-Kontextressourcen.
• uip agent validate – überprüft die Ressourcenintegrität nach Bearbeitungen.

Siehe auch

• Konzepte: Fähigkeiten – wie Eskalationen in das breitere Fähigkeitsmodell passen.
• Globale Optionen, Exitcodes.