Dify 的 v1.15.0 版本带来了一项值得关注的能力：官方命令行工具 difyctl 正式发布。这不仅仅是把 Dify 从网页搬到终端，而是将原本存在于 Web 端里的应用，转化成了一组更适合自动化脚本、CI 流程，乃至 AI Agent 直接调用的能力入口。
如果希望让 Codex、Claude Code、Cursor 这类编码 Agent 能直接调用 Dify，difyctl 为此提供了一个配套的 Agent Skill 安装机制。执行对应命令后，CLI 会在本机 Agent 的技能目录中写入一份 SKILL.md。这份文件不是命令手册，而是一份写给 Agent 的轻量使用说明：它会帮助 Agent 读取本地环境中真实可用的 difyctl 能力，并基于当前登录态去了解你的应用条目、接收字段识别、工作流调用和暂停恢复等操作。
下面，我们用五个步骤把这条链路跑通。
快速开始，只需五步
一、先准备本地 difyctl 环境
开始之前，需要先完成本地 difyctl 环境准备——它相当于 Agent 调用 Dify 的“手”。你可以按照官方文档逐步操作，也可以把文档链接或页面内容直接交给 Agent，让它协助完成安装和配置。
Step 1 — 安装 difyctl
首先在本地安装 difyctl。可以将安装说明交给 Agent，或直接执行官方安装命令：
curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli | bash
可以一键跳转到相关 Agent，也可以复制页面信息或文档链接，将 difyctl 相关说明提供给 Agent，或直接执行上面的命令。
Step 2 — 完成登录鉴权
安装完成后，运行登录命令。Agent 会自主运行此指令，你也可以根据终端提示打开设备登录页面输入验证码：
difyctl auth loginAgent 会根据文档说明执行安装流程，并自主运行登录命令，或是根据终端提示打开设备登录页面（http://localhost/device），输入验证码完成登录。
验证码有效期为 15 分钟；如果过期，重新运行 difyctl auth login 获取新验证码即可。
Step 3 — 安装 Agent Skill
difyctl skills install --yes这一步会在本机 Agent 的技能目录中写入一份 SKILL.md，引导 Agent 自动化发现应用、参数识别、工作流调用和暂停恢复等操作。
二、准备好 Dify 工作流
你同样需要在 Dify 中准备好可被调用的应用——Agent 调用的不是一个抽象能力，而是一个已经存在的真实 Dify 应用。
示例应用：Daily Work Summary Review
该工作流接收 Agent 传入的一周项目进展总结，结合知识库中的会议纪要、项目记录进行整理，并在进入 Human Input 审批节点后将结果发送给用户确认，通过后，最终内容被发送至 Slack，缩减日常事务的流转路径。
完成工作流构建后，记住工作流名称，接下来直接告诉 Agent 这一句指令：
"帮我调用一下 Daily Work Summary Review"
Agent 会通过 difyctl 查询可用应用，并自动定位到此 Dify App 实例。
三、让 Agent 学会如何调用这条工作流
这一步是关键。Agent 不会天然知道你的业务规则，所以需要告诉它：在什么情况下应该调用这条 Dify 工作流，以及调用时应该传入哪些内容。
Example Prompt Rule
"当我说‘总结项目进展’或‘同步本周工作进展’时，请基于本周对话记忆整理一段工作总结，提取进展、项目卡点和待跟进事项，然后调用 Daily Work Summary Review 工作流。"
四、Agent 触发，Dify 接管后续流程
Agent 接收到对应指令后，会自动调用 difyctl，并将整理好的内容传入 Dify 工作流。Agent 终端会静默抓取 Payload 数据：
{
"status": "paused",
"workflow_run_id": "xxxx",
"approval_channels": ["console", "email"]
}因为在该工作流中我们加入了 Human Input 节点，一旦工作流运行到该处，Dify 会极其安全地将执行线程处于"Paused 暂停挂起"状态，并主动下发通知，确保在最后关头将决策权毫无保留地传递给用户。
五、在邮件或控制台中审核内容
工作流处于安全阻断后，你会同步收到一封完整覆盖上下文的审批邮件或 Dify 控制台通知。
如果内容需要调整，可以直接在审批表单中补充修改意见，重新生成内容。
如果草稿内容无误，只需"Approve（批准）"，Dify 将代劳余下一切工作：完成最终版本的修改，并跨系统推送至 Slack、Webhook、团队通知群或者企业的 IM 系统中。
此时你不需要再打开终端，也不需要再回到 Dify 手动操作。Agent 调用、Dify 知识库能力、人工审核、外部发送，已经成为一条稳定的生产流水线。
从手动流转，到一句话触发
过去，完成这样一条流程可能需要手动整理进展、打开 Dify、粘贴内容、运行工作流、查看结果、修改内容，再发送到外部协作工具。现在，它可以被收束成一句指令和一次审核动作：
- 帮我追踪本周项目进展
- 抓取市场线索清洗与分发
- 上传账单完成报销流程
- 给出系统故障监控告警与预案建议
通过 Dify 命令行，Agent 将自然语言拓展到了系统终端的每一个角落；而 Dify 工作流，则将复杂的企业知识管理、人工控制层、多方分发彻底固化成为了易于维护的规范化程序。
将宝贵的精力和创造，放在最核心的业务上。
技术的意义从来不是增加繁重的信息。最终，复杂流程也可以收束成一句指令和一次审核动作，企业得以将高价值的决策力重新对焦于核心业务。
