Dépannage

La page et le plugin

Ce que tu vois	Quoi faire
Les ressources IA sont désactivées par l'administrateur	Le plugin est éteint. Un administrateur l'allume dans Administration › Plugins : voir Allumer les ressources IA.
Aucune ressource IA pour l'instant	Aucun dépôt n'est publié, ou aucun n'a encore été lu. Ajoute les annotations : voir Publier tes ressources IA. Sur cette page, Copier l'exemple copie un catalog-info.yaml pour partir de quelque chose.
Aucun résultat parmi 9 ressources (1 critère actif).	La recherche ou un filtre ne garde rien. Clique sur Retirer les filtres.
La recherche n'a pas répondu.	Clique sur Réessayer. Si ça dure, préviens ton administrateur.
Les valeurs de ce filtre n'ont pas pu être chargées.	Recharge la page dans un instant.
50 sur 120 ressources affichées : affinez la recherche ou les filtres.	La page montre les 50 premières ressources. Tape un mot dans Chercher une ressource IA ou choisis un filtre.
Ressource IA introuvable.	La ressource n'est pas (ou plus) dans le catalogue. Reviens sur Ressources IA et cherche à nouveau.

L'onglet Ressources IA d'un dépôt

Chaque message ci-dessous apparaît sous Problèmes sur l'onglet Ressources IA du composant, et sur l'onglet Dépôts de Administration › Ressources IA.

Ce que tu vois	Quoi faire
Annotation inconnue astrolabe.forgeit.tech/ai-skill-path. Vouliez-vous dire astrolabe.forgeit.tech/ai-skills-path ?	Le nom de l'annotation est mal écrit. Prends le nom qu'elle propose.
Annotation inconnue astrolabe.forgeit.tech/ai-tools-path : Astrolabe lit ai-skills-path, ai-agents-path, ai-rules-path, ai-runbooks-path.	Prends un des quatre noms.
Le dossier playbooks (annotation astrolabe.forgeit.tech/ai-runbooks-path) n'existe pas sur la branche par défaut.	Le chemin est faux, ou le dossier n'est pas encore poussé sur la branche par défaut. Corrige la valeur de l'annotation, ou pousse le dossier.
0 skill reconnu dans skills : un skill est un dossier qui contient un SKILL.md.	Le chemin ne contient aucun skill. Vérifie le chemin et que chaque dossier de skill contient un SKILL.md.
0 agent reconnu dans agents : un agent est un fichier Markdown avec un name et une description.	Ajoute name et description à l'en-tête de chaque fichier d'agent.
0 fichier d'instructions reconnu dans rules : sont reconnus AGENTS.md, CLAUDE.md, GEMINI.md, *.mdc, *.instructions.md, copilot-instructions.md et .claude/rules/*.md.	Fais pointer ai-rules-path vers un de ces fichiers ou vers le dossier qui les contient.
0 runbook reconnu dans runbooks : un runbook est un fichier Markdown.	Mets un fichier .md dans le dossier, ou corrige le chemin.
rules/pdf/SKILL.md est un skill : ajoutez son dossier rules/pdf à astrolabe.forgeit.tech/ai-skills-path.	Un fichier trouvé sous une autre sorte. Fais ce que dit le message. Le même message existe pour un agent ou une règle : ajoute-le à l'annotation que le message nomme.
Le frontmatter de agents/broken.md est invalide à la ligne 3 : le bloc YAML entre les deux lignes --- en haut du fichier ne se lit pas. Regardez cette ligne : un crochet ou un guillemet non fermé en est la cause habituelle.	Ouvre le fichier, va à la ligne nommée, et ferme le crochet ou le guillemet.
Ce dépôt n'a pas de propriétaire (spec.owner) : rien n'est publié.	Ajoute spec.owner au catalog-info.yaml, par exemple group:default/platform-team.
Ce dépôt n'a pas d'annotation backstage.io/source-location : Astrolabe ne peut pas le lire.	Enregistre le dépôt depuis son URL : voir Enregistrer un composant.
Seuls les emplacements url: peuvent être lus.	L'emplacement du composant n'est pas un emplacement url:. Enregistre-le à nouveau depuis son URL.
L'annotation backstage.io/source-location de ce dépôt pointe hors du dépôt d'où il a été enregistré : Astrolabe ne lit un composant que dans son propre dépôt.	Corrige l'annotation pour qu'elle pointe vers le dépôt qui contient le catalog-info.yaml.
2500 fichiers, limite 2000 : le dépôt est sauté, ses ressources déjà publiées restent.	Le dépôt est trop gros. Demande à ton administrateur d'augmenter Fichiers par dépôt dans Paramètres, ou déclare un dossier plus petit.
350 ressources, limite 300 : seules les 300 premières sont publiées.	Demande à ton administrateur d'augmenter Ressources IA par dépôt, ou découpe le dépôt.
skills/big/SKILL.md pèse 300000 octets, limite 262144 : le fichier est ignoré.	Raccourcis le fichier, ou demande à ton administrateur d'augmenter Taille d'un fichier.
60000000 octets à lire, limite 52428800 : le dépôt est sauté, ses ressources déjà publiées restent.	Demande à ton administrateur d'augmenter Taille d'un dépôt.
250 dépôts annotés, limite 200 : celui-ci n'est pas lu.	Demande à ton administrateur d'augmenter Dépôts lus au plus.
Non relu depuis le 25/10/2026 : les ressources ci-dessous sont celles de cette lecture.	La dernière lecture a échoué. La cause est sur le même onglet.
Ce dépôt n'a encore jamais été lu avec succès.	La cause de l'échec est sur le même onglet.
Pas encore lu : la prochaine lecture publiera ses ressources.	Clique sur Relire le dépôt.
Vous n'avez pas le droit de rafraîchir ce composant.	Ton rôle ne te laisse pas relire le dépôt. Demande à un administrateur, ou attends la prochaine lecture.
Un passage est déjà en cours : réessayez dans un instant.	Attends, puis clique à nouveau.
Le dépôt n'a pas été relu en 2 minutes : rechargez la page dans un instant.	Recharge la page.

