glam/schemas/20251121/linkml/modules/classes/Asserter.yaml
kempersc 4319f38c05 Add archived slots for audience size, audience type, and capacity metrics
- Created new YAML files for audience size and audience type slots, defining their properties and annotations.
- Added archived capacity slots including cubic meters, linear meters, item count, and descriptions, with appropriate URIs and ranges.
- Introduced a template specificity slot for context-aware RAG filtering.
- Consolidated capacity-related slots into a unified structure, including has_or_had_capacity, capacity_type, and capacity_value, with detailed descriptions and examples.
2026-01-17 18:53:23 +01:00

178 lines
No EOL
7.2 KiB
YAML

id: https://nde.nl/ontology/hc/class/Asserter
name: Asserter
title: Asserter Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
prov: http://www.w3.org/ns/prov#
foaf: http://xmlns.com/foaf/0.1/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
imports:
- linkml:types
- ../enums/AsserterTypeEnum
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_description
- ../slots/has_or_had_type # was: asserter_type - migrated per Rule 53/56 (2026-01-17)
- ../slots/has_or_had_version # was: asserter_version - migrated per Rule 53/56 (2026-01-17)
- ../slots/has_or_had_contact_point # was: asserter_contact - migrated per Rule 53/56 (2026-01-17)
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
# REMOVED - migrated to generic slots per Rule 53/56 (2026-01-17)
# - ../slots/asserter_contact → has_or_had_contact_point
# - ../slots/asserter_type → has_or_had_type
# - ../slots/asserter_version → has_or_had_version
default_prefix: hc
classes:
Asserter:
class_uri: prov:Agent
description: >-
An agent (person, organization, or system) responsible for making
an assertion about a heritage entity.
**PROV-O ALIGNMENT**:
Maps to `prov:Agent` - "An agent is something that bears some form
of responsibility for an activity taking place, for the existence
of an entity, or for another agent's activity."
**TYPES OF ASSERTERS**:
| Type | Description | Example |
|------|-------------|---------|
| HUMAN_ANALYST | Expert making judgment | "jane.doe@nde.nl" |
| AUTOMATED_SYSTEM | Software system | "primary-presence-classifier/1.0" |
| AI_AGENT | AI/ML model | "claude-opus-4", "opencode-claude-sonnet-4" |
| ORGANIZATION | Institution | "Noord-Hollands Archief" |
**USE CASES**:
1. **Attribution Tracking**: Who made this assertion about primary presence?
2. **Provenance Chain**: Trace assertions back to their source agent.
3. **Quality Assessment**: Different asserters may have different reliability.
4. **Accountability**: Identify responsible party for each assertion.
**EXAMPLE**:
```yaml
Asserter:
has_or_had_identifier: https://nde.nl/ontology/hc/asserter/claude-opus-4
has_or_had_label: Claude Opus 4
has_or_had_type: AI_AGENT
has_or_had_description: Anthropic Claude AI model used for assertion generation
has_or_had_version: "claude-opus-4-20250514"
```
exact_mappings:
- prov:Agent
close_mappings:
- foaf:Agent
- dcterms:Agent
related_mappings:
- schema:Person
- schema:Organization
slots:
- has_or_had_identifier
- has_or_had_label
- has_or_had_description
- has_or_had_type # was: asserter_type - migrated per Rule 53/56 (2026-01-17)
- has_or_had_version # was: asserter_version - migrated per Rule 53/56 (2026-01-17)
- has_or_had_contact_point # was: asserter_contact - migrated per Rule 53/56 (2026-01-17)
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: true
identifier: true
description: >-
Unique identifier for this asserter.
examples:
- value: https://nde.nl/ontology/hc/asserter/claude-opus-4
description: AI agent asserter
- value: https://nde.nl/ontology/hc/asserter/jane-doe-nde
description: Human analyst asserter
has_or_had_label:
range: string
required: true
description: >-
Name of the asserter.
examples:
- value: Claude Opus 4
description: AI model name
- value: Dr. Jane Doe
description: Human analyst name
- value: primary-presence-classifier
description: Automated system name
has_or_had_description:
range: string
required: false
description: >-
Description of the asserter and their role in the assertion process.
examples:
- value: Anthropic Claude AI model used for heritage data assertions
- value: Senior digital heritage analyst at NDE
has_or_had_type: # was: asserter_type - migrated per Rule 53/56 (2026-01-17)
range: AsserterTypeEnum
required: true
description: >-
The type of agent making the assertion.
examples:
- value: AI_AGENT
- value: HUMAN_ANALYST
- value: AUTOMATED_SYSTEM
has_or_had_version: # was: asserter_version - migrated per Rule 53/56 (2026-01-17)
range: string
required: false
description: >-
Version identifier for software agents.
examples:
- value: "claude-opus-4-20250514"
- value: "1.2.3"
has_or_had_contact_point: # was: asserter_contact - migrated per Rule 53/56 (2026-01-17)
range: string
required: false
description: >-
Contact information for human or organizational asserters.
examples:
- value: jane.doe@nde.nl
- value: heritage-team@museum.nl
comments:
- Asserter models the agent responsible for making assertions
- Supports tracking of human, automated, and AI-based assertions
- Uses PROV-O Agent as primary ontology mapping
- Version tracking particularly important for AI/ML agents
see_also:
- https://www.w3.org/TR/prov-o/#Agent
- https://xmlns.com/foaf/spec/#term_Agent
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/asserter/claude-opus-4
has_or_had_label: Claude Opus 4
has_or_had_type: AI_AGENT # was: asserter_type
has_or_had_description: Anthropic Claude AI model used for heritage data assertions
has_or_had_version: "claude-opus-4-20250514" # was: asserter_version
description: AI agent asserter
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/asserter/jane-doe-nde
has_or_had_label: Dr. Jane Doe
has_or_had_type: HUMAN_ANALYST # was: asserter_type
has_or_had_description: Senior digital heritage analyst at NDE
has_or_had_contact_point: jane.doe@nde.nl # was: asserter_contact
description: Human analyst asserter
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/asserter/primary-presence-classifier
has_or_had_label: primary-presence-classifier
has_or_had_type: AUTOMATED_SYSTEM # was: asserter_type
has_or_had_description: Automated system for classifying primary digital presence
has_or_had_version: "1.0.0" # was: asserter_version
description: Automated system asserter
# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline