文章摘要
Dify在v1.15.0版本推出官方命令行工具difyctl,配套提供Agent Skill安装机制。用户通过搭建本地运行环境、配置工作流应用、设置调用规则等五步,可让Agent调用Dify应用。此结合将复杂业务流程简化,企业聚焦核心业务,可查看官方文档快速部署。

在v1.15.0版本中,Dify正式推出官方命令行工具difyctl。这款工具并非简单将Dify从网页端移植到终端,而是把Web端的应用能力转化为适配自动化脚本、CI流程,乃至AI Agent直接调用的能力入口。

对于需要让Codex、Claude Code、Cursor等编码类Agent直接调用Dify的用户来说,difyctl配套提供了Agent Skill安装机制。执行对应命令后,CLI会在本机Agent的技能目录中生成一份SKILL.md文件,这份文件并非给人阅读的命令手册,而是专为Agent编写的轻量化使用说明,能够帮助Agent读取本地可用的difyctl能力,并通过当前登录态获取应用列表、识别参数、调用工作流以及管理暂停恢复等操作。

想要通过Agent调用Dify应用,仅需按照以下五个步骤完成配置即可:

一、搭建本地difyctl运行环境

在开始调用前,需要先完成本地difyctl的环境配置,这相当于Agent调用Dify的操作手柄。你可以参照官方文档完成操作,也可以将相关文档链接或内容交给Agent,让它协助完成安装与配置流程。

首先是安装difyctl,你可以直接执行官方提供的安装命令,也可以将安装说明交给Agent自动完成:

curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli | bash

安装完成后,需要运行登录命令完成身份鉴权。Agent可以自动执行该指令,你也可以根据终端提示打开设备登录页面输入验证码:

difyctl auth login

执行命令后,终端会提示你打开登录页面,输入验证码完成验证,验证码有效期为15分钟,如果过期可以重新运行该命令获取新的验证码。

完成登录后,执行以下命令安装Agent Skill:

difyctl skills install --yes

该命令会在本机Agent的技能目录中生成SKILL.md文件,帮助Agent自动识别可用应用、识别调用参数、执行工作流以及管理流程暂停与恢复。

二、配置可调用的Dify工作流应用

Agent调用的并非抽象能力,而是你在Dify中提前搭建好的真实应用。以日常工作场景为例,我们可以搭建一个名为Daily Work Summary Review的工作流:该工作流会接收Agent传入的一周项目进展总结,结合知识库中的会议纪要、项目记录进行内容整理,当流程运行到Human Input审批节点时,会将结果发送给用户确认,通过审核后,最终内容会被自动推送至Slack,大幅简化日常事务的流转路径。

完成工作流搭建后,只需记住该工作流的名称,之后你就可以直接向Agent发出指令,比如“帮我调用一下Daily Work Summary Review”,Agent会通过difyctl查询当前可用的应用,并自动定位到对应的Dify应用实例。

三、为Agent配置调用规则

这是整个流程的关键步骤:Agent无法天生知晓你的业务规则,因此你需要明确告知它在何种场景下应该调用该Dify工作流,以及调用时需要传入哪些内容。例如你可以为Agent设置如下规则:

当我说‘总结项目进展’或‘同步本周工作进展’时,请基于本周对话记忆整理一段工作总结,提取进展、项目卡点和待跟进事项,然后调用Daily Work Summary Review工作流。

四、触发Agent调用,由Dify接管后续流程

当Agent接收到符合规则的用户指令后,会自动调用difyctl工具,并将整理好的内容传入目标Dify工作流。此时Agent终端会静默生成调用Payload数据,示例格式如下:

{
  "status": "paused",
  "workflow_run_id": "xxxx",
  "approval_channels": ["console", "email"]
}

由于我们在工作流中加入了Human Input审批节点,当流程运行到该节点时,Dify会将执行线程暂停,并主动向用户下发通知,确保在最终环节将决策权完全交给用户,保障流程的安全性与可控性。

五、通过邮件或控制台完成内容审核

当工作流进入暂停状态后,你会同步收到一封包含完整上下文的审批邮件,或是在Dify控制台收到通知。如果内容需要调整,你可以直接在审批表单中补充修改意见,让Agent重新生成内容;如果草稿内容无误,只需点击“Approve(批准)”按钮,Dify会自动完成后续流程:生成最终版本的内容,并跨系统推送至Slack、Webhook、团队通知群或是企业IM系统中。

整个流程中,你无需再打开终端,也无需回到Dify手动操作,Agent调用、Dify知识库能力、人工审核、外部推送已经形成了一条稳定的生产流水线。

从手动流程到一键触发的变革

在过去,完成这类工作流程需要手动整理进展、打开Dify网页、粘贴内容、运行工作流、查看结果、修改内容,再手动发送到外部协作工具,整个流程繁琐且耗时。而现在,整套流程可以被收束为一句自然语言指令和一次简单的审核动作,例如:

  • 帮我追踪本周项目进展
  • 抓取市场线索清洗与分发
  • 上传账单完成报销流程
  • 给出系统故障监控告警与预案建议

通过Dify命令行工具,Agent将自然语言交互能力延伸到了系统终端的每一个角落;而Dify工作流则将复杂的企业知识管理、人工审核环节、多系统分发流程固化为易于维护的标准化程序,让团队能够将宝贵的精力聚焦在核心业务上。

技术的价值从来不是增加额外的工作负担,而是将复杂流程简化为可复用的标准化操作。通过difyctl与Agent的结合,企业可以将高价值的决策能力重新聚焦到核心业务中,让复杂的业务流程只需一句指令和一次审核即可完成。

你可以前往官方文档中心查看快速部署指南:https://docs.dify.ai/zh/cli/install


塔猴是一个专注于为用户提供系统学习、内容创作与商业连接的AIGC综合服务平台,致力于为每一位AI探索者打造理想的创作、成长家园。在塔猴,你不仅可以学习众多AIGC类实战课程,获得与时俱进的AIGC技能和视野,还有机会获得长期商业合作和接单机会!点击进入:https://www.tahou.com/

AI生成内容提示:本文由人工智能辅助创作,内容仅供参考,不代表平台观点。请注意核实信息的准确性,并理性判断。

以上内容不代表本平台立场,仅供读者参考