数据库

功能概述

数据库功能是涂鸦开发者平台为 Agent 提供的结构化数据管理模块。它支持智能体在运行过程中，通过自然语言或系统逻辑完成 数据的存储、读取、更新与删除 操作。

通过数据库功能，开发者可以为 Agent 快速构建以下能力：

• 记录用户行为与日志。
• 保存个性化资料与偏好。
• 管理多用户共享数据。
• 构建业务知识库与后台数据表。

平台提供三种数据模式，满足从个人交互到协作共享的不同需求：

• 单用户模式：每位用户拥有独立数据空间。
• 多用户模式：用户间共享或协作同一数据集。
• 开发者模式：后台数据由开发者维护，用户仅可查询使用。

数据库模式说明

模式	典型实践场景	数据类型与读写逻辑	使用示例
单用户模式	面向个人数据记录、陪伴与成长型应用，适用于用户专属记忆、学习日志、健康记录等	数据类型：用户私有数据 读写逻辑：仅本人可新增、修改、删除数据 隔离策略：按用户 ID + PID + Agent 数据隔离，用户、Agent、PID 间数据互不干扰	AI 玩具：记录每日学习与成长事件，如 “今天我学会了拼积木” AI 日记助手：记录情绪、心情、每日计划 消费记录助手：记录 “今天午餐花了 35 元”，并生成统计表
多用户模式	面向共享与互动场景，适用于任务榜单、协作互动、社交留言	数据类型：公共或群组共享数据 读写逻辑：多个用户可写入 同步机制：多终端、多人实时同步更新	漂流瓶聊天：所有用户共享留言池，可以随机抽取留言、提交留言 AI 任务广场：用户记录每日任务完成情况并统计排名 班级学习榜：展示所有成员任务完成率与积分
开发者模式	面向后台知识管理与数据集中维护场景，适用于产品资料、图书问答、FAQ 系统等	数据类型：由开发者统一维护 读写逻辑：仅开发者可写入更新，用户仅能查询 权限控制：Agent 仅具备 只读 权限	产品资料 Agent：后台导入产品参数、功能说明，用户通过问答方式查询 图书馆助手：查询书籍作者、简介、状态 企业知识库：集中维护业务知识、政策文档供查询使用

使用示例

下文展示了三种模式在实际 Agent 场景中的典型应用。

单用户模式

示例及说明	对话示例
AI 玩具 · 成长记录本： 为每位用户创建独立数据表，记录每日学习与互动	用户：“帮我记一下，今天我学会了拼积木。” Agent：“已记录：今天学习任务 - 拼积木！”
AI 录音笔/日记助手： 用户以语音或文字记录会议、待办或心情日志， 数据仅本人可见	用户：“记一下会议要点：周五提交新版文档。” Agent：“已记录任务：提交新版文档。”

日记卡片 示例界面：

多用户模式

示例及说明	对话示例
AI 任务广场： 多个用户共享任务数据表，系统自动统计任务完成率与排名	用户：“今天我读完了两本书。” Agent：“太棒了！你今天任务完成率 100%，当前排名第 3。”
漂流瓶聊天/公共留言板： 用户向公共表发送留言，随机被他人查看或回复	用户：“我想给下一个人留言：要开心呀～” Agent：“留言已投出！等会儿看看谁会收到吧。”

家庭多用户支出助手 示例界面：

开发者模式

示例及说明	对话示例
产品知识问答 Agent： 开发者在后台维护产品资料（规格、功能、FAQ），Agent 在对话中查询返回结果	用户：“这款灯支持 Wi-Fi 吗？” Agent：“支持哦！该产品支持 2.4 GHz Wi-Fi 连接。”
图书馆助手： 后台维护图书信息，用户通过自然语言进行检索	用户：“查一下《人类简史》的作者。” Agent：“《人类简史》的作者是尤瓦尔 · 赫拉利。”

图书馆 AI 助手 示例界面：

数据导入与测试

项目	单用户模式	多用户模式	开发者模式
测试数据导入	不支持	不支持	支持
线上数据导入	不支持	不支持	支持

数据库操作流程

创建数据库

1. 前往 我的智能体 页面，在目标智能体的 操作 栏下单击 开发版本 进入 Agent 编辑页面。

   

2. 在 模型能力配置 > 记忆 下选择 数据库，并单击右侧的添加（+）按钮。

   

3. 在 选择数据库 页面，点击左上角 添加数据库，或直接绑定右侧已有数据库。
   

4. 定义数据表结构：参考以下配置说明，根据 Agent 的业务类型，定义表类型、表描述、表字段等信息。

   

   项目	配置说明
   表名称	建议使用 小写英文字母 + 下划线 的格式命名（例如 user_diary、book_library） 命名需清晰体现业务含义，避免模糊或重复
   表类型	单用户模式：适用于单一用户的独立数据管理（如个人日记、学习记录、消费日志） 多用户模式：支持多用户协作与数据共享（如任务榜单、留言墙、家庭账本） 开发者模式：面向开发者的统一管理型数据表（如知识库、产品资料、后台 FAQ）
   数据表描述	重要：此字段直接影响 AI 对数据表语义的理解与匹配精度，描述应清晰表达用途与 内容范围； 例如：当用户了解书籍相关信息（书名、作者、出版社、类别、馆藏位置、状态等）时， 优先从该表中检索数据进行回答与推荐； 该表支持书籍查询、借阅记录统计、阅读推荐及知识检索等功能，为每个数据表提供完整、 具体、语义化描述，可显著提升 AI 调用准确率
   图标	为每个表选择简洁、直观的图标，便于在控制台快速识别用途； 图标越贴合业务主题，前端展示与检索体验越好
   表字段	每个字段需包含： 字段 ID：英文命名 字段描述：功能与用途 数据类型：字符串、布尔、数值、时间等 是否必填：Yes/No 字段定义越清晰，AI 的数据调用与语义推理越准确。可选择通过 AI 生成表字段， 并在生成结果中手动调整或补充描述，如下图所示：

   • AI 会根据您提供的语义智能推断数据库结构。
   • 描述越具体，生成的结构越精准（包括字段名、用途、类型）。
   • 支持多轮对话微调字段配置，系统会实时更新结构定义。

5. 填写完成后，单击 保存，系统将自动初始化表结构。

   若为 开发者模式，可单击 批量导入 导入样例数据用于测试。

   

测试调试

进入 Agent 调试 步骤。您可以选择扫码调试或在线调试，以验证对话回复效果。