# 新建并挂载技能

创建可复用的分析指令，并将其关联到数据智能体。

技能是一份可复用的分析指令，用于规定分析步骤、指标口径和结果格式。将技能关联到数据智能体后，智能体会在需要时读取其内容。

技能管的是**方法**，[业务文档](https://docs.asktable.com/agent/documents)管的是**背景知识**（口径、术语、业务规则），两者互补。

## 开始前

- 权限：项目角色需要是「项目负责人」或「项目管理员」。普通项目成员可问数，但不能修改这些配置。
- 入口：左侧主导航 → 「更多」→ 左侧栏「技能」。
- 想用「通过对话打磨」，目标技能得先挂到至少一个数据智能体上。

## 操作步骤

**打开技能页**

左侧主导航 → 「更多」→ 左侧栏「技能」。左边是「技能」列表，顶部两个按钮：「从模板新建」和「创建」。还没选中技能时，右侧是空状态，提示从左侧选一个技能来查看并编辑它的完整指令。

**从模板新建**

点「从模板新建」，弹窗标题也是「从模板新建」，按卡片列出可选模板，每张卡是模板名称加一句话描述。点卡片即以该模板的名称、描述、内容建出一份项目技能，成功后直接跳到它的详情页。

弹窗里的模板如下：

| 模板名称   | 描述                         |
| ------ | -------------------------- |
| 异常检测   | 自动发现数据中的异常波动，识别超出正常范围的指标变化 |
| 预测趋势   | 基于历史数据预测未来走势，提供趋势分析和预测区间   |
| 压力测试   | 模拟不同假设场景，评估指标在极端条件下的表现     |
| 下钻指标   | 从汇总指标逐层拆解，定位问题根源           |
| 编排报告   | 自动生成结构化数据分析报告              |
| 对比分析   | 多对象、多维度横向对比，发现差异和机会        |
| 归因分析   | 分析指标变动的核心驱动因素，量化各因子贡献度     |
| 指标解读   | 用业务语言解读数据，确保数据结论准确且易于理解    |
| 数据质量检测 | 主动检测数据质量问题，确保分析结果可信        |
| 业务语言生成 | 将数据分析结果转化为生动的业务叙述          |
| 周期分析   | 识别数据中的周期模式，支持周期性波动分析       |

**或从空白创建**

点「创建」，弹窗「创建技能」里填名称（必填）和描述（可选），点「创建」。这样建出来的技能内容区块是空的，需要自己补。

**写技能内容**

详情页的「内容」区块说明这段内容会在智能体激活该技能时原样返回给它，文本框里填写完整的技能指令。写完点右上角「保存」。

**改名称和描述**

点「编辑」打开「编辑技能」，改名称和描述后点「保存」。名称改动不影响已经挂载它的智能体。

**挂到数据智能体**

左侧栏「智能体」 → 打开目标智能体 → 顶部标签「配置」 → 「技能」区块（说明写明这里放智能体可使用的技能，可以加一个或多个） → 「从模板添加」或「添加」。列表为空时区块显示暂未添加技能。

**用对话打磨**

技能挂上智能体后，详情页的「通过对话打磨」可点，它会带着这份技能进入对话，由智能体按你的反馈改写内容。技能没挂任何智能体时按钮置灰，悬停提示需要先把技能挂到智能体上。

**从对话里提取**

在「所有对话」列表里，一条对话的「提取技能」会把这段对话沉淀成一份新技能。这条对话没有绑定智能体时按钮不可用，悬停提示源对话需要先绑定智能体。

## 关键约束

| 项目         | 值或默认                             | 在哪里改                    |
| ---------- | -------------------------------- | ----------------------- |
| 技能的三个字段    | 名称、描述、内容；内容会原样交给智能体              | 技能详情页与「编辑技能」弹窗          |
| 「通过对话打磨」   | 技能未挂任何智能体时禁用                     | 先到智能体详情 → 「配置」 → 「技能」挂上 |
| 模板实例化      | 从模板建出的是项目技能，改它不动模板               | 「从模板新建」，或智能体的「从模板添加」    |
| 智能体读到的技能范围 | 挂了智能体只加载该智能体已选的技能；不挂智能体时用整个项目的技能 | 智能体详情 → 「配置」 → 「技能」     |
| 删除技能       | 智能体上的引用不会被一起清掉，只是不再有这项技能         | 技能详情页右上角图标菜单 → 「删除」     |

## 出问题怎么判断

| 现象                 | 判定条件                                  | 处理                         |
| ------------------ | ------------------------------------- | -------------------------- |
| 「通过对话打磨」是灰的        | 这份技能没有挂在任何智能体上（悬停提示需要先把技能挂到智能体上）      | 到智能体详情 → 「配置」 → 「技能」把它挂上   |
| 「从模板新建」弹窗里没有可选的模板  | 弹窗正文提示暂无可用技能模板                        | 先用「创建」从空白建一份，再把内容写全        |
| 智能体的「添加」弹窗里找不到某个技能 | 弹窗提示暂无可用技能，或该技能已经挂上了（已挂上的不再出现在待选列表）   | 先到「技能」页确认技能存在；已挂上的不用再加     |
| 挂了技能但回答没按方法走       | 智能体详情 → 「配置」 → 「技能」区块显示暂未添加技能，看不到这份技能 | 重新「添加」，并确认加的是目标智能体而不是别的智能体 |
| 「提取技能」点不动          | 悬停提示源对话需要先绑定智能体                       | 换一条绑定了智能体的对话，或先给这条对话关联智能体  |

## 下一步

- 把技能挂上智能体并接好数据源：[智能体概览](https://docs.asktable.com/agent/overview)
- 让它记住指标口径和业务规则：[业务文档](https://docs.asktable.com/agent/documents)
- 用「人员」「角色」「策略」限定技能背后的数据范围：[权限与数据范围](https://docs.asktable.com/permissions)
- 让飞书群里的用户也能用这套技能问数：[飞书用户权限](https://docs.asktable.com/permissions/feishu)