开始前
- 权限：项目角色需要是「所有者」或「成员」。只读访客能打开页面，但保存会被接口拒绝，提示这是所有人可见的公开项目、不能修改资源配置。
- 前置：项目里已有至少一个数据源。没有的话走 左侧主导航 → 「更多」→ 「数据源」→ 右上角「添加数据源」。
- 入口：左侧主导航 → 「更多」。这个按钮直接落到「智能体」页；也可以从数据工作区左侧栏点「智能体」。
操作步骤
1
打开智能体列表
左侧主导航 → 「更多」。页面标题是「智能体」，右上角一个「创建」按钮，左侧搜索框可以按名称搜索数据智能体。
2
选模板，或从空白开始
点「创建」，弹窗标题「创建数据智能体」，可以在模板里挑一个，也可以从空白开始。
- 选模板：卡片上给出模板名称和一句话描述，点下去就按该模板建好智能体，名称、描述、技能都已预置。
- 选「从空白创建」（自定义名称和描述，从零开始配置）：填名称（必填）和描述（可选），再点「创建」。
3
接上数据源
新建后直接进入详情页。顶部标签切到「配置」，在「数据源」区块点「添加」，弹出「选择数据源」，勾选后关闭。区块说明写明这里放智能体可访问的数据源，可以加一个或多个；列表项右侧显示该数据源的表数量（形如 12 张表）。一条都没加时区块显示暂未添加数据源。
4
确认能力开关
同一页往下是「能力配置」，四个开关：Python 解释器、图表可视化、用户澄清、联网搜索。前三项默认开；联网搜索默认关，管理员没配好时开关是禁用的，描述会说明尚未配置联网搜索、需要管理员先在系统设置里配置。
5
挂技能
再往下是「技能」区块，说明写明这里放智能体可使用的技能，可以加一个或多个。「从模板添加」打开同名弹窗，按模板建技能并直接挂上；「添加」打开「选择技能」，从项目里已有的技能中挑。列表为空时显示暂未添加技能。
6
补领域知识与分析偏好
「偏好」区块两个文本框：领域知识用来描述公司背景、业务信息和关键术语口径，分析偏好用来写分析思路与输出风格（例如偏简洁 concise 还是详尽 verbose）。两者都是失焦即保存，右下角有字数计数，上限 1024 个字符。
7
换头像
点详情页左上角头像打开「编辑头像」，可按「发型」「眼睛」「眉毛」「嘴巴」「鼻子」「头型」「眼镜」「耳环」「背景色」分类挑，也可以用「随机」或「重置」，最后点「保存」。
8
回列表核对
详情页面包屑第一级是「智能体」，点它回到列表。卡片上显示名称、描述、数据源引擎标签和创建时间（相对时间，形如 3 天前）。
关键约束
出问题怎么判断
下一步
- 把反复交代的分析步骤固化成一份技能：/agent/skill
- 用「人员」「角色」「策略」控制每个人能看到哪些库、表和行：/permissions
- 把智能体接到飞书群，并决定谁可以问数：/permissions/feishu