File

File es el componente de GitHub que trabaja con los archivos de un repositorio: leer el contenido de un archivo, ver qué archivos hay en una carpeta, crear un archivo nuevo o cambiar uno que ya existe. Cada cambio queda guardado en GitHub como un cambio confirmado (commit) con el mensaje que tú indiques.

Es útil cuando el contenido de un archivo nace o se usa en otro proceso: un informe que un agente redacta y quieres guardar en el repositorio, un archivo de configuración que otro paso del flujo necesita leer o documentación que quieres mantener al día de forma automática.

Cuándo usarlo

Un agente de IA redacta las notas de una reunión y quieres guardarlas como archivo en el repositorio del proyecto.
Un flujo necesita leer un archivo de configuración o de datos guardado en GitHub antes de seguir.
Quieres revisar cada semana qué archivos hay en una carpeta de documentación.
Quieres actualizar un archivo de texto, como un registro de cambios, cada vez que ocurre algo en otro sistema.

Configuración

Necesitas una credencial GitHub API con un token de acceso personal de GitHub (Personal Access Token) con permiso sobre el repositorio. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial GitHub API con la que se accede a tu cuenta.
Repository Input Type	Cómo indicas el repositorio. `Select` lo eliges de una lista; `Manual` lo escribes. Por defecto, `Select`.
Repository	Con `Select`. El repositorio con el que trabajar. La lista se carga al elegir la credencial y muestra hasta 100 repositorios de tu cuenta; si el tuyo no aparece, usa `Manual`.
Repository ID	Con `Manual`. El repositorio en el formato `dueño/repositorio`, por ejemplo `mi-empresa/web`. También acepta el enlace del repositorio en GitHub.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, `Get`.
File Path (obligatorio)	La ruta del archivo dentro del repositorio, sin barra al principio, por ejemplo `docs/notas.md`. Se usa en todas las operaciones salvo `List Files`.
File Content (obligatorio)	Solo en `Create` y `Edit`. El contenido del archivo. Puedes escribirlo o conectarlo desde otro componente, por ejemplo la respuesta de un agente.
Commit Message (obligatorio)	Solo en `Create` y `Edit`. El mensaje que acompaña al cambio en el historial del repositorio.

Operaciones

Operación	Qué hace
`Get`	Trae el contenido de un archivo de texto.
`List Files`	Lista los archivos y carpetas de una carpeta del repositorio.
`Create`	Crea un archivo nuevo. Si ya existe un archivo en esa ruta, lo sustituye por el contenido nuevo.
`Edit`	Sustituye el contenido de un archivo que ya existe.

Opciones avanzadas

Campo	Qué hace
Branch	La rama del repositorio en la que se lee o escribe. Por defecto, `main`. Si tu repositorio usa otra rama principal, por ejemplo `master`, cámbialo.
Directory Path	Solo en `List Files`. La carpeta que quieres listar, por ejemplo `docs`. Déjalo vacío para la carpeta principal del repositorio.
Limit	Solo en `List Files`. Cuántos elementos traer como máximo, hasta 1000. Por defecto, 100.

Resultado

La salida Data depende de la operación:

Get: la ruta del archivo y su contenido como texto.
List Files: un elemento por cada archivo o carpeta, con su nombre, su ruta, si es archivo o carpeta, su tamaño, su enlace en GitHub y, en los archivos, el enlace de descarga.
Create y Edit: una confirmación con la ruta y la rama. En Create indica si el archivo se creó o si se sustituyó uno existente.

Puedes conectar el contenido leído a un agente para que lo analice, o la lista de archivos a una hoja de cálculo. El componente también se puede conectar a un Agente como herramienta, para que el agente decida qué archivos leer o escribir. Ver Tool Mode.

Ejemplo

Un equipo quiere guardar en GitHub el resumen de cada reunión semanal.

Un agente redacta el resumen a partir de las notas de la reunión.
Añade File con la operación Create y elige el repositorio del equipo en Repository.
En File Path escribe reuniones/ seguido de la fecha y .md, por ejemplo reuniones/2026-10-05.md.
Conecta la respuesta del agente a File Content y escribe en Commit Message Resumen de la reunión semanal.

Buenas prácticas

Usa Get solo con archivos de texto, como documentos, notas o archivos de configuración. Imágenes y otros archivos que no son texto no se pueden leer como contenido.
Comprueba Branch antes de escribir: los cambios se guardan en esa rama.
Como Create sustituye el archivo si ya existe, revisa bien la ruta para no reemplazar un archivo por error.

Componentes relacionados

Repository: lista los repositorios de tu cuenta.
Issue: gestionar las issues de un repositorio.
Release: gestionar las versiones publicadas.
Review: trabajar con pull requests y sus revisiones.