Fonctionnalités de Kiso

Kiso propose deux applications qui exploitent le même bundle Open Knowledge Format : kiso-cli pour le valider et le publier, et kiso-mcp-server pour donner aux agents d’IA un accès direct à son contenu.

Kiso CLI

Vérification d'un bundle OKF

La commande check contrôle les fichiers Markdown d’un bundle avant sa publication. Elle signale les erreurs de format ou de structure et remonte les liens cassés sous forme d’avertissements.

kiso-cli check --source=ma-base-de-connaissances

Cette vérification peut être lancée localement ou dans une chaîne d’intégration continue afin de détecter rapidement les contenus non conformes.

Génération d'un site statique

La commande build transforme le bundle en site web statique :

kiso-cli build \
  --source=ma-base-de-connaissances \
  --destination=public

Le répertoire généré contient notamment :

• des pages HTML structurées et navigables ;
• les fichiers Markdown d’origine, consultables et réutilisables par les humains comme par les agents ;
• un fichier llms.txt facilitant la découverte du contenu par les systèmes d’IA ;
• un fichier sitemap.xml destiné aux moteurs d’indexation.

Le résultat est entièrement statique. Il peut être ouvert localement ou publié sur GitHub Pages et, plus généralement, sur n’importe quel serveur HTTP ou service d’hébergement statique.

Configuration de la publication

Un fichier facultatif .kiso/configuration.yaml, placé à la racine du bundle, permet de configurer :

• l’URL publique, le nom, la langue, le titre et la description du site ;
• le thème DaisyUI utilisé pour le rendu ;
• les fichiers et répertoires à exclure de la publication au moyen de motifs glob.

Kiso propose aussi des profils de publication dans .kiso/<profil>/configuration.yaml. Un même bundle peut ainsi produire, par exemple, une édition publique et une édition interne sans modifier son contenu source.

kiso-cli build --profile=public
kiso-cli build --profile=internal

Intégration continue avec GitHub Actions

Kiso CLI peut vérifier, construire et publier automatiquement une base OKF lors d’un changement dans le dépôt :

- name: Build with Kiso
  uses: oak-invest/kiso/applications/kiso-cli-action@v0.2.1
  with:
    command: build
    source: examples/kb-google-example
    destination: public/kb-google-example

Cette intégration permet de conserver le bundle OKF dans Git tout en automatisant la génération et le déploiement du site.

Kiso MCP Server

Exposition d'un bundle via MCP

kiso-mcp-server charge un bundle OKF et démarre un serveur compatible avec le Model Context Protocol. Une application d’IA peut alors explorer la base de connaissances sans passer par le site généré.

kiso-mcp-server --source=ma-base-de-connaissances

Par défaut, le serveur écoute sur le port 8080 et expose son point d’entrée MCP à l’adresse suivante :

http://localhost:8080/mcp

Le port peut être modifié avec l’option --port :

kiso-mcp-server \
  --source=ma-base-de-connaissances \
  --port=8081

Recherche dans la connaissance

L’outil MCP search effectue une recherche textuelle parmi les concepts du bundle. L’index prend en compte le titre, la description, les tags et le corps des documents. Chaque résultat fournit l’identifiant du concept, son titre, sa description et un score de pertinence.

Cette première étape permet à l’agent d’identifier les concepts susceptibles de répondre à sa question sans charger toute la base dans son contexte.

Récupération du contenu d'un concept

L’outil MCP get_concept_content retourne le fichier Markdown d’origine correspondant à un identifiant de concept. L’agent peut ainsi récupérer le contenu complet d’un résultat pertinent, métadonnées comprises, puis l’utiliser comme contexte.

Le parcours type est donc :

1. rechercher les concepts pertinents avec search ;
2. sélectionner un ou plusieurs identifiants de concept ;
3. récupérer leur contenu avec get_concept_content ;
4. exploiter cette connaissance dans la réponse ou la tâche en cours.

Accès sans modification du bundle

Le serveur MCP ne génère aucun site et ne modifie pas les fichiers sources. Le bundle OKF reste la source de vérité, tandis que le serveur fournit une interface de lecture adaptée aux agents d’IA.

Complémentarité des deux applications

Les deux applications peuvent être utilisées séparément ou ensemble. Une organisation peut publier un site documentaire destiné à ses équipes tout en connectant ses assistants et agents d’IA au même bundle OKF.