glam/schemas/20251121/linkml/modules/classes/Asserter.yaml

113 lines
4.9 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_contact_point
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_score
- ../slots/has_or_had_type
- ../slots/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.\n**PROV-O ALIGNMENT**:\nMaps 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.\"\n**TYPES OF ASSERTERS**:\n| 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\" |\n**USE CASES**:\n1. **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.\n**EXAMPLE**:\n```yaml Asserter:\n has_or_had_identifier: https://nde.nl/ontology/hc/asserter/claude-opus-4\n has_or_had_label: Claude Opus 4\n has_or_had_type: AI_AGENT\n has_or_had_description: Anthropic Claude AI model used for assertion generation\n has_or_had_version: \"claude-opus-4-20250514\"\n```"
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
- has_or_had_version
- has_or_had_contact_point
- has_or_had_score
slot_usage:
has_or_had_identifier:
# range: string # uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/asserter/claude-opus-4
- value: https://nde.nl/ontology/hc/asserter/jane-doe-nde
has_or_had_label:
# range: string
required: true
examples:
- value: Claude Opus 4
- value: Dr. Jane Doe
- value: primary-presence-classifier
has_or_had_description:
# range: string
required: false
examples:
- value: Anthropic Claude AI model used for heritage data assertions
- value: Senior digital heritage analyst at NDE
has_or_had_type:
range: AsserterTypeEnum
required: true
examples:
- value: AI_AGENT
- value: HUMAN_ANALYST
- value: AUTOMATED_SYSTEM
has_or_had_version:
# range: string
required: false
examples:
- value: claude-opus-4-20250514
- value: 1.2.3
has_or_had_contact_point:
# range: string
required: false
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
has_or_had_description: Anthropic Claude AI model used for heritage data assertions
has_or_had_version: claude-opus-4-20250514
- 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
has_or_had_description: Senior digital heritage analyst at NDE
has_or_had_contact_point: jane.doe@nde.nl
- 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
has_or_had_description: Automated system for classifying primary digital presence
has_or_had_version: 1.0.0
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"