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
Luego, necesitas instalar la aplicación Fin GitHub sync para la cuenta que deseas conectar a Fin.
Después, elige la cuenta para la que quieres instalar la aplicación. Ten en cuenta que puede 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é lista en GitHub, la ventana emergente se cerrará y se te pedirá que elijas el repositorio y especifiques una carpeta (si aplica en tu caso) desde la cual deseas sincronizar los archivos Markdown.
(OPCIONAL) También puedes optar por crear/actualizar el archivo CLAUDE.md existente 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 "Administrar acceso al repositorio GitHub en GitHub", lo que abrirá la misma ventana emergente que te permitirá agregar repositorios adicionales a la lista permitida.
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 |
Comprobaciones | Lectura y escritura | Requerido para ejecutar la comprobació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, pero este permiso es obligatorio. |
Solicitudes de extracción | 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 auto-fusión). |
Cómo funciona la sincronización
Cuando conectas tu repositorio inicialmente, 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 obligatorio. 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 añade 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, una lista de las claves y valores Frontmatter actualmente soportados:
Clave | Valores permitidos | Descripción |
título | 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. |
descripción | Cualquier texto | Descripción corta que aparece debajo del título de un artículo en Fin |
publicado / estado |
| Especifica si el artículo se sincroniza como publicado o borrador. Publicado significa que el contenido está activo y disponible en Fin, no que aparezca en tu Help Center. |
public_url | Cualquier URL | Especifica una URL pública a la que se dirigen los clientes cuando Fin cita este contenido como fuente. Si no se proporciona, Fin no citará una fuente para este artículo. Esto no afecta si el artículo aparece en tu Help Center. Los artículos sincronizados siempre están no listados. |
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 Frontmatter son opcionales. Las claves no reconocidas se omiten.
Comprobaciones de PR
Ejecutamos una serie de comprobaciones ligeras en las PR que abres que afectan a los archivos Markdown sincronizados.
Se ejecutan comprobaciones sobre el esquema Frontmatter para asegurar que todas las claves presentes son válidas y compatibles.
Una comprobación fallida se mostrará en la sección de comprobaciones de la pull request, similar a la siguiente.
También puedes hacer clic en la comprobación para obtener más detalles sobre las infracciones detectadas.
Nota: Estas comprobaciones no bloquean. Las PR aún pueden fusionarse aunque las comprobaciones GitSync: Content Validation fallen.
Sin embargo, puedes hacer cumplir estas comprobaciones como se explica en la documentación de GitHub aquí.
Limitaciones conocidas
Los artículos sincronizados están no listados en tu Help Center. No pueden añadirse a un Help Center o a una colección, por lo que los clientes no los encontrarán navegando o buscando en tu Help Center. Fin AI Agent y Copilot aún pueden usarlos una vez que habilites la superficie relevante. Si necesitas que un artículo aparezca en una colección de Help Center, créalo en Intercom en lugar de sincronizarlo desde GitHub. Los artículos sincronizados son de solo lectura en Intercom, y ninguna configuración o campo frontmatter puede hacer que sean navegables o buscables en un Help Center.
Solo sincroniza archivos Markdown (
.md). Los archivos.mdxactualmente no son compatibles.Los artículos sincronizados están deshabilitados para AI Agent/Copilot/Sales Agent por defecto para permitirte revisarlos manualmente antes de publicarlos.
Esta es una sincronización unidireccional, solo de GitHub a Fin. Actualmente los artículos deben editarse en GitHub.
Actualmente los artículos solo se crean en inglés.