[Dify] 插件输入参数配置详解：让 Agent 能正确理解与填写请求参数
在 Dify 的插件系统中，一个定义良好的 OpenAPI Schema 不仅要描述接口路径、响应结果，
更要让 智能体（Agent）能正确生成请求参数。
这就是 “输入参数配置（Input Parameters）” 的核心作用：
它告诉 LLM ——
“你要调用这个接口时，应该填哪些字段、每个字段代表什么、有什么约束。”
本文将结合实际案例，深入解析：
-
插件参数的两种定义方式；
-
Dify 对参数类型、范围、必填项的解析；
-
LLM 如何根据 Schema 生成参数；
-
常见错误与最佳实践。
一、Dify 插件参数的两种定义方式
在 OpenAPI 3.0+ 中，接口输入参数可以通过两种方式声明：
| 定义方式 | 典型用途 | 对应位置 |
|---|---|---|
| parameters | URL 查询参数（query）、路径参数（ |