Certains ont commencé à créer manuellement leurs fichiers Markdown pour décrire leurs documents. Mais l’idée de OKF est bien sûr de permettre la création automatisée des fichiers descriptifs de chaque document, par un agent IA. Lorsque vous les générez manuellement, vous prenez la responsabilité de leur contenu. Mais lorsqu’un agent transforme chaque jour des centaines de contenus en éléments d’un bundle OKF, le contrôle humain et donc la responsabilité, deviennent impossibles. La version 0.2 de OKF propose justement des métadonnées supplémentaires pour améliorer la compréhension de l’origine du fichier et de son niveau de confiance. Ainsi, vous pourrez décider quels contenus vous utiliserez en fonction de la confiance que vous leur accorderez.
— La métadonnée « sources », déclinée en « author », « usage_count », et « last_modified », permet de mentionner les sources, multiples, du document. Je vais clairement utiliser cette possibilité.
— La métadonnée « trust », déclinée en « generated: [by, at] », et « verified [by, at] », documente le processus de création du fichier Markdown et de sa vérification. Un fichier généré ou vérifié par un humain pourra être différencié de celui généré par un agent. Pour l’instant je n’ai que des documents créés et vérifiés par l’humain, mais c’est intéressant à anticiper et donc à appliquer.
— La métadonnée « freshness and lifecycle », déclinée en « stale_after » et « status », documente le cycle de vie, permet de déprécier certains documents, automatiquement à une date précise. Je n’imagine pas d’application pour le moment à mon projet de base de connaissances, mais c’est à garder en tête.
— Le nouveau type « attestation » permet de formaliser comment une valeur doit être calculée, et fournit l’expression permettant de la contrôler. Cela ne sera utilisé que dans le cas d’agents qui créeront des données à partir de requêtes et de calculs et les ajouteront à un fichier Markdown. Intéressant, mais peu d’impact sur mon projet.
Alors, quelle attitude adopter face à cette nouvelle version. Vous avez trois possibilités :
— Ne rien faire, et continuer à générer vos fichiers Markdown en version 0.1. Aucun problème, la compatibilité est parfaite.
— Adapter tout ou partie de votre bundle et faire évoluer les fichiers Markdown pour qu’ils intègrent certaines des nouvelles métadonnées proposées par OKF v0.2 ; bien sûr, cette évolution sera manuelle, car aucun système ne peut inventer vos métadonnées. J’ai bien dit « tout ou partie », donc ne vous obligez pas à passer en 0,2 des fichiers qui ne bénéficieraient pas des nouvelles métadonnées.
— Conserver vos fichiers actuels sans aucune modification, mais adaptez votre fichier modèle, pour que tous les nouveaux fichiers créés le soient directement en version 0.2. N’oubliez pas de renommer la version OKF utilisée en tête des fichiers, pour que les outils de lecture sachent à quelles métadonnées s’attendre.
Évidemment, évaluez l’impact de cette évolution, et le temps nécessaire à la mise à jour. N’oubliez pas que ce format OKF est vivant. D’autres versions mineures pourraient apparaître dans les prochains mois, avant peut-être une version majeure 1.0 un peu plus figée. Ne franchissez chaque étape que si elle est réellement nécessaire à votre projet.
