user 字段:由你自己定义的标识符,表示这次调用代表哪位终端用户。Dify 不会对它做任何认证,为每个人选一个稳定的值(如账户 ID),并在每次调用中发送同一个值。
新的 user 第一次出现时,Dify 就会开始跟踪它,一个应用密钥可服务任意数量的终端用户。
user 的作用范围
user 决定每次调用能看到什么、能做什么:
- 会话:列表、历史、重命名和删除都只作用于该用户自己的会话。
-
文件:不受
user限制。同一工作空间中的任何运行,无论发送哪个user,都可通过id引用上传的文件。如果各用户的上传文件需要相互保密,应由你的应用确认id属于同一请求中的user。 -
停止生成:对话类应用的停止接口仅在
user与发起回复的用户一致时生效。不一致时会被静默忽略:调用同样会成功,因此无法从响应中察觉。 Workflow 应用的「停止工作流任务」则不检查user。
API 用户与 Web 应用用户相互独立
API 流量与 Dify 托管的 Web 应用使用彼此独立的身份:API 用户创建的会话不会出现在 Web 应用中,Web 应用中的会话也不会出现在 API 里。解析终端用户 ID
有些响应只携带终端用户 ID 而非完整信息,例如上传文件响应中的created_by。可用 获取终端用户信息 解析它。