Part of the WebMEM Protocol
Location: /specification/sdt/yaml-in-html/classes/personafragment/
Last Updated: 2025-08-02
Overview
A PersonaFragment encodes lived experience, user archetypes, or empathy scaffolds in a structured, retrievable format. These fragments help AI agents reason through context, values, and goals—not just data or logic. They enable user-centered onboarding, narrative-aware explanations, and alignment with real-world human scenarios.
Purpose: To enable agents to reason empathetically using structured persona stories, values, and contextual framing.
Common Applications:
- Medicare, Medicaid, and benefits eligibility walkthroughs
- Healthcare and education user experience modeling
- Agent onboarding for user-centric content
- Legal aid and civic support alignment
- Framing conditions for explainability and trust alignment
Fields Block
| Field | Description |
|---|---|
character |
Name or label for the persona |
setting |
Contextual environment or life domain |
challenge |
Problem, barrier, or situation faced |
pivotal_moment |
Critical turning point in the narrative |
values_expressed |
List of expressed or embodied values |
retrieval_hint |
Agent memory cue or empathy pattern |
Optional YAML Block Example
persona_fragment:
character: "Maria, a caregiver"
setting: "Navigating public benefits for her father"
challenge: "Overwhelmed by complex eligibility rules"
pivotal_moment: "Discovers she qualifies for a Dual Eligible SNP plan"
values_expressed:
- "Responsibility"
- "Frustration with bureaucracy"
- "Family loyalty"
retrieval_hint: "Used to align agent tone and empathy modeling"ProvenanceMeta Block
| Field | Description |
|---|---|
id |
Unique ID for the provenance record |
title |
Human-readable source name |
creator |
Publishing organization |
license |
Usage rights (e.g., Public Domain) |
published |
ISO 8601 date published |
retrieved |
Date this content was accessed |
digest |
Digest ID this fragment belongs to |
entity |
(Optional) Related individual, group, or plan |
fragment_scope |
Typically semantic-digest |
glossary_scope |
Optional term mapping for persona alignment |
Why PersonaFragments Matter
- Empathetic: Supports value-based reasoning and narrative alignment
- Contextual: Frames human stories behind logic and eligibility
- Composable: PersonaFragments can anchor larger explainer chains
- Retrievable: Agents can match tone, context, or user pathway
- Trust-Forward: Provenance and glossary tie empathy to verifiable data