Ontologie

En bref

Interrogez, creez et naviguez dans votre modele metier.

Prérequis

Clé API avec le preset MCP et les scopes requis
Client MCP configure (voir Configuration)

Exemples minimaux

Decouvrir et rechercher dans votre ontologie

Listez vos espaces disponibles :

{
  "name": "ontology_list_espaces",
  "arguments": {}
}

Recherchez des entites par mot-cle :

{
  "name": "ontology_search",
  "arguments": {
    "query": "fournisseur",
    "limit": 10
  }
}

Consultez les details d'une entite :

{
  "name": "ontology_get_node",
  "arguments": {
    "nodeId": "uuid-de-lentite"
  }
}

Decouverte

`ontology_describe`

Resume la structure de votre ontologie : types d'entites, relations, statistiques.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`statistics`	object
`topObjectTypes`	object[]
`topLinkTypes`	object[]
`edgeTypes`	object[]
`businessDescription`	string

Exemple

{
  "name": "ontology_describe",
  "arguments": {
    "format": "summary"
  }
}

Requetes

`ontology_query_nodes`

Recherche et filtre les entites de votre ontologie par type, nom ou proprietes.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`nodes`	object[]
`total`	number
`hasMore`	boolean

Exemple

{
  "name": "ontology_query_nodes",
  "arguments": {
    "nodeType": "ObjectType",
    "limit": 20
  }
}

`ontology_query_edges`

Liste les relations (liens) entre entites avec filtres optionnels.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`edges`	object[]
`total`	number
`hasMore`	boolean

Exemple

{
  "name": "ontology_query_edges",
  "arguments": {
    "limit": 20
  }
}

`ontology_search`

Recherche en texte integral dans les entites de votre ontologie.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`results`	object[]
`total`	number
`took`	number
`query`	string

Exemple

{
  "name": "ontology_search",
  "arguments": {
    "query": "fournisseur",
    "limit": 10
  }
}

`ontology_semantic_query`

Recherche semantique en langage naturel dans votre ontologie.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`answer`	string
`entities`	object[]
`relationships`	object[]
`explanation`	string
`metadata`	object

Exemple

{
  "name": "ontology_semantic_query",
  "arguments": {
    "query": "Quels sont les types de contrats ?"
  }
}

CRUD Noeuds

`ontology_get_node`

Recupere les details complets d'une entite par son identifiant ou son nom.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`node`	object	null

Exemple

{
  "name": "ontology_get_node",
  "arguments": {
    "nodeId": "uuid-de-lentite"
  }
}

CRUD Relations

`ontology_get_edge_properties`

Recupere les proprietes detaillees d'une relation (cardinalite, cascade).


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`edges`	object[]
`total`	number
`summary`	object

`ontology_get_neighbors`

Liste les entites directement connectees a une entite donnee (entrants et sortants).


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Exemple

{
  "name": "ontology_get_neighbors",
  "arguments": {
    "nodeId": "uuid-de-lentite",
    "direction": "both"
  }
}

`ontology_traverse`

Parcourt le graphe en largeur (BFS) depuis une entite avec limite de profondeur.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`root`	object
`graph`	object
`paths`	object[]
`stats`	object

`ontology_find_path`

Trouve le chemin le plus court entre deux entites du graphe.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`found`	boolean
`source`	object
`target`	object
`paths`	object[]
`stats`	object

Schemas et proprietes

`ontology_get_property_schema`

Recupere le schema de proprietes avec regles de validation pour un type d'entite.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`nodeId`	string
`nodeName`	string
`nodeDisplayName`	string
`nodeType`	string
`properties`	object[]
`summary`	object

`ontology_analyze_schema`

Analyse approfondie de la structure du schema de l'ontologie.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`summary`	object
`nodeTypes`	object[]
`patterns`	object
`recommendations`	string[]

`ontology_value_types`

Liste les types de valeurs disponibles pour les proprietes.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`operation`	string
`valueType`	object
`valueTypes`	object[]
`total`	number

Actions Kinetic

`ontology_list_actions`

Liste les actions Kinetic disponibles sur une entite.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`actions`	object[]
`count`	number

`ontology_get_action`

Recupere les details d'une action Kinetic specifique.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`action`	object
`stats`	object

`ontology_action_history`

Consulte l'historique d'execution des actions sur une entite.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`executions`	object[]
`count`	number
`actionId`	string

Instances

`ontology_list_instances`

Liste les instances d'un type d'entite (Digital Twin).


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`instances`	object[]
`total`	number
`hasMore`	boolean

`ontology_get_instance`

