ArtifactTypeScheme¶
| 屬性 | 值 |
|---|---|
| Scheme ID | provai:scheme-ArtifactTypeScheme |
| 綁定屬性 | ex:artifactType (domain: ex:Artifact; MUST) |
| 版本 | 0.1.1-draft |
| 結構 | Mixed closure:L1 必用 9 + L2-optional 5 |
| TTL 檔案 | concept-schemes/artifact-type.ttl |
ArtifactTypeScheme 是 Typed Artifact Pattern 的核心——把所有「資訊實體」統一為 ex:Artifact ⊑ prov:Entity + ex:artifactType → skos:Concept,避免 class 與欄位爆炸。
L1 必用(9 個 hasTopConcept)¶
PromptVersion — 提示詞版本¶
提示詞模板的版本化工件(穩定可重用模板)。
PromptInstance — 提示詞實例¶
由 PromptVersion 套用變數後的具體一次提示輸入。
ModelConfig — 模型設定¶
本次 turn 使用的模型與參數設定(model id / temperature / top-p 等)。
重要約束:
- Per-turn instance:每個
TurnRun對應一個ModelConfigartifact instance(不是 case-level audit summary) - assistant-only:
msg.author.role=assistant才產 ModelConfig instance - 同 turn 單一 model 假設凍結
- reasoning duration / effort 序列化於
ex:metaJSON,非正式 element
ResponseSnapshot — 回應快照¶
TurnRun 之模型原始回應快照(保留原貌,作為 trace evidence)。
ResultSnapshot — 成果快照¶
封存版的成果快照(OPTIONAL;對 ex:Result 的不可變快照)。
DecisionNote — 決策記錄¶
決策依據紀錄。MUST conditional: 攜帶 ex:decisionOutcome(DecisionOutcomeScheme)與選用的 ex:rationaleText。
ex:artifact/decisionNote/T-final a ex:Artifact ;
ex:artifactType <provai:scheme/ArtifactTypeScheme/DecisionNote> ;
ex:decisionOutcome <provai:scheme/DecisionOutcomeScheme/Adopted> ;
ex:rationaleText "在 turn 3 確認 '紋飾' 為最貼近 AAT 300010098 的中文對應..." .
SourceEvidence — 來源證據¶
Result 或 Artifact 透過 dcterms:source 指向的來源工件(case-level prompt_attachments / authoritative reference)。
ContextPack — 脈絡包¶
Per-turn 輸入脈絡集合(prov:Collection + prov:hadMember)。用於支援 CQ4(不同 turn 之間輸入脈絡的差異比對)。
ex:contextpack/T-C02-1 a prov:Collection ;
ex:artifactType <provai:scheme/ArtifactTypeScheme/ContextPack> ;
prov:hadMember ex:artifact/sourceEvidence/aat-300010098 ,
ex:artifact/promptInstance/T-C02-1 .
CaseCorpus — 案例蒐藏¶
研究級案例蒐藏(cross-case / cross-TaskRun grouping)。
用途: 作為 dcterms:source 的指向目標,當一個 Result 來自於整個 research corpus 而非單一 source。
範例:
provai:corpus-2025-aat-zh-localization— C 系列 30 件provai:corpus-2025-aat-localization-confucius-instruments— L 系列 21 案 × 4 prompt 變體 = 84 件
provai:corpus-2025-aat-zh-localization a ex:Artifact ;
ex:artifactType <provai:scheme/ArtifactTypeScheme/CaseCorpus> ;
dcterms:identifier "corpus-2025-aat-zh-localization" ;
rdfs:label "2025 AAT 中文化案例 corpus" ;
prov:hadMember ex:case/c01 , ex:case/c02 , ... .
L2-optional(5 個 inScheme 但不在 hasTopConcept)¶
L2-optional 概念需啟用對應的 L2 模組(L2-APITrace / L2-Reference)後才升為 hasTopConcept。
- Reference — 外部引用資源(活化 L2-Reference)
- ApiRequest — API 請求 payload(活化 L2-APITrace)
- ApiResponse — API 回應 payload(活化 L2-APITrace)
- ToolCall — 工具 / 函式呼叫 invocation(活化 L2-APITrace)
- ToolResult — 工具 / 函式呼叫結果(活化 L2-APITrace)
候選(pilot 後決定,附錄 F 觸發條件)¶
以下三個 artifact type 列入候選,不在當前 v0.1.1 baseline:
- LLMConversationLog(觸發條件:API 是否也產生 + turn 組合是否本身即構成它)
- ToolResult 升 L1(觸發條件:API 直連啟用 + 結構化 tool 內容外露)
- ReasoningTrace(觸發條件:OpenAI o-series
reasoning_summary外露 + ≥5 件樣本)
ContextPack vs CaseCorpus 區別¶
兩者都是「集合」,但層級不同:
| 概念 | RDF 落點 | 用途 | 粒度 |
|---|---|---|---|
ContextPack |
prov:Collection + prov:hadMember → ex:Artifactex:artifactType=ContextPack |
per-turn 輸入脈絡集合(CQ4 差異比對) | turn 級 |
CaseCorpus |
ex:Artifact + ex:artifactType=CaseCorpusprov:hadMember → ex:Artifact (case) |
研究級案例蒐藏(cross-case / cross-TaskRun grouping) | corpus 級 |