AnydoDocs
扩展能力

跨设备硬件

让 Agent 通过源机器 Runner 安全访问已启用的 USB 或 PCIe 资源。

硬件可以连接在不同于 Agent 会话的另一台在线机器。命令始终由硬件所在的源 Runner 执行,设备不会映射到 Agent 机器。

启用流程

  1. 在源机器设置中发现 USB/PCIe 资源
  2. 机器管理员明确启用目标资源
  3. 在 Composer 添加菜单选择 Hardware
  4. 选择源 Machine 和资源
  5. Agent 发起命令时进入运行时审批

执行限制

  • 要求调用者拥有源机器终端访问权限
  • Runner 每次重新发现并核对资源 ID
  • 必须存在于 hardware-policy.json 允许列表
  • 单次命令最长 5 分钟
  • 每个输出流最多 1MiB
  • 设备元数据通过 ANYDO_HARDWARE_* 环境变量提供

二进制数据

只有有界的小型二进制数据适合使用 base64 stdin/stdout。固件、采集数据或大文件处理应留在源机器本地,只回传摘要和必要结果。

硬件操作可能不可逆

烧录、擦除、总线写入和设备复位可能造成数据丢失或设备离线。执行前确认目标资源 ID、命令范围和恢复方法。

本页内容