[Dify] 插件输出格式规范详解：text、files、json 的区别与使用场景

Dify 插件系统通过 OpenAPI Schema 连接外部 API，而这些 API 返回的数据形式多种多样。
为了让智能体（Agent）能正确“读懂”插件的输出，Dify 在插件系统中支持三类主要的输出格式：

text（文本）｜ files（文件）｜ json（结构化数据）

理解并正确设计这三种输出类型，
不仅能让你的插件“能调用”，更能让智能体“理解输出、复用结果”。

本文将详细讲解每种输出类型的作用机制、差异、适用场景与设计规范。

---

一、Dify 插件的输出机制回顾

当 Dify 智能体（Agent）调用一个插件时，流程大致如下：

用户输入
   ↓
LLM 推理（决定调用哪个插件）
   ↓
插件执行（调用外部 API）
   ↓
返回数据（text/files/json）
   ↓
Dify 解析并注入模型上下文
   ↓
生成最终自然语言回答

🧠 关键点在于：

• Dify 不是“直接显示 API 原始响应”，
  而是会根据插件 Schema 的输出格式，决定如何“传给 LLM”。

如果 Schema 定义模糊或类型错误，