本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。你的 Agent 可以把 Dify 应用当作工具来调用。它将
difyctl 作为普通子进程运行，再读取打印回来的 JSON。difyctl 会自我描述，因此 Agent 能自行发现应用、运行应用并读取结果。
Agent 自行完成的工作
Agent 会驱动一个四步循环，无需你编写任何胶水代码：- 发现 工作空间中的应用。
- 查看 其中某个应用，了解它需要哪些输入。
- 运行 该应用并传入这些输入。
- 解析 返回的 JSON 结果。
difyctl 通过 difyctl help -o json 自我描述，Agent 在运行时读取这些信息，因此始终与当前的 CLI 保持同步。
开始之前：在 Agent 运行的位置登录
Agent 不会自己登录。它运行difyctl，并复用所在机器上已有的会话，因此要先在那台机器上准备好会话：
- 在你自己的机器上：通过浏览器一次性 登录。
- 在服务器或容器中：在该机器上登录，或将会话复制过去。详见 在 Agent 运行的位置进行认证。
接入你的 Agent
Agent 通过difyctl help -o json 学习 difyctl 的用法。唯一要做的配置就是把它指向那里，具体方式取决于 Agent：
- 能读取技能 （Claude Code、Codex 等）：安装
difyctl技能。一条命令即可写入一个小文件，把 Agent 指向difyctl help -o json，它便会据此自行接入，无需任何对接代码。 - 不能读取技能：自行为它指明方向。在 Agent 的系统提示词或指令中加上一句话，例如「要使用 Dify，请运行
difyctl help -o json并使用它列出的命令」。这正是技能本应替你完成的交接。