本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。
个人访问令牌需要 Dify 1.20.0 及以上版本。
difyctl 不用登录也能以你的身份操作。它和登录的区别在于能用多久、能运行什么:
如果 CI 任务或编码 Agent 要运行应用或配置集成,就交给它一个令牌,这样它能一直工作,不用有人去续期登录。
需要修改应用时,例如通过 DSL 文件更新或发布应用,改为给任务一个 登录令牌,编码 Agent 则照旧 以你自己的登录身份 工作。
选择账户和访问范围
每个任务单独用一个个人访问令牌,这样修改、替换或删除某个令牌时,不会牵连其他任务。 团队依赖的任务,用自动化专用的账户创建令牌。这样即使你自己的权限有变,任务也能照常运行,而且它的运行记录很容易和你的区分开。把这个账户加入任务操作的每个工作空间,角色按任务在该工作空间中要运行的命令来定。 在 账户页面 创建令牌时,只启用任务需要的访问范围。之后也可修改:改动从令牌执行下一条命令时生效,不用给任务换新令牌。下面每条命令还需满足 命令索引 中列出的使用条件,例如角色要求,或应用已开启服务 API 访问。
允许令牌运行应用
任务要做以下任何一件事时,为令牌启用 资源 范围:允许令牌配置集成
任务要做以下任何一件事时,为令牌启用 管理工作空间 范围:把令牌交给 difyctl
1
查找工作空间 ID
任务要列出应用或配置集成时,需要它所操作的每个工作空间的 ID。运行
difyctl get workspace,复制每个工作空间的 id。编码 Agent 可自行查到这些 ID。2
设置环境变量
-
DIFY_SERVER:你打开 Dify 时用的地址,例如https://dify.example.com。 -
DIFY_TOKEN:令牌。 -
DIFY_WORKSPACE_ID:上一步查到的工作空间 ID(如有)。 如果任务要操作多个工作空间,改为用--workspace-id给每条命令传入对应工作空间的 ID。
difyctl:-
CI 任务:在任务中安装
difyctl,把令牌存为 CI 系统中的 Secret,再用这个 Secret 设置DIFY_TOKEN。 - 编码 Agent:在启动 Agent 的地方设置这些变量,例如你用来启动它的 Shell。 不要把令牌发到对话中:你在对话中输入的任何内容都会经过 Agent 所用的模型。
DIFY_TOKEN 时,命令会改用这些变量,不再使用你已保存的登录信息。3
检查令牌
在设置了这些变量的 Shell 中,确认令牌能访问任务要用的应用和工作空间:
-
如果令牌能运行应用,按 ID 查看任务用到的一个应用:
-
如果令牌只能管理工作空间,运行
difyctl describe account列出它可管理的工作空间,确认任务要操作的工作空间都在其中。
故障排查
其他错误详见「结果、错误与退出码」中的 故障排查。