⚡

i4h工作流设置Skill i4h-workflow-setup

该技能用于验证宿主环境并运行设置脚本，以引导安装和配置 i4h 工作流中的 agentic workflow。它负责解析仓库、执行设置脚本、验证组件，并提供故障排除指南。关键词：i4h、医疗保健、agentic workflow、设置、安装、环境引导。

医疗工作流 0 次安装 0 次浏览 更新于 9/6/2026
名称 i4h-workflow-setup
版本 “0.6.0”
描述 验证宿主要求并运行 workflows/agentic/setup.sh。当被要求设置、安装或引导 agentic 工作流，或遇到缺少 .venv、第三方检出或引擎错误时使用。
开源协议 Apache-2.0 metadata:
作者 “Isaac for Healthcare Team isaac-for-healthcare-support@nvidia.com” tags: - isaac-for-healthcare - i4h - agentic-workflow - setup - installation

i4h 工作流 — 设置

目的

验证宿主要求并运行幂等的 workflows/agentic/setup.sh 以引导 agentic 工作流。当被要求设置、安装或引导该工作流，或遇到缺少 .venv、第三方检出或引擎错误时使用。

基础代码

这些步骤驱动 i4h-workflows 基础代码（workflows/agentic/ 目录树）。要复用已有的检出，请将 I4H_WORKFLOWS 设置为其路径（不会发生克隆）。否则，此过程会解析当前仓库，或克隆到 ~/i4h-workflows —— 选择该默认值而无需提示。请在解析出的根目录中运行以下每条命令：

# Resolve the i4h-workflows base code (provides workflows/agentic/).
ROOT="${I4H_WORKFLOWS:-$(git rev-parse --show-toplevel 2>/dev/null)}"
if [ ! -d "$ROOT/workflows/agentic" ]; then
  ROOT="${I4H_WORKFLOWS:-$HOME/i4h-workflows}"
  [ -d "$ROOT/workflows/agentic" ] || git clone https://github.com/isaac-for-healthcare/i4h-workflows "$ROOT"
fi
export I4H_WORKFLOWS="$ROOT"; cd "$ROOT"

基本说明

  • workflows/agentic/setup.sh 是幂等的设置入口点。
  • Cosmos 设置是独立的；仅在用户要求 Cosmos 或视频传输时才调用。

预检

command -v uv
command -v git
nvidia-smi
df -h .

必需：Linux、uv、git、NVIDIA 驱动/GPU、用于第三方检出的磁盘空间。除非使用 Cosmos 或本地 VLM 容器，否则 Docker 是可选的。

按顺序运行以下步骤。每个步骤是一个单独的 bash 调用；变量会保留在本地 agent 的 tmux 会话中。

步骤 1 — 解析仓库和运行目录

REPO_ROOT="${I4H_WORKFLOWS:-$(git rev-parse --show-toplevel 2>/dev/null)}"; [ -d "$REPO_ROOT/workflows/agentic" ] || REPO_ROOT="$HOME/i4h-workflows"
RUN_DIR="${REPO_ROOT}/workflows/agentic/runs/setup_$(date +%Y%m%d_%H%M%S)"
mkdir -p "${RUN_DIR}/logs"
ln -sfn "${RUN_DIR}" "${REPO_ROOT}/workflows/agentic/runs/.latest"

步骤 2 — 运行设置

在刚克隆的仓库上，工具链可能会要求批准一次 setup.sh。将 I4H_WORKFLOWS 设置为预先存在的受信任克隆，以跳过新克隆门禁。

"${REPO_ROOT}/workflows/agentic/setup.sh" > "${RUN_DIR}/logs/setup.log" 2>&1

使用 tail -f "${RUN_DIR}/logs/setup.log" 查看进度。对于组件特定的重试（同样幂等）：

"${REPO_ROOT}/workflows/agentic/third_party/setup.sh"
"${REPO_ROOT}/workflows/agentic/policy/gr00t_n16/setup.sh"

验证

"${REPO_ROOT}/workflows/agentic/policy/run.sh" --list-envs
"${REPO_ROOT}/workflows/agentic/arena/run.sh" --list-envs
"${REPO_ROOT}/workflows/agentic/policy/run.sh" --env scissor_pick_and_place --dry-run
"${REPO_ROOT}/workflows/agentic/arena/run.sh" --env scissor_pick_and_place --dry-run

先决条件

  • 具有 uv、git 和 NVIDIA 驱动/GPU 的 Linux 主机（通过预检命令检查）。
  • 用于第三方检出的磁盘空间（df -h .）。
  • Docker 仅在需要使用 Cosmos 或本地 VLM 容器时需要；否则可选。

限制

  • 仅支持 Linux；需要 NVIDIA 驱动/GPU。
  • Cosmos 设置是独立的——setup.sh 不会运行它；仅在用户提出要求时调用 Cosmos。
  • 验证步骤使用 --list-envs 和 --dry-run；它们确认环境注册并构建，但不保证完整 rollout 正常工作。

故障排查

  • 错误： 未找到 uv / git / nvidia-smi — 原因：缺少宿主要求。解决方法：安装它并在运行 setup.sh 前重新执行预检。
  • 错误： 某个组件在设置过程中途失败 — 原因：某个检出或组件虚拟环境未完成。解决方法：重新运行该组件的脚本（例如 third_party/setup.sh、arena/setup.sh、policy/setup.sh）；它们都是幂等的。
  • 错误： 设置后 --list-envs 或 --dry-run 失败 — 原因：设置不完整或缺少组件虚拟环境。解决方法：检查 ${RUN_DIR}/logs/setup.log（或 workflows/agentic/runs/.latest/logs/setup.log）并重新运行 setup.sh 或失败的组件脚本。
  • 错误： setup.sh 立即失败并重定向到不存在的日志目录 — 原因：步骤 2 在步骤 1 之前运行，因此 ${RUN_DIR}/logs 不存在。解决方法：先运行步骤 1，再运行步骤 2。

最终响应

报告设置状态、失败的组件（如果有）、相关日志路径以及下一步建议的冒烟测试。