UIP エージェントのエスカレーション

uip agent escalation は、エージェント プロジェクトの エスカレーション リソース を管理します。エージェントが実行時に生成して、人間のオペレーターに承認、説明、レビューを要求できる人間参加型 (HITL) フックです。エスカレーションは、ツールやコンテキストと共にエージェントのリソースとして保持されます。

純粋にローカル—ログインは必要ありません。

概要

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

すべてのサブコマンドは、 グローバルオプション (--output、 --output-filter、 --log-level、 --log-file) を優先します。終了コードは 標準コントラクトに従います。

UIP エージェント エスカレーション 追加

エスカレーション リソースを追加します。

引数

• <name> (必須) — エスカレーション名。

オプション

フラグ	既定 (Default)	目的
--description <desc>	—	人間が判読できる説明です。リソースに保存されます。
--type <type>	Escalation	エスカレーションの種類です。既知の値: Escalation、VsEscalation他の値も受け入れられるかもしれません — 現在のリストに対して uip agent escalation add --help を実行します。
--path <path>	.	エージェント プロジェクト ディレクトリへのパスです。

例

# 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

データシェイプ(--output json)

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

Id 生成されたUUIDです。「 Name 」または「 Id with escalation remove」を使用します。

UIP エージェント エスカレーション リスト

エージェントに設定されているエスカレーション リソースを列挙します。

オプション

フラグ	既定 (Default)	目的
--path <path>	.	エージェント プロジェクト ディレクトリへのパスです。

例

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

データシェイプ(--output json)

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

空のプロジェクトは [ Data: { "Message": "No escalations configured" }を返します。

uip エージェント エスカレーションの削除

エスカレーション リソースを削除します。

引数

• <name> (必須) — エスカレーションの名前 または ID。

オプション

フラグ	既定 (Default)	目的
--path <path>	.	エージェント プロジェクト ディレクトリへのパスです。

例

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

データシェイプ(--output json)

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

不足しているエスカレーションは失敗し、 Escalation "<name>" not found と終了コード 1。

関連

• uip agent tool — エージェントがエスカレーションと一緒に呼び出すことができるツール リソースを追加します。
• uip agent context — RAG コンテキスト リソース。
• uip agent validate — 編集後にリソースの整合性を検証します。

参照

• 概念: スキル — エスカレーションがより広範なスキル モデルにどのように適合するか。
• グローバル オプション、 終了コード。