本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
新 Agent 目前处于 Beta 阶段。
创建 Agent
在 Agents 页面点击 创建 > 创建空白应用，为 Agent 取名，也可选填角色（如「研究助理」）和描述。其余一切都在 配置 中完成。 若要通过共享的 DSL 文件创建 Agent，选择 导入 DSL 文件。Skill 和文件不随 DSL 传递，导入后需自行添加。创建和管理 Agent 需要「编辑」及以上角色。
配置能力
可逐项手动设置能力，也可进入 构建模式，通过对话描述需求来构建。 你在 配置 中设置的一切都会保存为 Agent 的能力，供之后的每个任务使用。另外，Agent 在自己的沙箱（20 GB 存储空间）中工作，过程中随时运行命令、处理文件。 Agent 的能力只能在这里修改：即使终端用户要求已发布的 Agent 更改自己的提示词、Skill 或工具，它也不会照做。模型
选择 Agent 运行的对话模型。优先选推理能力强、原生支持工具调用的模型，因为 Agent 要自行判断何时行动、哪个工具合适、如何解读结果。Agent 表现好不好，很大程度取决于模型，尽量选较新的模型。旧模型可能用不好沙箱：常见的表现是 Agent 始终不去运行命令或安装工具，即使任务需要也不动手。
提示词
在提示词中设定 Agent 的角色和工作方式。具体说明它应如何推理、何时借助工具，以及要避免什么。 以下几点值得写进去：- 角色与目标：Agent 以什么身份行动，要达成什么。
- 工作方法：处理典型任务时期望的步骤或顺序。
- 工具与文件的使用：点名说明各自何时使用。
- 输出：期望的格式、长度或语气。
- 在提示词中引用：输入
/引用，Agent 会在你指定的位置直接用上它。适合某个步骤依赖特定资源的场景。 - 只添加不引用：把它加到对应区域，何时使用由 Agent 自行决定。适合你更愿意相信 Agent 的判断、不想事事写死的场景。
Skill
Skill 是 Agent 针对某项特定任务遵循的一套流程。提示词设定 Agent 的整体角色，而 Skill 只负责这一项任务。 例如，客服 Agent 的提示词可把它设定为处理各类问题的客服助手，而refund-requests Skill 只处理退款：查询订单、仅处理 30 天内的退款，并在最后提供帮助中心链接。
点击 添加，上传 Skill 包：.zip 或 .skill 格式、内含 SKILL.md 的文件，大小不超过 50 MB。关于 Skill 包格式，参见 Agent Skills。
你也可在 构建模式 中让 Agent 替你创建 Skill。
文件
文件是 Agent 工作时可查阅的参考文档，如规格说明、模板或指南。与 Skill 不同，文件只是供阅读的材料，不是可执行的流程。 大小上限按文件类型区分：
你也可在 构建模式 中让 Agent 创建文件并保存到这里。Agent 创建并保存的文件，单个不超过 50 MB。
工具
为 Agent 添加 Dify 工具，让它能在聊天之外采取行动：包括工作空间中的插件、自定义 API、工作流和 MCP 服务器。部分工具需先认证才能使用。环境变量
在 高级设置 中，你可添加 环境变量：Agent 工作时可在沙箱中读取的键值对。 假设你的 Agent 的几个 Skill 都要访问同一套订单系统：一个查库存、一个下订单、一个拉报表。把系统的地址以ORDER_API_URL 为名存在这里，所有脚本都按这个名字读取。要从测试系统切换到正式系统，只需在这里改这一个值，各个 Skill 都会跟着切换。
可导入 .env 文件，一次添加多个。你也可在 构建模式 中让 Agent 代为设置。
通过对话构建
除了逐项手动设置，你也可通过描述 Agent 该做什么来构建它：对话过程中，它会自行配置好 Skill、文件和环境变量。 例如，你可以这样开场：放弃 会丢弃本次构建对话中的一切：对配置以及 文件系统 中长期文件的所有更改。
文件系统
在构建模式下，Agent 的工作会在沙箱里留下真实的文件：生成的产物（Artifacts）、自行安装的程序，以及过程中用到的其他内容。构建对话期间，点击右上角的 文件系统 即可浏览。 因为构建对话就是在塑造 Agent 本身，所以它添加的内容（比如起草的模板、安装的工具）默认为 长期 文件，在之后的每一次对话和工作流运行中均可用。实际上，这些文件和提示词、Skill 一样，都是 Agent 配置的一部分。 对于一次性的工作，比如测试文件或只用一次的转换工具，可在对话中直接告诉 Agent，例如「把这个文件设为临时」：它会归入 临时 文件，并在本次构建对话结束后清除。 在发布后的运行中，Agent 添加的任何内容都是临时的，因此运行中发生的一切都不会改变 Agent 本身。构建笔记
在构建对话中，Agent 会把配置内容记录在「构建笔记」里，即一个build_note.md 文件，在你首次点击 应用 后出现在 文件 中。
这份笔记会随 Agent 的配置一起保存。每次新对话开始时，Agent 都会重新读取笔记，将它与你的 提示词 组合成自己的指令。
应用之后，打开构建笔记，看看 Agent 记录了什么：
- 内容符合预期，就无需再动。
-
要修改笔记内容，可回到构建模式让 Agent 修订。
Agent 只维护自动生成的构建笔记：下载后再上传的副本只是普通文件，下次构建对话会另外生成一份新笔记。
- 有遗漏的话，补充到 提示词 中。
- 想让 Agent 从头重新记录，可在 文件 中删除这份笔记。
预览
将右侧面板从 构建 切换到 预览，即可以发布后终端用户看到的样子试用 Agent：回复干净整洁，Chat 功能生效。 在预览中对话不会改动 Agent 的任何配置，适合作为发布前的最后检查。发布
编辑内容会自动保存为草稿。Agent 就绪后，发布即可让该版本上线。可随时打开版本历史，回看或恢复早期版本。恢复版本时，Agent 沙箱中的长期文件也会一并恢复到该版本。
运行限制
- 时长 单次 Agent 运行无论从哪个访问点发起（Web 应用、服务 API 或工作流），都会在 1 小时后被终止，未完成的回复会被清除。 若运行被中断，可重试或把任务拆分成更小的步骤。
- 模型请求次数 Agent 每次调用模型都会计入单次运行 500 次的上限，推理越密集、工具用得越多，消耗越快。 可尝试把任务拆分成更小的步骤，让每次运行保持在上限之内。
- 回复文件 Agent 在回复中发回的文件，单个不超过 50 MB，超出的文件不会被送达。
故障排查
使用 OpenAI 兼容模型时，Agent 报错或从不调用工具
使用 OpenAI 兼容模型时，Agent 报错或从不调用工具
通过 OpenAI 兼容端点提供的模型（如 vLLM 部署）往往缺少完整的原生工具调用支持，而无论在构建对话还是发布后的运行中，Agent 都依赖这一能力。选择原生支持工具调用的模型。若兼容模型仍然报错，在供应商的模型设置中检查 token 参数名：部分较新的模型要求使用
max_completion_tokens，自动判断可能不准确。部分 OpenAI 官方模型在开启推理的情况下，无法通过 Chat Completions 协议调用工具。此时可在供应商凭据中将 API 协议 改为 Responses API。Agent 报错或忽略上传的图片
Agent 报错或忽略上传的图片
无论 Agent 的模型是否支持视觉能力，Chat 功能 中都可开启图片上传。模型不支持视觉时，Agent 可能在处理图片时报错，或当作没有收到图片来回复。改用支持视觉的模型：选择模型时留意 Vision 标签。
Agent 无法获取内网中的文件或页面
Agent 无法获取内网中的文件或页面
Agent 的沙箱运行在云端，无法访问你私有网络中的主机。公网 URL 可正常访问；内部资料请改为添加到 Agent 的 文件 中。