# 工具参考

> Agent 可调用的全部工具，由固定提交中图表的 @Tool 注册表生成。

Source: https://kcq.nebutra.com/zh/docs/agent/tools


<Callout>
  由固定提交的图表源码生成（

  [`1aa5e22`](https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/foundation/agent/chartToolRegistry.ts)

  ）。工具说明保留模型实际收到的英文原文，不做翻译。
</Callout>

Agent 通过 **29 个工具**操作图表：18 个会修改图表，11 个只读。图表工具就是标注了 `@Tool` 的普通图表方法，Agent 与界面调用同一份代码。只读会话只会拿到只读工具。

运行时，浏览器注册表会把当前可用的 `sourceId` 与 `paneId` 追加到行情、对比和画线工具的说明末尾，模型只能选择真实存在的值。

| 工具                                                                                                            | 名称                            | 权限   | 分组    |
| ------------------------------------------------------------------------------------------------------------- | ----------------------------- | ---- | ----- |
| [<code>panes\_list</code>](/zh/docs/agent/tools/panes#panes_list)                                             | List panes                    | 只读   | 窗格    |
| [<code>pane\_create</code>](/zh/docs/agent/tools/panes#pane_create)                                           | Create pane                   | 修改图表 | 窗格    |
| [<code>pane\_update</code>](/zh/docs/agent/tools/panes#pane_update)                                           | Update pane                   | 修改图表 | 窗格    |
| [<code>pane\_remove</code>](/zh/docs/agent/tools/panes#pane_remove)                                           | Remove pane                   | 修改图表 | 窗格    |
| [<code>pane\_move</code>](/zh/docs/agent/tools/panes#pane_move)                                               | Move pane                     | 修改图表 | 窗格    |
| [<code>pane\_replace\_content</code>](/zh/docs/agent/tools/panes#pane_replace_content)                        | Replace pane content          | 修改图表 | 窗格    |
| [<code>pane\_update\_content</code>](/zh/docs/agent/tools/panes#pane_update_content)                          | Update pane content           | 修改图表 | 窗格    |
| [<code>panes\_clear</code>](/zh/docs/agent/tools/panes#panes_clear)                                           | Clear panes                   | 修改图表 | 窗格    |
| [<code>drawings\_list</code>](/zh/docs/agent/tools/drawings#drawings_list)                                    | List drawings                 | 只读   | 画线    |
| [<code>drawing\_create</code>](/zh/docs/agent/tools/drawings#drawing_create)                                  | Create drawing                | 修改图表 | 画线    |
| [<code>drawings\_copy</code>](/zh/docs/agent/tools/drawings#drawings_copy)                                    | Copy drawings                 | 修改图表 | 画线    |
| [<code>drawing\_update</code>](/zh/docs/agent/tools/drawings#drawing_update)                                  | Update drawing                | 修改图表 | 画线    |
| [<code>drawing\_delete</code>](/zh/docs/agent/tools/drawings#drawing_delete)                                  | Delete drawing                | 修改图表 | 画线    |
| [<code>drawings\_clear</code>](/zh/docs/agent/tools/drawings#drawings_clear)                                  | Clear drawings                | 修改图表 | 画线    |
| [<code>comparisons\_list</code>](/zh/docs/agent/tools/comparisons#comparisons_list)                           | List comparison symbols       | 只读   | 对比    |
| [<code>comparison\_create</code>](/zh/docs/agent/tools/comparisons#comparison_create)                         | Add comparison symbol         | 修改图表 | 对比    |
| [<code>comparison\_remove</code>](/zh/docs/agent/tools/comparisons#comparison_remove)                         | Remove comparison symbol      | 修改图表 | 对比    |
| [<code>comparisons\_clear</code>](/zh/docs/agent/tools/comparisons#comparisons_clear)                         | Clear comparison symbols      | 修改图表 | 对比    |
| [<code>settings\_get</code>](/zh/docs/agent/tools/settings#settings_get)                                      | Get chart settings            | 只读   | 设置    |
| [<code>settings\_update</code>](/zh/docs/agent/tools/settings#settings_update)                                | Update chart settings         | 修改图表 | 设置    |
| [<code>settings\_reset</code>](/zh/docs/agent/tools/settings#settings_reset)                                  | Reset chart settings          | 修改图表 | 设置    |
| [<code>instruments\_query\_name</code>](/zh/docs/agent/tools/market-data#instruments_query_name)              | Query instrument name         | 只读   | 行情数据  |
| [<code>market\_bars\_query</code>](/zh/docs/agent/tools/market-data#market_bars_query)                        | Query market bars             | 只读   | 行情数据  |
| [<code>market\_timeshare\_query</code>](/zh/docs/agent/tools/market-data#market_timeshare_query)              | Query market time share       | 只读   | 行情数据  |
| [<code>market\_timeshare\_range\_query</code>](/zh/docs/agent/tools/market-data#market_timeshare_range_query) | Query market time-share range | 只读   | 行情数据  |
| [<code>indicators\_query</code>](/zh/docs/agent/tools/indicators#indicators_query)                            | Query indicator               | 只读   | 指标    |
| [<code>web\_search</code>](/zh/docs/agent/tools/conversation#web_search)                                      | Web search                    | 只读   | 对话    |
| [<code>ask\_user</code>](/zh/docs/agent/tools/conversation#ask_user)                                          | Ask question                  | 只读   | 对话    |
| [<code>code\_interpreter</code>](/zh/docs/agent/tools/code-interpreter#code_interpreter)                      | Run Python                    | 修改图表 | 代码解释器 |

<Cards>
  <Card title="窗格" href="/zh/docs/agent/tools/panes" description="创建、排列和填充指标窗格。" />

  <Card title="画线" href="/zh/docs/agent/tools/drawings" description="读取、创建、复制、修改和删除图表上的画线。" />

  <Card title="对比" href="/zh/docs/agent/tools/comparisons" description="在主图上叠加其他品种。" />

  <Card title="设置" href="/zh/docs/agent/tools/settings" description="读取、修改和重置图表设置。" />

  <Card title="行情数据" href="/zh/docs/agent/tools/market-data" description="查询品种、K 线和分时数据，不改变图表。" />

  <Card title="指标" href="/zh/docs/agent/tools/indicators" description="在已加载数据上计算已注册的指标。" />

  <Card title="对话" href="/zh/docs/agent/tools/conversation" description="请用户做选择，以及联网搜索。" />

  <Card title="代码解释器" href="/zh/docs/agent/tools/code-interpreter" description="在沙箱中运行 Python，仅在宿主显式启用时注册。" />
</Cards>
