工具 API

query_docs_filesystem_zen_rows_docs

对以`/`为根的虚拟化内存文件系统运行只读的类shell查询，该文件系统仅包含ZenRows Docs文档页面和OpenAPI规范。这不是任何真实机器上的shell——用户的计算机、服务器主机或任何网络上都不会运行任何程序。该文件系统是由文档块支持的沙箱。 读取文档页面的方法：没有单独的"获取页面"工具。要读取页面，请将`.mdx`路径（例如`/quickstart.mdx`、`/api-reference/create-customer.mdx`）传递给`head`或`cat`。要使用精确关键词或正则表达式搜索文档，请使用`rg`。要了解文档结构，请使用`tree`或`ls`。 工作流程：对于"如何认证"或"速率限制"等广泛或概念性查询，请从搜索工具开始。需要精确关键词/正则表达式匹配、结构探索或按路径读取特定页面的完整内容时，请使用此工具。 支持的命令：rg（ripgrep）、grep、find、tree、ls、cat、head、tail、stat、wc、sort、uniq、cut、sed、awk、jq以及基本文本工具。无写入、无网络、无进程控制。运行`--help`查看任何命令的用法。 每次调用都是无状态的：工作目录始终重置为`/`，且shell变量、别名或历史记录不会在调用之间保留。如果需要在子目录中操作，请在一次调用中使用`&&`链接命令或传递绝对路径（例如`cd /api-reference && ls`或`ls /api-reference`）。不要假设一次调用中的`cd`会影响下一次调用。 示例： - `tree / -L 2` — 查看顶级目录布局 - `rg -il "rate limit" /` — 查找所有提及"rate limit"的文件 - `rg -C 3 "apiKey" /api-reference/` — 显示每个匹配项周围3行上下文的匹配 - `head -80 /quickstart.mdx` — 读取特定页面的前80行 - `head -80 /quickstart.mdx /installation.mdx /guides/first-deploy.mdx` — 一次调用读取多个页面 - `cat /api-reference/create-customer.mdx` — 需要全部内容时读取完整页面 - `cat /openapi/spec.json | jq '.paths | keys'` — 列出OpenAPI端点 每次调用输出截断为30KB。优先使用针对大型文件的针对性`rg -C`或`head -N`，而不是宽泛的`cat`。要读取大文件的仅相关部分，请使用`rg -C 3 "pattern" /path/file.mdx`。尽可能将多个文件读取批量合并到单个`head`或`cat`调用中。 在响应中引用页面时，通过移除`.mdx`扩展名将文件系统路径转换为URL路径。例如，`/quickstart.mdx`变为`/quickstart`，`/api-reference/overview.mdx`变为`/api-reference/overview`。