La synchronisation de contenu GitHub vous permet de synchroniser des fichiers Markdown (.md) d’un dépôt GitHub dans Fin, afin que Fin et Copilot puissent les utiliser.
Commencer
Allez dans Former > Contenu, cliquez sur Voir tout, puis choisissez Depuis GitHub.
Installez l’application Fin GitHub sync pour le compte GitHub que vous souhaitez connecter. Vous pourriez avoir besoin de l’approbation de l’administrateur de votre organisation pour installer l’application sur un compte organisation.
Choisissez si l’application peut accéder à tous les dépôts ou seulement à certains.
Une fois la configuration GitHub terminée, la fenêtre pop-up se ferme. Sélectionnez le dépôt, et un dossier si nécessaire, depuis lequel vous souhaitez synchroniser les fichiers Markdown.
(Optionnel) Choisissez de créer ou mettre à jour un fichier
CLAUDE.mdavec des instructions pour Claude Code sur la création et la mise à jour du contenu synchronisé et l’utilisation du schéma Frontmatter.Cliquez sur Cloner et connecter.
Note : Pour donner accès à un autre dépôt plus tard, cliquez sur Gérer l’accès au dépôt GitHub sur GitHub. Cela ouvre la même fenêtre pop-up, où vous pouvez ajouter des dépôts à la liste d’autorisation.
Autorisations
L’application Fin GitHub sync nécessite ces autorisations GitHub :
Métadonnées (lecture seule) : La portée par défaut de toute application GitHub.
Vérifications (lecture et écriture) : Exécute les vérifications du schéma Frontmatter décrites dans vérifications PR ci-dessous.
Code (lecture et écriture) : Crée ou met à jour le fichier
CLAUDE.md. La création du fichier est optionnelle, mais l’autorisation est requise.Pull requests (lecture et écriture) : Crée le fichier
CLAUDE.mdet reçoit les webhooks qui synchronisent les modifications vers Fin et exécutent les vérifications PR.Workflows (lecture et écriture) : Ajoute le workflow GitHub Actions qui permet à votre dépôt d’approuver automatiquement et de fusionner les pull requests de suggestion de Fin (configuration de fusion automatique optionnelle).
Comment fonctionne la synchronisation
Lorsque vous connectez votre dépôt pour la première fois, Fin synchronise tous les fichiers Markdown qu’il contient, ou dans le dossier que vous avez choisi. Ensuite, lorsqu’une modification de ces fichiers Markdown est fusionnée, Fin applique automatiquement les modifications.
(Optionnel) Schéma Frontmatter
Le Frontmatter n’est pas obligatoire. Si vos fichiers Markdown ne l’utilisent pas déjà, vous pouvez passer cette section. Le Frontmatter vous permet de définir des propriétés supplémentaires pour la synchronisation de chaque fichier dans Fin. Ajoutez-le en haut de votre fichier Markdown, comme ceci :
---
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…
Clés et valeurs prises en charge :
title (texte quelconque) : Le titre de l’article. S’il manque, Fin utilise le premier H1, ou une version lisible du nom du fichier.
description (texte quelconque) : Une courte description affichée sous le titre de l’article.
published ou state (
published,true,draftoufalse) : Indique si l’article est synchronisé comme publié ou comme brouillon. Publié signifie que le contenu est en ligne et disponible pour Fin.public_url (URL quelconque) : L’URL publique vers laquelle les clients sont envoyés lorsque Fin cite ce contenu. Sans elle, Fin ne cite pas de source pour l’article.
service_agent ou service (
enabledoudisabled) : Indique si Fin peut utiliser l’article.copilot (
enabledoudisabled) : Indique si Copilot peut utiliser l’article.sales_agent ou sales (
enabledoudisabled) : Indique si Sales Agent peut utiliser l’article.
Toutes les clés et valeurs Frontmatter sont optionnelles. Les clés non reconnues sont ignorées.
Vérifications PR
Fin effectue des vérifications légères sur les pull requests qui modifient vos fichiers Markdown synchronisés. Elles vérifient que chaque clé Frontmatter est valide et prise en charge. Une vérification échouée s’affiche dans la section vérifications de la pull request, et vous pouvez cliquer dessus pour plus de détails.
Note : Ces vérifications ne bloquent pas la fusion. Les pull requests peuvent toujours être fusionnées si les vérifications GitSync : Validation du contenu échouent. Pour les appliquer, consultez le guide GitHub sur l’exigence des vérifications d’état avant fusion.
Limitations connues
Seuls les fichiers Markdown (
.md) sont synchronisés. Les fichiers.mdxne sont pas encore pris en charge.Les articles synchronisés sont désactivés par défaut pour Fin, Copilot et Sales Agent, afin que vous puissiez les examiner avant de les publier.
Il s’agit d’une synchronisation unidirectionnelle de GitHub vers Fin. Les articles synchronisés sont en lecture seule dans Fin et doivent être modifiés dans GitHub.
Les articles sont actuellement créés uniquement en anglais.
