配置与管理
能力开关详解
配置 Python、图表、用户澄清和联网搜索能力。
「配置」标签页里的「能力配置」有四个开关，它们决定智能体在回答时能调用哪些工具。四个都是独立开关，可以只开需要的。
| 开关 | 界面上的描述 | 默认 |
|---|---|---|
| Python 解释器 | 数据变换、统计分析等 SQL 难以表达的操作 | 开 |
| 图表可视化 | 为查询结果创建可视化图表 | 开 |
| 用户澄清 | 允许智能体向用户提问确认 | 开 |
| 联网搜索 | 查询数据源外的公开信息，结果落为数据框 | 关 |
Python 解释器
开着的时候：智能体能执行 Python 代码，用于 SQL 表达起来很别扭的事——数据清洗、统计检验、构造中间结果。同时也允许用户上传 Excel / CSV 附件参与分析。
关掉会怎样：只剩只读 SQL。用户尝试上传附件时会被拦下，提示当前智能体未开启 Python 分析能力。
在哪里跑：代码不在服务器主进程里跑，而是交给独立的 Atbox 沙箱（Go 服务 + CPython）执行。每次执行起一个全新进程、用完即弃，并施加 chroot、no_new_privs、seccomp 和降权 UID 等隔离，跑在 Linux 上才生效。执行有超时上限，并发打满时会明确返回「沙箱已饱和」而不是排队静等。机制细节见 AskTable 如何工作。
图表可视化
开着的时候：智能体会为查询结果自动挑图——时间趋势用折线、类别对比用柱状、占比用饼图、两量关系用散点。
关掉会怎样：只返回数据表格和文字结论，不做图。适合只关心数字、不想被图表干扰的场景，也能省一点生成时间。
用户澄清
开着的时候（推荐）：问题缺少关键条件时——比如没说时间范围、没说按什么粒度、没说要不要剔除退款——智能体先反问你，并给出可点选的选项，而不是自己猜一个然后闷头算。
关掉会怎样：智能体按已有语义和上下文做合理假设，直接把答案算出来，并在结论里说明它假设了什么。
这个开关是准确率的关键：关掉它不代表答案会错，但你会更难发现口径被假设成了别的样子。除非明确知道自己在问什么、且不想被打断，否则保持开启。
建议保持开启
关掉用户澄清不会让答案立刻出错，但你会更难发现口径被换成了别的样子。这是四个开关里最影响结果可信度的一个。
联网搜索
开着的时候：智能体可以去查数据源以外的公开信息，抓回来的结果会落成一个数据框参与后续分析，比如拿外部数据做对照。
为什么默认是关的：联网搜索需要系统管理员先在系统设置里配好搜索服务。没配好时这个开关是禁用的，描述会显示「未配置联网搜索，请联系系统管理员在系统设置中配置」。配好之后，再回到这里打开。
关键约束
| 项目 | 值或行为 |
|---|---|
| 开关位置 | 智能体详情页 → 「配置」 → 「能力配置」 |
| 生效范围 | 该智能体的所有入口（网页对话、飞书或 Slack 频道、定时任务、嵌入）共用同一份配置 |
| Python 解释器 | 关掉后附件上传被拦，提示当前智能体未开启 Python 分析能力 |
| 图表可视化 | 关掉后只返回表格与文字 |
| 用户澄清 | 关掉后由智能体自行假设，并在结论中说明假设 |
| 联网搜索 | 默认关；管理员未配置时开关禁用 |
出问题怎么判断
| 现象 | 判定条件 | 处理 |
|---|---|---|
| 上传 Excel 被拦 | 提示当前智能体未开启 Python 分析能力 | 打开 Python 解释器，或换一个开了该能力的智能体 |
| 回答里没有图 | 结果只有表格和文字 | 确认图表可视化是开的；也可能是这个问题本身不适合画图 |
| 智能体不问就直接算 | 缺少条件时没有反问，直接给了带假设的结论 | 确认用户澄清开关是开的 |
| 联网搜索点不动 | 开关置灰，描述提示未配置联网搜索 | 让系统管理员先在系统设置里配好搜索服务 |
| Python 执行报错 | 提示 Python 执行超时，或沙箱已饱和 | 简化代码或缩小数据量；饱和说明并发高，稍后重试 |