Types d'objets

Les entités typées au cœur de l'ontologie — propriétés, identité, classifications, possibilité de recherche.

Un type d'objet est la vue typée d'une entité dans votre domaine. Définissez-le une fois, liez-le à une source réelle, et le reste de la plateforme le traite comme un type de première classe.

Anatomie

Champ	Rôle
`id`	L'identifiant stable du type (ex. `RegulatedEntity`). Ne peut pas être renommé.
`title`	Nom lisible par l'humain affiché dans l'interface (ex. « Entité réglementée »).
`description`	Description en texte libre affichée dans l'atelier et exportée vers les outils LLM.
`icon`	Emoji ou clé d'icône affiché dans la vue graphique.
`properties`	La liste des propriétés typées.
`identity`	La règle pour dériver un ID d'instance stable. Voir Concepts → Règles d'identité.
`dlpLabels`	Étiquettes DLP par défaut optionnelles appliquées à chaque instance.

Propriétés

Chaque propriété déclare un nom, un type et des indicateurs optionnels :

Indicateur	Effet
`required`	Les instances sans cette propriété sont rejetées.
`searchable`	La propriété est indexée pour la récupération — consultable par l'analyste, utilisée dans les requêtes sémantiques.
`pii`	La propriété est traitée comme PII — le masquage automatique s'applique pour les appelants sans habilitation.
`classification`	L'une des valeurs `public`, `internal`, `confidential`, `restricted` — pilote le masquage au niveau de la colonne.
`link`	La propriété est une référence à un autre Objet typé.

Exemple

defineObjectType({
  id: "RegulatedEntity",
  title: "Regulated Entity",
  icon: "🏛️",
  description: "A legal entity subject to a regulator's oversight.",
  properties: {
    id: { type: "string", required: true },
    legalName: { type: "string", required: true, searchable: true },
    riskClassification: {
      type: "enum",
      values: ["low", "medium", "high", "critical"],
      required: true,
    },
    headquartersCountry: { type: "string" },
    primaryRegulator: { type: "link", target: "Regulator" },
    annualSARVolume: {
      type: "number",
      classification: "confidential",
    },
  },
  identity: { columns: ["id"] },
});

Ce que vous pouvez en faire

Une fois qu'un type d'objet est défini et lié :

Lire des instances dans un workflow avec le bloc Get Object.
Rechercher par propriétés consultables via le moteur de contexte.
Traverser vers les objets liés (ex. d'une RegulatedEntity vers son Regulator).
Visualiser dans la vue graphique.
Déclencher des actions qui opèrent sur les instances de ce type.
Lier à des données réelles via Liaisons.

Renommage et modifications incompatibles

Une fois publié sur main, l'id d'un type d'objet est immuable. Pour le renommer, vous devez :

Créer un nouveau type d'objet avec le nouvel id.
Migrer les liaisons, actions et workflows.
Archiver l'ancien type.

Modifier le type d'une propriété ou supprimer une propriété constitue également une modification incompatible. Ces deux opérations passent par une branche de proposition afin que les réviseurs puissent évaluer l'impact avant la publication.

Voir aussi

Liaisons — connecter un type d'objet à une source réelle.
Types de liens — définir les arêtes entre les objets.
Concepts → Types de propriétés — le système de types complet.
SDK Authoring → Ontologies — définir des types d'objets en TypeScript.