File Tools
file_tools es una herramienta MCP del sistema de Fetch Hive que se agrega automáticamente a cada agente. No se puede deshabilitar ni eliminar. Fetch Hive adjunta read_file cuando el turno tiene archivos adjuntos de documentos o contexto de archivos del historial, y write_file cuando el turno pide generar o exportar un archivo. save_artifact y load_artifact se adjuntan siempre que File Tools esté disponible en la ejecución, para que los agentes puedan guardar y volver a cargar resultados estructurados grandes sin pegar miles de filas en la conversación.
Los archivos adjuntos cargados de CSV, XLSX, PDF, DOCX, texto y Markdown se exponen al agente como un manifiesto <available_files>. El agente debe llamar a read_file antes de basarse en el contenido del documento. read_file solo puede acceder a URLs que se proporcionaron como archivos adjuntos estructurados en la solicitud actual o en el historial de conversación.
Los llamadores de la API pública pueden pasar archivos adjuntos como cadenas de
URL HTTPS o como objetos con file_url, file_name y file_type. Las cadenas
de URL son suficientes para la mayoría de las llamadas; Fetch Hive infiere los
metadatos a partir de la URL cuando puede.
Cuando el turno actual solicita generar o exportar un archivo, los agentes pueden llamar a write_file para crear archivos PDF, DOCX, XLSX o CSV. Para archivos PDF y DOCX, se recomienda contenido en markdown que preserva la estructura común del documento, como encabezados, párrafos, listas, énfasis, bloques de código, citas, líneas horizontales y tablas simples. Para CSV, proporciona contenido tabular en CSV o JSON (input_format csv o json; JSON usa una sola hoja). Los archivos generados se almacenan como activos del workspace y se devuelven con un file_url de duración limitada (más file_url_expires_at e id del activo). Usa el id del activo con la API de assets si necesitas una URL de descarga nueva más tarde.
Para resultados tabulares grandes, los agentes deben llamar a save_artifact con contenido jsonl, csv o json. La herramienta devuelve un identificador corto más el esquema y el recuento de filas. Los turnos posteriores (o pasos posteriores del mismo turno) llaman a load_artifact con ese identificador y un limit para leer solo el fragmento necesario. Las llamadas a herramientas de archivo se registran en las trazas y finalizaciones como fuentes read_file, write_file, save_artifact y load_artifact.