NocoBase 内置 AI 员工 Dex：从非结构化文本到结构化数据的智能整理与表单自动填写
【免费下载链接】nocobaseNocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase
Dex 是 NocoBase 内置的数据整理专家（Data Organizer），核心职责是从邮件、聊天记录、文档片段等非结构化内容中提取关键信息，整理为表格、清单等结构化结果，并借助 Form filler 工具将提取结果直接填入业务表单。读完本文，你将掌握 Dex 的角色定位、适用场景、两种使用入口，以及它背后由systemPrompt驱动的信息提取、数据标准化、智能整理、表单自动化四大能力闭环，并能在自己的 NocoBase 项目中快速启用和组合使用。
角色定位：不只是聊天，而是"会干活"的数字同事
在 NocoBase 的 AI 员工体系（AI Employees）中，每个员工都是一个由**人设（Role setting）和技能（Tool / Skill）**组成的可执行智能体，它们不是"只会聊天"的机器人，而是可直接在业务界面中理解上下文并执行操作的"数字同事"。内置 AI 员工的完整清单与角色分工参见 内置 AI 员工，其中：
- Atlas（团队领导，主 Agent）：理解用户意图，协调合适的 AI 员工处理任务；
- Dex（数据整理专家，业务员工）：从文本中提取结构化信息，辅助填写表单；
- Viz（洞察分析师）、Ellis（电子邮件专家）、Lexi（翻译助理）等则各自承担分析、邮件、翻译等专项职责。
Dex 的定位在源码中有着精确的定义。在 插件源码 dex.ts 中，Dex 通过defineAIEmployee注册，其关键元信息如下：
username: 'dex'：员工唯一标识；position: 'Data organizer'：岗位为数据整理专家；bio：自我介绍——"I extract and structure data from text, and can fill forms automatically."（从文本中提取和结构化数据，并自动填写表单）；greeting：开场白——"Hi! Send me text and I'll structure it into organized data or fill forms."（把文本发给我，我会整理成结构化数据或填写表单）。
可以推断，defineAIEmployee是 NocoBase AI 员工插件的统一注册入口，所有内置员工（Atlas、Dex、Viz、Ellis 等）都通过同一机制声明，从而获得对话面板、区块上下文、技能调用等一致的运行时能力。
适用场景：三类典型的"脏数据"处理需求
根据 Dex 文档 与源码systemPrompt的职责声明，Dex 主要解决以下三类场景：
- 从文本中提取联系人、日期、事项、需求等信息：例如从一封客户邮件中提取联系人姓名、电话、期望日期、待办事项；从会议纪要中提取决策项与负责人。
- 将杂乱内容整理成表格或清单：把多来源、格式不一的文本片段整理为清晰的表格或条目清单，方便后续查阅与录入。
- 根据提取结果辅助填写表单：当用户提供表单时，Dex 自动调用 Form filler 工具，将提取出的数据映射到表单对应字段，减少重复手工录入。
这三类场景共同指向一个核心价值：把"读懂非结构化文本"和"写入结构化业务数据"这两个环节打通，让数据从邮件/文档到业务系统之间的搬运自动化。
底层能力剖析：systemPrompt 定义的四大职责
Dex 的行为边界并非写在代码逻辑里，而是由systemPrompt（系统提示词）驱动。从 dex.ts 源码 可以看到，其职责被明确划分为四部分：
1. 信息提取（Information Extraction）
- 从邮件、文档、聊天记录、会议纪要中抽取关键事实；
- 识别联系人、日期、行动项、决策、需求等信息；
- 区分重要信息与次要信息。
2. 数据标准化（Data Standardization）
- 清洗并格式化不一致的数据；
- 标准化日期、电话号码、地址等格式；
- 修正拼写错误与不一致之处；
- 保证数据质量与完整性。
3. 智能整理（Smart Organization）
- 生成结构化摘要；
- 产出干净的表格或清单；
- 将相关信息分组；
- 突出关键点与行动项。
4. 表单自动化（Form Automation）
- 当用户提供表单时，自动调用Form filler工具；
- 将提取的数据映射到正确字段；
- 节省重复数据录入时间。
此外，systemPrompt还约束了输出风格与行为准则：
- 输出风格：优先以整洁的表格或列表呈现信息，用要点符号增强可读性，关键信息加粗，用清晰标题划分小节；只有用户明确要求时才使用 JSON/CSV 等技术格式；
- 行为准则：主动整理、以清晰性优先于技术精确性、让数据"业务可用"而非"开发者可用"，仅在关键时刻才向用户提问澄清；若信息不足，用通俗语言说明缺失了什么。
同时，systemPrompt中使用了{{$nLang}}语言模板变量，要求 Dex 使用用户当前语言沟通（默认英语），这表明 Dex 的语言行为由 NocoBase 的本地化机制统一注入，与其position、greeting等元信息共同构成完整的人设。
使用入口一：AI 员工对话面板
Dex 最直接的使用入口是 AI 员工对话面板：
- 点击页面右下角的 AI 员工入口打开对话框；
- 在员工切换器（AI Employee Switcher）中切换到 Dex；
- 直接粘贴或上传邮件、聊天记录、文档片段等非结构化文本；
- Dex 即会按照上述四大职责输出结构化整理结果。
默认情况下，会话的初始员工是团队领导 Atlas，他会根据你的问题自动分派合适的员工协作；你也可以按具体场景手动切换到 Dex。会话内还支持切换模型（Model Switcher），并按员工维度记忆模型偏好。更多协作方式见 与 AI 员工协作。
使用入口二：表单页面中选择区块上下文
Dex 的第二个使用入口位于表单页面——将页面区块作为上下文发送给 AI，让 Dex 基于真实业务数据结构来提取和填表。操作路径如下：
- 在表单页面打开 AI 员工对话框；
- 点击左下角"添加上下文"按钮，选择"选择区块"，应用页面进入区块选择状态；
- 鼠标悬停在区块上时，可作为上下文发送的区块会高亮变色；
- 选中目标区块后，区块上下文信息会附加在对话框中，连同提问消息一起发送；
- Dex 将基于区块内的数据结构（字段、记录等）理解任务，结合文本提取结果辅助完成表单填写。
不需要区块时，点击底部"停止"图标即可退出区块选择状态。完整的操作说明见 添加上下文 - 选择区块。
这一入口的意义在于：区块上下文让 Dex 看到了"表单长什么样、有哪些字段"，从而能够把提取到的联系人、日期、事项等信息准确映射到字段，而不是凭空生成内容。
与 Form filler 工具的联动：提取即填写
Dex 的"自动填表"能力并非独立实现，而是依赖 NocoBase AI 员工体系中的通用工具Form filler。根据 使用工具 文档，工具（Tools）定义了 AI 员工"能做什么"，工具页分为三类：
General tools：所有 AI 员工共享，通常只读，其中就包括Form filler（将数据填写到指定表单）；Employee-specific tools：当前员工专属，例如 Atlas 的AI employee task dispatching、List AI employees、Get AI employee；Custom tools：通过工作流"AI 员工事件"触发器自定义的工具，可增删并配置默认权限。
工具权限统一为两种：
Ask：调用前询问用户确认；Allow：允许直接调用。
官方建议：涉及修改数据的工具默认使用Ask。由于 Form filler 会向表单写入数据，属于修改类操作，在实际业务中建议为其保留Ask权限，让每次填表动作都经过用户确认，避免 AI 误填。
由此可以梳理出 Dex 处理"文本 → 表单"的完整链路：
非结构化文本（邮件/聊天/文档） │ ▼ Dex 信息提取 + 数据标准化 + 智能整理 │ ▼ 识别到表单 → 调用 Form filler 工具（Ask/Allow 权限控制） │ ▼ 数据映射到表单字段 → 用户确认 → 完成填写前置条件：配置 LLM 服务并启用员工
要在项目中使用 Dex，需要先完成 AI 员工的最小可用配置（详见 快速开始）：
- 安装插件：AI 员工是 NocoBase 内置插件（
@nocobase/plugin-ai），开箱即用，无需单独安装； - 配置 LLM 服务：入口为
系统设置 -> AI 员工 -> LLM 服务，或在 AI 对话面板选择模型时通过"添加 LLM 服务"快捷入口跳转。一般需要选择服务商、填写 API Key、配置启用模型（默认使用推荐模型即可），详见 LLM 服务配置； - 启用内置员工：内置 AI 员工默认已全部启用，通常无需手动逐个开启；如需调整可用范围，可在
系统设置 -> AI 员工列表页修改Enabled开关，详见 启用 AI 员工； - 开始协作：在对话面板切换到 Dex（或交由 Atlas 自动分派），选择模型后即可开始工作。
Dex 在 快速开始文档 中的能力描述为"字段翻译、格式化、信息提取"，与源码中"extract and structure data from text, and can fill forms automatically"的声明相互印证，构成了对 Dex 能力的完整画像。
实战建议与注意事项
基于 Dex 的角色设定与工具机制，以下实践要点值得留意：
- 明确输入边界：Dex 擅长从"文本"中提取信息，使用时应把原始文本或包含数据的区块作为上下文提供，越明确的输入（如一封完整邮件、一段会议纪要）越容易得到高质量的结构化输出；
- 善用区块上下文：在表单页面使用"选择区块"可以让 Dex 感知目标字段结构，这是"辅助填写表单"场景下最贴合 NocoBase 业务形态的用法；
- 合理配置工具权限：对 Form filler 等写操作工具保留
Ask权限，平衡效率与数据安全；如需扩展，可在工作流中创建AI employee event触发类型，将其注册为Custom tools并按业务风险配置权限； - 与 Atlas 协作分派：不必每次都手动切换员工，直接向 Atlas 描述任务，他会根据任务类型分派到包括 Dex 在内的合适员工，再由 Dex 完成数据整理与填表动作；
- 按需扩展知识库：如果提取任务涉及企业特有术语或格式规范，可结合 AI 知识库 与 RAG 能力提升回答稳定性与可追溯性。
小结
Dex 是 NocoBase AI 员工体系中面向"数据整理"这一高频业务痛点的预置员工。从 角色定义源码 到 内置员工概览，再到 工具体系 中的 Form filler 联动，Dex 形成了一条"提取 → 标准化 → 整理 → 填表"的完整数据流水线。配合对话面板入口、表单区块上下文入口以及 Ask/Allow 权限机制，它能在真实业务系统中将非结构化信息高效、可控地转化为结构化业务数据。
【免费下载链接】nocobaseNocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