Quand la lecture échoue

L'état est Lecture en échec. Le message commence par l'hôte qu'Astrolabe a essayé de joindre, par exemple gitlab.exemple.com.

Ce que tu vois	Quoi faire
gitlab.exemple.com refuse les identifiants (401) : le jeton de la connexion est peut-être faux ou expiré.	Dans Administration › Connexions de l'entreprise, remplace le jeton.
github.com refuse les identifiants : le jeton de la connexion est peut-être faux ou expiré. (sans statut)	Astrolabe n'a même pas pu utiliser les identifiants : sur GitHub, c'est le plus souvent une application GitHub dont la clé privée n'est pas le contenu du fichier .pem. Dans Administration › Connexions de l'entreprise › GitHub Apps, colle de nouveau tout le fichier .pem, de -----BEGIN à -----END.
gitlab.exemple.com accepte le jeton mais refuse l'accès (403) : donnez au jeton le droit de lire ce dépôt.	Donne au jeton le droit de lire le dépôt.
gitlab.exemple.com répond « introuvable » (404) : le dépôt a bougé, ou le jeton ne le voit pas.	Vérifie l'adresse du dépôt, et que le jeton le voit.
Aucun serveur ne répond au nom gitlab.exemple.com : vérifiez l'hôte de la connexion.	Corrige l'hôte dans Connexions de l'entreprise.
gitlab.exemple.com ne répond pas à temps : vérifiez son nom et son port.	Corrige le nom et le port de la connexion.
gitlab.exemple.com refuse la connexion : vérifiez le port, et que le serveur tourne.	Vérifie le port, et démarre le serveur.
Astrolabe ne fait pas confiance au certificat de gitlab.exemple.com (souvent un certificat interne).	Préviens l'administrateur d'Astrolabe : le certificat doit être reconnu.
gitlab.exemple.com est trop occupé pour répondre (429) : la prochaine lecture réessaiera.	Attends la prochaine lecture, ou clique plus tard sur Lancer maintenant.
gitlab.exemple.com répond quelque chose d'inattendu.	Vérifie l'hôte et l'URL d'API de la connexion dans Connexions de l'entreprise.
Astrolabe n'a pas pu lire ce dépôt sur gitlab.exemple.com.	Lis les autres messages de l'onglet.

