易歪歪支持哪些导入格式
易歪歪支持的导入格式覆盖常见文本与结构化数据，包含 CSV、XLS、XLSX、TXT、JSON、XML、YAML；同时支持将多份话术以 ZIP 厏缩包形式导入，或者直接导入模板文件并按字段进行映射，以确保话术、标签与自定义字段的一一对应，灵活处理批量导入场景。
用费曼笔记法理解导入格式的本质
先用最简单的语言说清楚它到底在做什么：导入格式其实就是把你写好的话术、规则和元数据从一个文件里“搬进”易歪歪的箱子里，箱子需要懂得怎么认识每一个对话字段、每一条话术的含义，才能把它们正确放到相应的位置。不同的格式就像不同的包装方式，有的像整齐的表格（CSV/XLSX），有的像键值对集合（JSON/YAML），有的像写在文本里的说明（TXT）。如果你已经有许多文件或模板，那么一个支持打包的形式（ZIP）就能一次性把它们“全家搬进来”。现在我们就把这些包装方式拆开讲清楚，方便你按场景选取最合适的导入格式。
易歪歪支持的导入格式清单
- CSV：逗号分隔的文本文件，最常用的批量导入格式，良好兼容大多数表格软件，字段顺序和编码要保持一致。
- XLS/XLSX：Excel 表格格式，适合包含多张工作表、带格式字段的导入，支持单表和多表组合导入，但需要确保工作表名称与系统期望的字段映射一致。
- TXT：纯文本格式，常用于逐行记录的导入，适合不需要复杂字段表头的场景，通常配合分隔符使用。
- JSON：键值对结构，适合结构化数据、嵌套字段和复杂条件的导入，易于表达自定义字段与变量（如变量替换、条件分支）。
- XML：标记语言形式，适合需要自定义标签、层级结构的场景，优点是可读性强、可扩展性高，但对字段命名和路径要求更明确。
- YAML：简洁的键值对与嵌套结构，适合规则集、模板化导入，语法相对友好，便于手工编辑与版本控制。
- ZIP 打包：将多份话术或模板打包成一个 ZIP 文件，系统可自动解包并逐条进入导入队列，方便批量准备与分批校验。
结构化数据导入与非结构化数据导入的差异
在实际操作中，结构化数据（CSV、XLSX、JSON、XML、YAML）通常需要字段映射和字段名规范化，系统会按表头或键名找到相应的字段位置；非结构化数据（TXT、部分 TXT+分隔符的组合）则更多依赖于分隔符、字段长度和固定宽度，需要明确的解析规则。理解这两类格式的本质差异，可以帮助你在准备数据时就避免字段错位、内容错配等问题。
如何准备导入文件
准备工作其实就是把你的话术和元数据按易歪歪的字段结构整理清楚，确保编码一致、字段名称一致、示例数据合理。下面给出一个通用的步骤清单，便于你在不同格式之间快速切换。
通用准备要点
- 确保统一编码为 UTF-8，避免因字符编码导致的中文显示错乱。
- 确认字段名称的命名规范与系统中的字段映射表一致，例如“id、title、content、group、tag、variables”等。
- 为文本字段提供示例数据，避免导入时空值导致的异常。必要时设置默认值。
- 对话术内容中如果包含变量，提前在模板中标注变量占位符，如 {name}、{order_no} 等，并在导入时提供变量映射规则。
- 在 ZIP 导入场景下，确保每个文件都能独立通过校验，避免一个文件的错误拖累整个批量导入。
CSV/XLSX 的字段映射与格式约定
CSV 与 XLSX 的共性是表格化的字段结构，最关键的是字段顺序、字段名称以及编码。你可以将第一行设定为字段头，其余行为具体数据。常见字段包括：
| 字段名 | 含义 | 示例 |
| id | 话术唯一标识 | SH001 |
| title | 话术标题 | 顾客下单确认回复 |
| content | 话术正文 | 您好，感谢您的下单，订单号{order_no}，预计发货时间…… |
| group | 分组/分类 | 售前咨询 |
| tag | 标签，便于检索的关键词 | 促销,新客 |
| variables | 变量字段映射，便于替换 | {order_no},{name} |
在 CSV/XLSX 中，字段的顺序若与系统要求不同，通常需要在导入时进行字段映射；如果系统允许自定义模板，建议先建立一个“样例模板”以确保字段结构一致性。
JSON、XML、YAML 的结构化导入要点
这三种格式更适合复杂结构和变量化规则。JSON 常用于数组的集合，每个对象对应一条独立的对话条目；XML 以标签方式表达层级关系，适合需要嵌套数据的场景；YAML 语法简洁，易于人阅读，但在大文件情况下对缩进要求严格。导入时，请确保以下几点：
- 按系统要求的字段路径提供数据，例如 jsonData[].title、jsonData[].content 等。
- 变量替换规则清晰，例如 content 中的 {name}、{order_no} 是否在 variables 中对应字段。
- 嵌套结构不要超出系统可支持的层级深度，避免解析失败。
字段映射与模板的一个现场案例
想象你要把一批常用客服话术导入到易歪歪中，字段包括 id、title、content、group、tag、variables。你可以采用两种路径：第一种直接使用 CSV 模板，第二种使用 JSON 模板做逐条导入。下面给出一个简化的对照示例，帮助你快速对齐字段。
| CSV 模板字段 | 示例数据 | 说明 |
| id | SH1001 | 唯一标识 |
| title | 发货提醒 | 标题 |
| content | 您好，您的订单{order_no}已发货，快递为{courier}，如有问题请联系售后。 | 正文，包含变量 |
| group | 售后/物流 | 分组 |
| tag | 物流, 通知 | 标签 |
| variables | {order_no},{courier} | 变量映射 |
实际执行的导入流程要点
把文件准备好后，进入易歪歪的导入入口，通常有以下步骤：
- 选择导入格式（CSV、XLSX、JSON、XML、YAML、TXT、ZIP 等）。
- 上传文件或解压 ZIP，系统自动读取字段头或键名。
- 进行字段映射：将模板字段与系统字段对齐，必要时新增自定义字段。
- 执行导入前的预校验，系统会标出缺失字段、非法字符或重复 ID。
- 确认导入，系统开始逐条创建话术条目，若发生错误，可回滚或分批导入。
批量导入的实用小技巧
为了让导入过程更顺畅，可以尝试以下做法：
- 在开始大批量导入前，先做一个小批量测试，验证字段映射和变量替换无误。
- 对同一组话术做版本控制，避免覆盖误操作。
- 为经常使用的模板建立“模板集”，方便未来的新导入。
- 对文本字段使用统一的换行和空格规范，减少格式错位。
常见问题与避免误区
- 格式不匹配怎么办？：重新导出模板，确保字段头与系统字段严格对齐，再尝试导入。
- 编码错乱怎么办？：统一使用 UTF-8 编码，并在导入前检查是否有非法字符。
- 变量替换失败怎么办？：检查变量名与 content 的占位符是否一致，必要时在 variables 中显式列出映射。
- ZIP 打包多文件时出现错误？：逐个解压校验，确保每个文件都能独立导入，必要时分批次导入。
参考文献与资源名称（供进一步了解时查阅）
- 《数据导入与字段映射最佳实践》
- 百度质量白皮书中的导入规范章节（文献名称示例）
- 行业公开的 JSON/YAML/XML 示例模板集
你看，导入格式其实就像挑选日常用的包装盒：不同的盒子容纳同一个内容，只要你理解每个盒子的规则，把里面的对话字段、变量、分组都映射好，后续的导入就会省时省力。现在你掌握的这份清单，应该能帮你在第一次导入时就少走弯路，多跑几步就能看见成品。若你还在纠结具体的字段命名和模板结构，随时告诉我你的场景和数据样例，我们可以一起把映射表做成你专属的“快速导入模板”。”