File Tools
file_tools 是一个 Fetch Hive 系统 MCP 工具,会自动添加到每个智能体。它无法被禁用或移除。仅当当前回合带有文档附件、历史文件上下文,或要求生成/导出文件时,Fetch Hive 才会将面向提供商的文件工具附加到运行中。
上传的 CSV、XLSX、PDF、DOCX、文本和 Markdown 附件会以 <available_files> 清单的形式向智能体公开。智能体应在依赖文档内容之前调用 read_file。read_file 只能访问作为结构化附件在当前请求或对话历史中提供的 URL。
公开 API 调用方可以将附件作为 HTTPS URL 字符串传递,或作为带有 file_url、file_name 和 file_type 的对象传递。对于大多数调用,URL 字符串就足够了;在可能时,Fetch Hive 会从 URL 推断元数据,且没有扩展名的上传 URL 仍会被加入 read_file 的允许列表。
当当前回合要求生成或导出文件时,智能体可以调用 write_file 来创建 PDF、DOCX 或 XLSX 文件。对于 PDF 和 DOCX 文件,建议使用 markdown 内容,这样可以保留常见的文档结构,例如标题、段落、列表、强调、代码块、引用块、水平分隔线和简单表格。生成的文件通过 Rails 上传,作为账户资产存储,并作为公开资产 URL 返回。文件工具调用会在追踪和完成中以 read_file 和 write_file 来源被记录。