Tout ce dont vous avez besoin pour consulter Knowledge depuis votre stack, wrapper un business tool avec autorisation signée, ou brancher un MCP host aux tools Knowledge.
Getting started
| Page | Description |
|---|---|
| Qu'est-ce que Knowledge ? | Deux minutes sur le modèle mental et le vocabulaire. |
| Quickstart : créer votre première policy | D'un tenant vide au premier /resolve qui retourne un vrai verdict, en environ 30 minutes. Le chemin auteur. |
| Quickstart : governed tool en Python | Deux patterns pour l'enforcement de signed verdict sur un tool Python : vérifier un verdict qu'on reçoit, ou laisser un décorateur se consulter tout seul. |
| Quickstart : Knowledge comme serveur MCP | Wire le serveur MCP Knowledge dans Claude Desktop / Cursor / tout MCP host pour que l'agent puisse query, check, et soumettre des approvals sous forme de tool calls. |
Concepts
Explications approfondies des abstractions core.
| Page | Description |
|---|---|
| Policies, rules et targets | Les trois aggregates core. |
| Verdicts et decisions | Échelle de severity, précédence, record Consultation. |
| Signed verdicts et PEP | L'enveloppe JWS, checks de binding, spent-verdicts. |
| Résolution progressive de contexte | La boucle /resolve et l'inversion de dépendance. |
| Overrides, approbations, pauses | Les trois mécanismes d'exception gouvernés. |
| Modèle de confiance à quatre acteurs | Qui signe, qui vérifie, ce que chaque arête garantit. |
Référence API
| Endpoint | Description |
|---|---|
| Authentication | Clés API, cookies de session, binding de principal. |
| POST /v1/check | Verdict déterministe, contexte strict. |
| POST /v1/resolve | Verdict progressif, contexte tolérant. |
| GET /v1/tenants/{slug}/jwks | JWKS pour vérification de signature. |
| GET /v1/consultations/{id} | Récupérer un record de Consultation. |
| /v1/approvals | Créer, poll, décider. |
Spec OpenAPI complète à docs/api/openapi-v3.json dans le monorepo. Collection Postman : docs/api/postman/knowledge-v3.postman_collection.json.
Référence SDK
| Page | Description |
|---|---|
| knowledge-runtime (Python) | @governed_tool, verify_verdict, cache JWKS, guard-rails. |
| SDK TypeScript [Roadmap] | Parité feature avec Python planifiée pour Q4-2026. |
Serveur MCP
| Page | Description |
|---|---|
| Reference des tools | Les huit tools qu'expose le serveur MCP Knowledge, avec paramètres et format de retour. |
Guides
| Page | Description |
|---|---|
| Wrapper votre propre serveur MCP avec enforcement | Le pattern pour gater les tool calls d'un serveur MCP avec les signed verdicts Knowledge. Exemple de référence dans le monorepo. |
| Rotate signing keys | Rotation planifiée + urgence. |
| Multi-tenant setup | Faire tourner plusieurs tenants sur un déploiement. |
| Migrer d'advisory à enforcement | Le playbook en trois étapes. |
| Emergency response | Kill switch, rotation de clé, downgrade. |
Security + compliance
| Page | Description |
|---|---|
| Trust model deep dive | Chaîne à quatre acteurs, menaces edge-by-edge. |
| Keys inventory | Les quatre clés cryptographiques, storage, rotation. |
| Deployment shapes | Trade-offs SaaS, VPC, on-prem. |
| Compliance posture | Certifications, résidence, rétention, modèle de menace. |
Feedback à contact@asplenz.com.