La sincronización de contenido de GitHub te permite sincronizar tus archivos Markdown (.md) desde GitHub directamente en Fin.
Primeros pasos
Para conectar tu repositorio de GitHub, ve a Knowledge Hub > Ver todo > Desde GitHub
A continuación, debes instalar la aplicación Fin GitHub sync para la cuenta que deseas conectar a Fin.
Luego, elige la cuenta para la que deseas instalar la aplicación. Ten en cuenta que es posible que necesites la aprobación del administrador de tu organización para instalar la aplicación en una cuenta organizacional.
Una vez que elijas una cuenta, puedes optar por permitir el acceso a todos los repositorios o solo a un subconjunto específico.
Una vez que la configuración esté completa en GitHub, la ventana emergente se cerrará y se te pedirá que elijas el repositorio y especifiques una carpeta (si corresponde) desde la cual deseas sincronizar los archivos Markdown.
(OPCIONAL) También puedes optar por crear/actualizar el archivo existente CLAUDE.md con instrucciones para Claude Code sobre cómo crear/actualizar el contenido sincronizado y usar el esquema Frontmatter.
Cuando termines, haz clic en "Clonar y conectar".
Nota: Si necesitas permitir el acceso a un repositorio diferente al que seleccionaste inicialmente, haz clic en "Manage GitHub repository access on GitHub" que abrirá la misma ventana emergente que te permitirá agregar repositorios adicionales a la lista de permitidos.
Permisos
La aplicación Fin GitHub Sync requiere los siguientes permisos de GitHub:
Permiso | Tipo | ¿Por qué? |
Acceso a metadatos | Solo lectura | Alcance de la aplicación que todas las aplicaciones de GitHub tienen por defecto |
Checks | Lectura y escritura | Requerido para ejecutar la verificación del esquema Frontmatter explicada aquí. |
Código | Lectura y escritura | Requerido para crear/actualizar el archivo CLAUDE.md que da instrucciones a Claude Code sobre cómo formatear los archivos Markdown sincronizados en Fin. Esta es una función opcional que puedes omitir durante la configuración; sin embargo, este permiso es obligatorio. |
Pull requests | Lectura y escritura | Requerido para crear un archivo |
Workflows | Lectura y escritura | Requerido para agregar el flujo de trabajo de GitHub Actions que permite que tu repositorio apruebe y fusione automáticamente las Pull Requests de Sugerencias de Fin (configuración opcional de fusión automática). |
Cómo funciona la sincronización
Cuando conectas inicialmente tu repositorio, Fin sincronizará todos los archivos Markdown presentes.
Cuando se fusiona un cambio en la carpeta/repositorio sincronizado que actualiza los archivos Markdown, aplicaremos estas ediciones automáticamente.
(OPCIONAL) Esquema Frontmatter
Nota: El esquema Frontmatter no es requerido. Si tus archivos Markdown no lo usan, puedes omitir esta sección.
Frontmatter te permite especificar ciertas propiedades adicionales sobre cómo sincronizamos los artículos en Fin desde tus archivos Markdown.
Frontmatter se agrega al inicio de tu archivo Markdown, similar a esto:
---
title: How to request a refund
description: Steps to get a refund on your order
audience: everyone
published: true
fin: enabled
copilot: enabled
sales_agent: disabled
---
Article body goes here…
A continuación hay una lista de claves y valores de Frontmatter actualmente compatibles:
Clave | Valores permitidos | Descripción |
title | Cualquier texto | Especifica el título de tu artículo. Si no está presente, encontraremos el primer H1 o humanizaremos el nombre del archivo Markdown. |
description | Cualquier texto | Descripción corta que aparece debajo del título de un artículo en Fin |
published / state |
| Especifica si el artículo se sincroniza como publicado o en borrador |
public_url | Cualquier URL | Especifica una URL pública a la que deseas que se dirijan los clientes cuando Fin cite este contenido como fuente. Si no se suministra, Fin no citará la fuente (el artículo se trata como no listado). |
service_agent / service |
| Especifica si el artículo es accesible para Fin AI Agent |
copilot |
| Especifica si el artículo es accesible para Fin Copilot |
sales_agent / sales |
| Especifica si el artículo es accesible para Fin Sales Agent |
Nota: Todas las claves y valores de Frontmatter son opcionales. Las claves no reconocidas se omiten.
Verificaciones de PR
Ejecutamos una serie de verificaciones ligeras en los PRs que abras que apunten a los archivos markdown sincronizados.
Las verificaciones se ejecutan sobre el esquema Frontmatter para asegurar que todas las claves presentes sean válidas y compatibles.
Una verificación fallida aparecerá en la sección de verificaciones del pull request, similar a lo siguiente.
También puedes hacer clic en la verificación para obtener más detalles sobre las infracciones detectadas.
Nota: Estas verificaciones no son bloqueantes. Los PRs aún pueden fusionarse incluso si las verificaciones GitSync: Content Validation fallan.
Sin embargo, puedes hacer que estas verificaciones sean obligatorias como se explica en la documentación de GitHub aquí.
Limitaciones conocidas
Solo sincroniza archivos Markdown (
.md). Los archivos.mdxactualmente no son compatibles.Los artículos se sincronizan deshabilitados para AI Agent/Copilot/Sales Agent por defecto para permitirte revisarlos manualmente antes de publicarlos.
Esta es una sincronización unidireccional, de GitHub a Fin. Actualmente, los artículos deben editarse en GitHub.
Los artículos actualmente solo se crean en inglés.