[Dify] 插件输入参数配置详解：让 Agent 能正确理解与填写请求参数

在 Dify 的插件系统中，一个定义良好的 OpenAPI Schema 不仅要描述接口路径、响应结果，
更要让 智能体（Agent）能正确生成请求参数。

这就是 “输入参数配置（Input Parameters）” 的核心作用：
它告诉 LLM ——

“你要调用这个接口时，应该填哪些字段、每个字段代表什么、有什么约束。”

本文将结合实际案例，深入解析：

• 插件参数的两种定义方式；

• Dify 对参数类型、范围、必填项的解析；

• LLM 如何根据 Schema 生成参数；

• 常见错误与最佳实践。

---

一、Dify 插件参数的两种定义方式

在 OpenAPI 3.0+ 中，接口输入参数可以通过两种方式声明：

定义方式	典型用途	对应位置
parameters	URL 查询参数（query）、路径参数（