Clique sur Corriger la connexion sur la ligne pour ouvrir la connexion. Au-dessus de ses jetons, la page dit lequel lit l'hôte, par exemple Astrolabe lit gitlab.exemple.com avec le jeton « GitLab ». Si elle dit Aucun jeton de cette connexion n'est pour gitlab.exemple.com : ajoutez-en un avec « Ajouter un jeton »., ajoute un jeton pour cet hôte. La colonne Hôte donne l'hôte de chaque jeton.

Quand une lecture tourne

Ce que tu vois	Quoi faire
Un passage est déjà en cours : Astrolabe le suit.	Attends la fin : le tableau se met à jour.
Le passage s'est arrêté avant de lire les dépôts : le catalogue n'a pas répondu. Réessayez dans un moment.	Clique à nouveau sur Lancer maintenant dans un moment.
Le passage n'est pas terminé au bout de 2 minutes : le tableau se mettra à jour à la fin.	Attends : le tableau se met à jour quand le passage est fini.
L'état des dépôts n'a pas pu être lu.	Recharge la page.
Le catalogue n'a pas répondu : les ressources IA ne peuvent pas être listées pour l'instant.	Recharge la page dans un moment.

Le fichier d'une ressource

Ce que tu vois	Quoi faire
Le fichier n'a pas pu être lu : rechargez la page dans un instant.	Recharge la page.
Ce fichier ne peut pas être affiché : son nom contient des caractères qu'Astrolabe ne lit pas (une espace, un accent…).	Renomme le fichier dans le dépôt, sans espace ni accent.
Affiché en partie : le fichier est plus long que ce qu'Astrolabe lit.	Lis la fin du fichier dans le dépôt.

La fenêtre Installer

Ce que tu vois	Quoi faire
Codex ne lit pas cette ressource : elle est faite pour Claude Code, Cursor.	Choisis un outil pour lequel elle est faite.
Ce fichier porte les instructions d'un projet entier.	Lis-le dans l'onglet Contenu et copie ce qu'il te faut.
Astrolabe ne sait pas encore calculer de commande d'installation pour gitlab.exemple.com.	Copie les fichiers depuis le dépôt, à la main.
Astrolabe ne donne pas de commande pour cette ressource : son chemin ou son adresse ne peut pas entrer sans risque dans une commande.	Copie les fichiers depuis le dépôt, à la main.
Astrolabe ne donne pas de commande pour cette ressource : son serveur répond en http et Astrolabe n'a pas pu lire le commit, donc rien ne garantit que les fichiers seraient ceux qu'il a lus.	Copie les fichiers depuis le dépôt, à la main, ou relis le dépôt.
Non épinglée : Astrolabe n'a pas pu lire le commit. La commande installe l'état actuel de la branche par défaut.	Relis le dépôt pour épingler la commande sur un commit.
Copie impossible : sélectionnez le texte.	Sélectionne la commande à la souris et copie-la.

La note

Ce que tu vois	Quoi faire
Pas encore notée	Compass n'a pas encore noté la ressource. Clique sur Relire le dépôt sur l'onglet Ressources IA du dépôt : elle est notée tout de suite.
Note : non mesurée ou Non mesuré	Compass n'a pas pu mesurer les vérifications. Ouvre l'onglet Compass de la ressource et lis la raison sous Non mesuré.
Note indisponible : Compass n'a pas répondu.	Recharge la page dans un moment. Si ça dure, préviens ton administrateur : le plugin Compass doit tourner.
Astrolabe n'a pas encore lu cette ressource IA : relancez la lecture de son dépôt depuis l'onglet Ressources IA du dépôt.	Fais ce qu'il dit.
Le dépôt a été relu, mais Compass n'a pas pu recalculer la note : réessayez dans un moment.	Clique à nouveau sur Relire le dépôt dans un moment.
Certaines vérifications n'ont pas pu être mesurées : elles ne comptent ni pour ni contre le score.	Lis la raison sous chaque vérification Non mesuré.

Toujours bloqué ?

Écris à support@forgeit.fr avec ce que tu vois à l'écran.