Recupere les details d'une instance specifique.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`id`	string
`objectTypeId`	string
`displayName`	string	null
`data`	object
`version`	number
`externalId`	string	null
`createdAt`	string
`updatedAt`	string

`ontology_search_instances`

Recherche dans les instances d'un type d'entite.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`instances`	object[]
`total`	number
`hasMore`	boolean

Export

`ontology_export`

Exporte l'ontologie au format YAML.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espaces`	object[]
`objectTypes`	object[]
`linkTypes`	object[]
`totalNodes`	number
`totalEdges`	number
`exportedAt`	string

`ontology_stats`

Affiche les statistiques de l'ontologie (noeuds, relations, types).


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`workspaceStats`	object	null
`espaceStats`	object[]

Historique

`ontology_get_history`

Consulte l'historique des modifications d'une entite.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`node`	object
`historicalState`	object	null
`currentState`	object
`events`	object[]
`stats`	object

`ontology_impact_analysis`

Analyse l'impact en cascade d'une modification sur les entites liees.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`espace`	object
`analyzedNode`	object
`downstream`	object[]
`upstream`	object[]
`summary`	object
`deletionSimulation`	object

Autres

`context_pack`

[DISCOVER] Assemble bounded, LLM-ready context for a given query.


Scope	`mcp.read`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

`df_plan_action`

[EXECUTE] Dry-run a business action — returns a signed plan artifact WITHOUT executing.


Scope	`mcp.plan.write`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`planId`	string
`planHash`	string
`canRun`	boolean
`canApply`	boolean
`applyBlockedReason`	string
`effects`	unknown[]
`blockedBy`	object[]
`risk`	string
`expiresAt`	string
`proof`	object

`df_plan_inspect`

[DISCOVERY] Inspect a plan artifact (signed mutation intent).


Scope	`mcp.plan.write`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`plan`	unknown

`df_plan_list`

[DISCOVERY] List plan artifacts in the workspace.


Scope	`mcp.plan.write`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`plans`	object[]
`count`	number

`df_plan_verify`

[ACTION] Verify if a plan artifact can be applied.


Scope	`mcp.plan.write`
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Reponse

Champ	Type	Description
`planId`	string
`canApply`	boolean
`checks`	object[]
`reasons`	object[]

Dépannage

Code	Message	Solution
404	Espace non trouve	Verifiez l'identifiant avec `ontology_list_espaces`.
403	Scope insuffisant	Ajoutez le scope `mcp.write` a votre cle API.

Besoin d'aide ?

Écrivez-nous : Support et contact.

Envoyer un feedback sur cette page

En bref​

Prérequis​

Exemples minimaux​

Decouvrir et rechercher dans votre ontologie​

Decouverte​

ontology_describe​

Requetes​

ontology_query_nodes​

ontology_query_edges​

ontology_search​

ontology_semantic_query​

CRUD Noeuds​

ontology_get_node​

CRUD Relations​

ontology_get_edge_properties​

Navigation graphe​

ontology_get_neighbors​

ontology_traverse​

ontology_find_path​

Schemas et proprietes​

ontology_get_property_schema​

ontology_analyze_schema​

ontology_value_types​

Actions Kinetic​

ontology_list_actions​

ontology_get_action​

ontology_action_history​

Instances​

ontology_list_instances​

ontology_get_instance​

ontology_search_instances​

Export​

ontology_export​

ontology_stats​

Historique​

ontology_get_history​

ontology_impact_analysis​

Autres​

context_pack​

df_plan_action​

df_plan_inspect​

df_plan_list​

df_plan_verify​

Dépannage​

Besoin d'aide ?​

En bref

Prérequis

Exemples minimaux

Decouvrir et rechercher dans votre ontologie

Decouverte

`ontology_describe`

Requetes

`ontology_query_nodes`

`ontology_query_edges`

`ontology_search`

`ontology_semantic_query`

CRUD Noeuds

`ontology_get_node`

CRUD Relations

`ontology_get_edge_properties`

Navigation graphe

`ontology_get_neighbors`

`ontology_traverse`

`ontology_find_path`

Schemas et proprietes

`ontology_get_property_schema`

`ontology_analyze_schema`

`ontology_value_types`

Actions Kinetic

`ontology_list_actions`

`ontology_get_action`

`ontology_action_history`

Instances

`ontology_list_instances`

`ontology_get_instance`

`ontology_search_instances`

Export

`ontology_export`

`ontology_stats`

Historique

`ontology_get_history`

`ontology_impact_analysis`

Autres

`context_pack`

`df_plan_action`

`df_plan_inspect`

`df_plan_list`

`df_plan_verify`

Dépannage

Besoin d'aide ?