Human-in-the-loop / 人机回路第 46 篇

06 filesystem permission interrupts

它是什么

本站只展示教学文档和静态源码。不会执行示例、启动服务、访问模型、数据库或其他外部系统。

约 222 字·预计阅读 1 分钟
本页目录

它是什么

除了 interrupt_on,Deep Agents 的内置文件系统工具也能通过 FilesystemPermission(mode="interrupt") 暂停。命中规则时,会产生和普通工具审批一样的 interrupt。它解决的问题是:按路径和操作类型保护文件写入。

常用程度

中。涉及写文件、改配置、写 secrets、写生产目录时很有用。

最小代码

文件:deepagent_src/human_loop_teach/06_filesystem_permission_interrupt.py

permissions=[
    FilesystemPermission(
        operations=["write"],
        paths=["/secrets/**"],
        mode="interrupt",
    )
]

运行

uv run python deepagent_src/human_loop_teach/06_filesystem_permission_interrupt.py

预期输出末尾:

filesystem permission interrupt HITL real agent ok

验证方式

脚本要求 Agent 写 /secrets/key.txt,文件系统权限规则触发 interrupt。approve 后,虚拟文件系统的 write_file 才执行。

常见误区

这里保护的是 Deep Agents 的虚拟文件系统工具,不是操作系统真实 /secrets。生产里还要配真实后端权限,不要只靠模型层审批。

参考资源与示例代码