Export lisible par les agents (OKF)
L’export Open Knowledge Format (OKF) transforme votre organisation Peerdom en un ensemble de documents simples et reliés entre eux, que les agents IA lisent directement : vos cercles, vos rôles, vos collègues, vos objectifs et vos pages, décrits dans une forme que tout agent comprend. Il parle l’Open Knowledge Format, un standard ouvert de partage des connaissances organisationnelles avec les agents IA : un agent saisit donc le fonctionnement de votre organisation sans intégration sur mesure.
C’est le pendant ouvert et lisible du serveur MCP : MCP permet à un assistant de dialoguer avec votre organisation via votre clé API ; OKF rend votre organisation lisible par tout agent capable de lire un fichier.
Ce que contient le bundle
Un bundle OKF est un dossier de fichiers Markdown (un fichier par « concept ») qui se lient les uns aux autres pour décrire votre organisation :
| Vos données Peerdom | Deviennent un concept de type | Un agent peut en déduire |
|---|---|---|
| Cercle | Circle | quelles équipes existent, comment elles s’imbriquent, de quoi elles répondent |
| Rôle | Role | la raison d’être de chaque rôle, le cercle auquel il appartient, qui l’occupe |
| Personne | Peer | quels rôles une personne tient, et où |
| Objectif | Goal | ce qu’est un résultat attendu et quel rôle ou cercle en répond |
| Page | Page | le contexte que vous avez publié à l’appui |
Le bundle s’ouvre sur un index qui laisse un agent embrasser toute l’organisation d’un coup d’œil, puis suivre les liens vers le détail. Tout est écrit dans votre propre vocabulaire : si vous avez renommé les cercles en « équipes » ou en « pôles », le bundle emploie vos termes.
Rendez votre carte publique → instantanément lisible par les agents
Si la carte de votre organisation est publique, son bundle OKF est publié à une adresse stable et ouverte, tenue à jour au fil des changements. N’importe quel agent (Claude, ChatGPT, Gemini, un agent open source, tout ce qui sait récupérer une URL) peut le lire et répondre fidèlement à des questions sur votre organisation, sans intégration d’aucun côté.
C’est la façon la plus simple de rendre votre organisation compréhensible par le web agentique : passez votre carte en public, et c’est fait.
Ce qu’un agent peut en faire
Pointé sur votre bundle, un agent peut :
- Résumer la structure de votre organisation, cercle par cercle.
- Expliquer à quoi sert un rôle donné et qui l’occupe actuellement.
- Repérer les rôles vacants, ou les personnes qui en portent le plus.
- Retracer le lien entre les objectifs et les rôles ou cercles qui en répondent.
- Répondre au « à qui je parle pour X ? » d’une nouvelle recrue, à partir de la structure réelle.
Ce qui est inclus, et ce qui ne l’est pas
Le bundle respecte exactement les mêmes choix de confidentialité que votre carte publique :
- Seules les pages publiques sont incluses.
- Les personnes n’apparaissent que si vous les montrez. Si votre carte publique et vos vues intégrées masquent les détails des collègues, le bundle décrit la structure sans nommer personne.
- Les éléments archivés sont laissés de côté.
Les organisations privées
Si votre organisation n’est pas publique, son bundle n’est pas publié à une adresse ouverte. Son export complet reste accessible aux Propriétaires via une requête authentifiée, qui ignore les filtres publics et inclut tout. Pour un accès vivant et conversationnel à une organisation privée, le serveur MCP convient généralement mieux : il répond aux questions à la demande au lieu de livrer un instantané figé.
Pour vos propres agents
Un bundle public couvre ce que les visiteurs ont le droit de voir. Vos propres agents peuvent lire le bundle interne complet en s’authentifiant avec la clé API de votre organisation :
curl -H "x-api-key: YOUR_KEY" https://backend.peerdom.org/okf-full/-/Le - désigne votre propre organisation : la clé l’identifie déjà. Les agents connectés
via le serveur MCP de Peerdom obtiennent le même contenu avec l’outil
read_okf.
Cette clé déverrouille le bundle interne complet de votre organisation : chaque cercle, chaque rôle, chaque personne, chaque objectif et chaque page, y compris ce que vous gardez hors de votre carte publique. Traitez-la comme un mot de passe : ne la confiez qu’à des agents de confiance, et changez-la si elle fuit.
Questions fréquentes
Qu’est-ce que l’OKF ?
L’Open Knowledge Format est un standard ouvert qui décrit des connaissances (dont une structure organisationnelle) sous la forme d’un dossier de fichiers Markdown reliés entre eux, lisibles aussi bien par des personnes que par des agents IA. Il ne demande ni SDK, ni compte, ni outillage propriétaire.
En quoi est-ce différent du serveur MCP ?
Le serveur MCP est une connexion vivante et authentifiée : un assistant pose des questions avec votre clé API et obtient des réponses en temps réel. L’export OKF est un artefact ouvert et lisible : un instantané de votre organisation que n’importe quel agent peut lire, idéal pour les cartes publiques. Beaucoup d’organisations utiliseront les deux.
Y a-t-il quelque chose à configurer pour une carte publique ?
Non. Dès que votre carte est publique, le bundle est publié et tenu à jour automatiquement.
Un agent peut-il modifier mon organisation via le bundle ?
Non. L’OKF est en lecture seule par nature : c’est une description qu’un agent lit, jamais un moyen de modifier votre organisation.
Cela nécessite-t-il un plan Peerdom particulier ?
Le bundle public est publié automatiquement pour toute carte publique. L’export complet authentifié des organisations privées est accessible aux Propriétaires de l’organisation. Pour toute question sur votre plan, contactez le support Peerdom.
En lien
- Assistants IA (MCP) : dialoguer avec votre organisation en langage naturel
- API et webhooks : construire vos propres intégrations avec l’API REST
- Paramètres de l’organisation : rendre la carte de votre organisation publique et gérer les clés API
- Vue d’ensemble des intégrations : toutes les intégrations disponibles d’un coup d’œil