读取文件

使用方式

支持相对路径或绝对路径。文本以 UTF-8 读取，输出达到 2000 行或 50KB 中任一限制时截断，并提示继续读取的位置。图片支持 jpg、png、gif、webp、bmp，以附件形式提供；图片处理可能包含缩放及提示。查看文件应优先使用 read，而非以命令替代常规读取。

在对话中描述需求，由 Agent 决定是否调用。以下是 Agent 工具参数，不是公开 HTTP API。

输入参数

调用示例

读取指定文件的前 100 行；如果还有内容，依据返回提示继续读取。

{
  "tool": "read",
  "arguments": {
    "path": "<目标文件路径>",
    "offset": 1,
    "limit": 100
  }
}

示例仅用于说明结构，不会在浏览此页时执行。

返回结果

文本返回文件内容，必要时附带截断或剩余行数及后续 offset 提示；图片返回图片附件和处理说明。程序化结构化结果为文本字符串，或含 type、data、mimeType、note 的图片对象。

执行范围与限制

• 文本输出最多 2000 行或 50KB，以先达到者为准；读取完整大文件需继续调用。
• offset 超出文件末尾会报错；文件必须存在且可读。
• 当前模型不支持图片输入时，图片不会进入该模型请求，并会给出提示。