# 能力开关详解

配置 Python、图表、用户澄清和联网搜索能力。

「配置」标签页里的「能力配置」有四个开关，它们决定智能体在回答时**能调用哪些工具**。四个都是独立开关，可以只开需要的。

| 开关         | 界面上的描述                 | 默认 |
| ---------- | ---------------------- | -- |
| Python 解释器 | 数据变换、统计分析等 SQL 难以表达的操作 | 开  |
| 图表可视化      | 为查询结果创建可视化图表           | 开  |
| 用户澄清       | 允许智能体向用户提问确认           | 开  |
| 联网搜索       | 查询数据源外的公开信息，结果落为数据框    | 关  |

## Python 解释器

**开着的时候**：智能体能执行 Python 代码，用于 SQL 表达起来很别扭的事——数据清洗、统计检验、构造中间结果。同时也**允许用户上传 Excel / CSV 附件**参与分析。

**关掉会怎样**：只剩只读 SQL。用户尝试上传附件时会被拦下，提示当前智能体未开启 Python 分析能力。

**在哪里跑**：代码不在服务器主进程里跑，而是交给独立的 Atbox 沙箱（Go 服务 + CPython）执行。每次执行起一个全新进程、用完即弃，并施加 chroot、no\_new\_privs、seccomp 和降权 UID 等隔离，跑在 Linux 上才生效。执行有超时上限，并发打满时会明确返回「沙箱已饱和」而不是排队静等。机制细节见 [AskTable 如何工作](https://docs.asktable.com/architecture)。

## 图表可视化

**开着的时候**：智能体会为查询结果自动挑图——时间趋势用折线、类别对比用柱状、占比用饼图、两量关系用散点。

**关掉会怎样**：只返回数据表格和文字结论，不做图。适合只关心数字、不想被图表干扰的场景，也能省一点生成时间。

## 用户澄清

**开着的时候**（推荐）：问题缺少关键条件时——比如没说时间范围、没说按什么粒度、没说要不要剔除退款——智能体**先反问你**，并给出可点选的选项，而不是自己猜一个然后闷头算。

**关掉会怎样**：智能体按已有语义和上下文做合理假设，直接把答案算出来，并在结论里说明它假设了什么。

这个开关是准确率的关键：关掉它不代表答案会错，但你会更难发现口径被假设成了别的样子。除非明确知道自己在问什么、且不想被打断，否则保持开启。

**Tip：建议保持开启**

关掉用户澄清不会让答案立刻出错，但你会更难发现口径被换成了别的样子。这是四个开关里最影响结果可信度的一个。

## 联网搜索

**开着的时候**：智能体可以去查数据源以外的公开信息，抓回来的结果会落成一个数据框参与后续分析，比如拿外部数据做对照。

**为什么默认是关的**：联网搜索需要系统管理员先在系统设置里配好搜索服务。**没配好时这个开关是禁用的**，描述会显示「未配置联网搜索，请联系系统管理员在系统设置中配置」。配好之后，再回到这里打开。

## 关键约束

| 项目         | 值或行为                                        |
| ---------- | ------------------------------------------- |
| 开关位置       | 智能体详情页 → 「配置」 → 「能力配置」                      |
| 生效范围       | 该智能体的所有入口（网页对话、飞书或 Slack 频道、定时任务、嵌入）共用同一份配置 |
| Python 解释器 | 关掉后附件上传被拦，提示当前智能体未开启 Python 分析能力            |
| 图表可视化      | 关掉后只返回表格与文字                                 |
| 用户澄清       | 关掉后由智能体自行假设，并在结论中说明假设                       |
| 联网搜索       | 默认关；管理员未配置时开关禁用                             |

## 出问题怎么判断

| 现象          | 判定条件                   | 处理                          |
| ----------- | ---------------------- | --------------------------- |
| 上传 Excel 被拦 | 提示当前智能体未开启 Python 分析能力 | 打开 Python 解释器，或换一个开了该能力的智能体 |
| 回答里没有图      | 结果只有表格和文字              | 确认图表可视化是开的；也可能是这个问题本身不适合画图  |
| 智能体不问就直接算   | 缺少条件时没有反问，直接给了带假设的结论   | 确认用户澄清开关是开的                 |
| 联网搜索点不动     | 开关置灰，描述提示未配置联网搜索       | 让系统管理员先在系统设置里配好搜索服务         |
| Python 执行报错 | 提示 Python 执行超时，或沙箱已饱和  | 简化代码或缩小数据量；饱和说明并发高，稍后重试     |

## 下一步

- 给它挂上成套的分析方法：[分析技能](https://docs.asktable.com/agent/skill)
- 让它记住你们的指标口径：[业务文档](https://docs.asktable.com/agent/documents)
- 看它每次到底调了什么：[日志与用户反馈](https://docs.asktable.com/agent/logs-feedbacks)