agent 必须通过 agentspace 项目空间访问文件：先确认文件已同步至约定目录并显示“已同步”，再用内部路径如/brief/product_spec_v3.pdf 调用 read_file 工具，支持整读、分段（offset/limit）或按行（lines）读取，最后通过返回标识、字段比对及执行日志验证结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 AgentSpace 中让 Agent 正确读取项目文件，必须先确保文件已进入 Agent 可访问的受控空间，而非散落在本地路径或聊天附件中。
确认文件已同步至 AgentSpace 项目空间
打开 AgentSpace 控制台 → 进入目标项目（如“新品发布项目”）→ 检查左侧目录树是否包含 Brief、Research、Raw Assets 等约定目录 → 点击对应目录，确认所需文件（如 product_spec_v3.pdf、user_interviews.md）已显示在文件列表中，且状态为“已同步”。【未出现在目录树中的本地文件，Agent 完全不可见】
若文件仍显示为“待上传”或根本未列出，需通过网页端拖拽上传，或使用 ADrive CLI 执行 adrive sync --project "新品发布项目" --path ./local/brief/。
在指令中明确指定文件路径与上下文
向 Agent 发送指令时，必须使用 AgentSpace 内部路径，格式为 /目录名/文件名，例如：“请读取 /Brief/product_spec_v3.pdf 并提取核心参数”。
不能写成 “读取我电脑桌面上的 product_spec.pdf” 或 “查看刚才发的附件”，这类描述会导致 Agent 无法定位资源。Agent 不具备访问用户本地文件系统的能力，所有路径都以项目根目录为起点。
如果文件在子目录中，路径必须完整，例如 /Research/interviews/q3_summary.docx —— 缺少任何一级都会触发“文件未找到”错误。
调用 read_file 工具并控制读取范围
AgentSpace 后端默认启用 DeepAgents 文件工具集，其中 read_file 支持精确控制：
方法一：整份读取
直接调用 read_file("/Brief/product_spec_v3.pdf")，适用于小于 2MB 的文本类 PDF 或纯文本文件。
方法二：分段读取（推荐处理大文件）
使用 offset 和 limit 参数，例如 read_file("/Raw Assets/log_202608.log", offset=10000, limit=2000)，跳过前 10000 字节，只读后续 2000 字符。这能避免上下文溢出，也防止模型被无关日志头信息干扰。
方法三：按行号读取（适合代码或结构化配置）
调用 read_file("/Production/config.yaml", lines="5-12")，精准获取第 5 至第 12 行。该语法仅对支持行索引的后端生效，【若返回“lines 参数不支持”，说明当前 backend 未启用行号解析】。
验证读取结果是否可用
第一步：检查 Agent 返回内容是否含明确文件标识，例如开头出现 “文件 /Brief/product_spec_v3.pdf 内容如下：”；
第二步：比对关键字段是否与原始文件一致，比如产品型号、版本号、修改时间；
第三步：若内容为空或报错，立即查看 AgentSpace 控制台右上角的「执行日志」Tab，筛选类型为 file/read，确认 error 字段提示是权限拒绝、路径不存在，还是解析失败（如 PDF 无文本层）。
这一步操作起来很简单，直接点开日志就能看到工具调用的真实输入与返回。
