5. 工具调用、流式与内联图
智能体回答时不是只输出文字——它会调用工具(跑 Python、读写文件、查注册表等),这些都内联展示在对话流里。
5.1 步骤块
每次工具调用渲染成一个可折叠的步骤(step)块:
- 摘要行(如
› Ran 1 command、› 1 个工具)显示干了几件事,点开可展开细节。 - 展开后是工具名(青色)+ 参数(灰色)+ 结果代码块。
- 正在执行时结果区会实时流式输出(等宽字体,可滚动)。
截图待补:展开的工具步骤块(工具名 + 参数 + run_python_code 的流式输出)。
5.2 内联图表
当分析生成 matplotlib / scanpy 图(如 UMAP、QC 小提琴图)时,图片会直接内联显示在对应工具步骤下方,无需切走。下图是让智能体"加载 pbmc3k → 预处理 → UMAP → Leiden 聚类 → 画图"后,对话里直接呈现的聚类分布表与 UMAP 图:

生成的图同时落进工作区文件,可在第 8 章里再打开;产生的 adata 等对象则进入 kernel,可在第 7 章变量检查器里交互查看。
5.3 权限与审批
工具执行受权限模式控制(输入区的「完全权限」胶囊)。在需要审批的模式下,执行类工具(run_python_code / shell / 文件写入)会先弹出审批卡,让你选择:
- 允许一次(Allow once) / 本次会话都允许(Allow for session) / 拒绝(Deny);
- 卡片按风险级别配色,可展开查看将要执行的参数。
此外还有两类内联卡:
- 计划审批卡(Plan):智能体写好多步计划后请你 Approve & execute 或 Reject。
- 复核卡(Notify / Review):智能体在关键节点用
notify_user中断,列出待复核内容,你确认后点「继续」。
截图待补:工具审批卡(Allow once / Allow for session / Deny)。
5.4 付费技能占位
如果某个技能属于更高订阅档位,而你的账户档位不够,对话里会出现一个锁定占位(🔒 Pro skill content hidden),提示需要升级才能查看该技能内容(见第 11 章)。
下一步:内核与运行时监控。