Aller au contenu

Bases publiques (catalogue partagé)

Une base de connaissance peut être publiée au catalogue : d’autres comptes s’y abonnent et l’interrogent (chat, agent, recherche, MCP) comme une base à eux, à trois différences près :

  • Lecture seule — un abonné cherche et lit, mais ne modifie rien.
  • Sans copie — l’abonné interroge la base d’origine, pas un double. Zéro stockage en plus.
  • Toujours à jour — quand le propriétaire édite la base, les abonnés voient le nouveau contenu immédiatement, sans resynchronisation.

C’est fait pour mutualiser une base commune (guides, nomenclatures, FAQ, référentiels sectoriels) sans que chaque organisation ait à la ré-importer et ré-indexer.

Depuis le portail (Connaissances → Publier sur une de vos bases). La publication :

  • est réservée aux organisations (owner ou admin) — pas aux comptes personnels ;
  • demande une attestation RGPD (vous confirmez que la base respecte le RGPD) et un consentement d’irréversibilité ;
  • est définitive : une base publiée ne peut plus être dépubliée ni supprimée.

En promouvant la base, votre organisation en reste le mainteneur (steward) : vous continuez à ajouter, éditer et re-découper ses documents. La base sort simplement de votre « périmètre supprimable » : supprimer votre organisation ne détruit pas une base publiée (elle reste au catalogue).

En API :

Fenêtre de terminal
curl -X POST https://api.astrolabe.chat/v1/kb/ma-base/publish \
-H "Authorization: Bearer $ASTROLABE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "rgpd_attested": true }'

La clé doit appartenir à une organisation et porter le scope kb:write.

Depuis le portail (Connaissances → Catalogue), ou en API :

Fenêtre de terminal
# Lister les bases publiques (avec votre état d'abonnement)
curl https://api.astrolabe.chat/v1/kb/catalog \
-H "Authorization: Bearer $ASTROLABE_API_KEY"
# S'abonner (par le slug catalogue de la base)
curl -X POST https://api.astrolabe.chat/v1/kb/guides-rgpd/subscribe \
-H "Authorization: Bearer $ASTROLABE_API_KEY"
# Se désabonner
curl -X DELETE https://api.astrolabe.chat/v1/kb/guides-rgpd/subscribe \
-H "Authorization: Bearer $ASTROLABE_API_KEY"

Une fois abonné, la base apparaît dans votre espace comme les vôtres : vous la branchez sur un appel chat (knowledge_base ou tools_enabled: ["kb:<slug>"]), elle remonte dans la recherche globale et via le connecteur MCP. Seule différence : elle est en lecture seule.

  • Le stockage et l’indexation sont facturés une seule fois, au mainteneur — pas de duplication de coût côté abonnés.
  • Vos requêtes (l’embedding de la question et les tokens du modèle) sont facturées sur votre compte, comme pour n’importe quelle base.
Base à vousBase publiée (mainteneur)Base abonnée
Interroger (chat/agent/recherche)
Ajouter / éditer des documents❌ (lecture seule)
Supprimer / dépublier❌ (définitif)
Stockage facturévousvous— (pas de copie)