Ontologie

Interroge le graphe d'ontologie du workspace. Cinq operations disponibles : query (lister par type), lookup (rechercher par ID), traverse (parcourir les relations), search (recherche textuelle), aggregate (compter/sommer).

Parametres communs

Parametre	Type	Requis	Variable	Description
operation	choix (query, lookup, traverse, search, aggregate)	Oui	Non	Type d'operation a effectuer sur l'ontologie.
limit	nombre	Non	Oui	Nombre maximum de resultats a retourner. (Defaut: 50, min 1, max 1000)
outputFields	liste	Non	Non	Liste des champs a inclure dans les resultats. Vide = tous les champs.
outputVariable	texte	Non	Non	Nom de la variable de sortie pour referencer les resultats dans les blocs suivants.
allSpaces	oui/non	Non	Non	Rechercher dans tous les espaces du workspace au lieu de l'espace courant. (Defaut: false)
espaceIds	liste	Non	Non	Liste d'espaces specifiques a interroger (si allSpaces est desactive).

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

Parametres par operation

query — Requete

Rechercher des entites par type et filtres.

Parametre	Type	Requis	Variable	Description
entityType	texte	Oui	Oui	Type d'entite a rechercher (ex: Client, Produit).
filters	liste	Non	Non	Conditions de filtrage (champ, operateur, valeur). Combinees par ET/OU.
includeRelations	oui/non	Non	Non	Inclure les relations directes des entites trouvees. (Defaut: false)

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

lookup — Lookup

Rechercher une entite par identifiant ou cle unique.

Parametre	Type	Requis	Variable	Description
entityType	texte	Oui	Oui	Type d'entite a rechercher.
filters	liste	Non	Non	Filtres pour identifier l'entite (ex: id equals "abc").

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

traverse — Traversee

Parcourir les relations du graphe a partir d'un type d'entite.

Parametre	Type	Requis	Variable	Description
entityType	texte	Oui	Oui	Type d'entite de depart pour la traversee.
filters	liste	Non	Non	Filtres sur les entites de depart.
traversal.depth	nombre	Oui	Non	Profondeur de traversee (nombre de niveaux de relations a suivre). (Defaut: 1, min 1, max 10)
traversal.direction	choix (outgoing, incoming, both)	Oui	Non	Direction de traversee : sortante, entrante, ou les deux. (Defaut: "outgoing")
traversal.edgeTypes	liste	Non	Non	Types de relations a suivre. Vide = toutes les relations.
includeRelations	oui/non	Non	Non	Inclure les relations des entites trouvees dans les resultats. (Defaut: false)

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

search — Recherche semantique

Recherche par similarite vectorielle sur le contenu des entites.

Parametre	Type	Requis	Variable	Description
searchQuery	valeur dynamique	Oui	Oui	Texte de recherche ou variable dynamique. Le moteur compare avec les embeddings.

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

aggregate — Agregation

Calculs statistiques sur les entites (comptage, somme, moyenne, min, max).

Parametre	Type	Requis	Variable	Description
entityType	texte	Oui	Oui	Type d'entite sur lequel effectuer l'agregation.
filters	liste	Non	Non	Filtres pour restreindre les entites avant l'agregation.
aggregate.operation	choix (count, sum, avg, min, max)	Oui	Non	Type de calcul a effectuer.
aggregate.field	texte	Non	Oui	Champ sur lequel calculer (requis pour sum, avg, min, max ; optionnel pour count).
aggregate.outputField	texte	Non	Non	Nom du champ de sortie pour le resultat. Par defaut : nom de l'operation.

Les parametres marques Variable = Oui acceptent la syntaxe {{nomBloc.champ}}.

Sortie

Variable de sortie : ontologyData

{
  "success": false,
  "operation": "...",
  "entityType": "...",
  "items": [],
  "totalCount": 0,
  "returnedCount": 0
}

Exemple

Lister toutes les entites de type Lead.

Entree :

{"operation": "query", "entityType": "Lead"}

Sortie :

{"success": true, "operation": "query", "entityType": "Lead", "items": [{"id": "c9cb...", "name": "Lead", "type": "ObjectType", "properties": {}}], "totalCount": 15, "returnedCount": 15}

Erreurs courantes

Probleme	Solution
Le resultat est vide	Verifiez le nom exact du type d'entite. Les operations valides sont : query, lookup, traverse, search, aggregate.

Astuce

Utilisez {{ontologyData.items}} pour le tableau (pas {{ontologyData.results}}). En mode lookup, le champ est {{ontologyData.item}} (objet unique) et {{ontologyData.found}} (boolean).