必须用全小写、字母开头的表名和规范字段类型建表,否则nl2sql失败且无报错;工作空间切换错误会导致数据库不可用;字段命名须小写/数字/下划线,time型含时分秒,number用于金额,string用于电话防丢零。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在扣子平台开发智能体时,必须先创建结构清晰、字段类型准确的数据库表,才能让NL2SQL正确解析用户指令并持久化存储业务数据;表名若含大写字母或字段名以数字开头,会导致后续所有数据库操作失败且无明确报错提示。
进入数据库创建入口
登录扣子平台后,在左侧导航栏点击“资源库”,确保当前处于“个人空间”或已加入的“团队空间”;【工作空间切换错误将导致新建的数据库无法被智能体调用】。
点击右上角“+资源”按钮,在弹出菜单中选择“数据库”。
填写基础信息与表结构设计
在“新建数据表”窗口中,按顺序完成以下配置:
第一步:输入数据表名称,必须全部小写、仅含字母/数字/下划线,且以字母开头,例如 visitor_log;【visitorLog 或 1visitor 均会创建失败】。
第二步:填写数据表描述,如“记录访客登记信息”,该描述不参与运行,但影响团队协作时的理解效率。
第三步:点击“添加字段”,逐个定义业务所需列——此时不急于保存,先完成全部字段设计再统一提交。
扣子 (Windows) 是字节跳动推出的一站式 AI Agent 平台客户端,支持多 Agent 协作、可视化工作流和知识库管理。最新版本新增 Claude Code 与 Codex CLI 接入、多端同步和项目级管理功能,同时优化了插件生态和 AI 响应速度,让用户在 Windows 上即可高效创建、运行和协作智能体,满足个人、团队及企业场景需求。
字段类型选择与关键配置
方法一:基础字段类型对应关系(必记)
姓名 → String;电话 → String(不要选Number,避免前导零丢失);日期 → Time;是否有效 → Boolean;金额 → Number(非Integer,因Integer不支持小数);状态码 → Integer(如0待处理/1已登记/2已拒绝)。
方法二:字段命名与约束设置
字段名称只能用小写字母、数字、下划线,长度≤64字符;描述栏建议填写示例值,如“电话:138****1234”;勾选“是否必要”表示该字段不可为空——例如“姓名”和“电话”应设为必填,“备注”可不勾选。
注意:Time类型字段在扣子中默认带时分秒,若只需日期,请在Prompt中用自然语言限定,如“只记录来访日期,不记录具体时间”。
保存并验证表结构
全部字段添加完毕后,点击“保存”按钮;页面跳转至数据库列表,找到刚创建的表,点击右侧“查看”图标。
在数据表详情页,确认字段名称、类型、是否必填三项均与设计一致;此时可手动点击“新增行”插入一条测试数据,验证字段类型是否生效——例如向Number类型字段输入字母会直接报错拦截。










