> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# File tools

# 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`.

## Artefactos reutilizables

En un chat guardado de Hive Agents, los archivos subidos y generados siguen disponibles en **Usar de este chat**, incluso después de resumir mensajes anteriores. Al elegir uno se reutiliza el Asset existente sin volver a subirlo. El contenido se lee solo cuando el agente lo necesita.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.