Cortex Code CLI 代理工具

Cortex Code 可访问用于文件操作、Shell 命令、Web 访问等的一整套工具。您无需安装任何额外内容；这些工具内置于 Cortex Code CLI 中，随时可用。Cortex Code 会根据您的请求自动使用相应工具。您无需手动调用；只需描述您的需求即可。 例如：

Read the first 10 lines of the file src/main.py
Search for TODO comments in all Python files
Execute a bash command to list running processes
Copy

创建自定义技能时，必须指定技能可使用的工具。请参阅 Skill。

文件工具

读取

从本地文件系统读取文件内容。支持：

  • 带行号的文本文件

  • 图像 (PNG、 JPG 等) – 可视化显示

  • PDFs - 逐页提取

  • Jupyter Notebooks – 含输出的单元格

  • 行范围：@file.py$10-20

写入

创建或覆盖文件。支持：

  • 自动创建父目录

  • 跟踪会话统计信息的行更改

  • 覆盖现有文件

编辑

在文件中搜索并替换。支持：

  • 精确字符串替换

  • 更改前预览差异

  • 支持使用 replace_all 进行全局替换

Glob

通过模式匹配查找文件。示例：

模式

描述

**/*.py

所有 Python 文件

src/**/*.ts

TypeScript 文件位于 src/ 目录中

**/test_*.py

Python 测试文件

!node_modules

排除模式

Grep

使用正则表达式搜索文件内容。支持：

  • 递归搜索

  • 正则表达式模式

  • 二进制文件检测

  • 输出模式：内容、文件、计数

Shell 工具

Bash

执行 Shell 命令。支持：

  • 流式输出

  • 后台执行 (run_in_background)

  • 超时控制（默认 2 分钟，最大 10 分钟）

  • 沙盒运行时支持

BashOutput

获取后台 Shell 进程的输出。

  • 按正则表达式筛选输出

  • 状态检查

  • 与 run_in_background 结合使用

KillShell

终止正在运行的后台 Shell。

代理工具

RunSubagent

为特定任务启动子代理。类型包括：

  • 通用型：可使用所有工具，适合研究类任务

  • 探索型：快速浏览代码库

  • 规划型：架构设计与计划

  • 自定义代理：位于 .cortex/agents/ 下

有关详细信息，请参阅 Subagent。

AskUserQuestion

执行期间提示用户输入。支持：

  • 多项选择题

  • 自由格式输入

  • 多选选项

审查

启动审查子代理以保证质量。

Web 工具

WebSearch

使用多个引擎搜索 Web。支持：

  • 后备搜索引擎

  • 代码段提取

  • 结果缓存

  • 30 秒超时

备注

WebSearch 需要在 Snowsight 的 Cortex Code 设置中启用 Web 搜索。请参阅 Web 搜索。

WebFetch

从 Web 检索内容 URLs。支持：

  • HTML 到文本转换

  • 内容提取

  • 最多 10,000 个字符

  • 30 秒超时

Snowflake 工具

SnowflakeSqlExecute

在 Snowflake 中执行 SQL 查询。支持：

  • 权限检查

  • 结果缓存

  • 令牌刷新

  • 大型结果卸载

SnowflakeObjectSearch

数据库对象语义搜索

搜索

表、视图、架构、数据库、函数

返回

名称、列、描述

SnowflakeProductDocs

搜索 Snowflake 文档。支持的类别：

  • 用户指南

  • SQL 参考

  • 开发者指南

  • Cortex Code 主题

ReflectSemanticModel

验证 Cortex Analyst 语义模型。验证暂存区：

  • 文件存在

  • YAML 语法

  • 架构验证

  • 服务器端验证

SnowflakeMultiCortexAnalyst

执行 Cortex Analyst 查询。支持：

  • 自然语言到 SQL

  • 语义模型支持

  • 验证查询检索

数据工具

DataDiff

比较数据库/表之间的数据。支持：

  • Snowflake 连接处理

  • 账户标识符派生

  • 300 秒超时

NotebookExecute

执行 Jupyter Notebook。支持：

  • 超时控制

  • 内核管理

  • 参数注入

  • 自定义 Python 环境

NotebookEdit

编辑 Jupyter Notebook 单元格。支持的模式：

  • replace：替换单元格内容

  • insert：添加新单元格

  • delete：移除单元格

计划模式工具

EnterPlanMode

复杂任务的请求计划模式。支持：

  • 用户审批工作流程

  • 自动调用多步骤任务

ExitPlanMode

向用户提供计划并退出计划模式。支持：

  • 计划确认

  • 流控制

内存工具

内存

跨会话存储与检索信息。支持的命令：

  • view：查看存储的内存

  • create：存储新内存

  • str_replace：更新内存

  • insert：添加到内存

  • delete：移除内存

  • rename：重命名内存文件

备注

必须通过设置 CORTEX_ENABLE_MEMORY 环境变量启用内存工具。

权限级别

工具具有不同权限要求：

级别

工具

行为

安全

读取、Glob、Grep

自动批准

低

写入（新文件）

通常自动批准

中

编辑、Bash（安全）

确认模式下的提示

高

Bash（有风险）、SQL 写

始终提示

关键

rm -rf、sudo

额外确认

请参阅 安全性 了解详细信息。