跳轉到

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 對應一個 ModelConfig artifact instance(不是 case-level audit summary)
  • assistant-onlymsg.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 — 來源證據

ResultArtifact 透過 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:Artifact
ex:artifactType=ContextPack
per-turn 輸入脈絡集合(CQ4 差異比對) turn 級
CaseCorpus ex:Artifact + ex:artifactType=CaseCorpus
prov:hadMember → ex:Artifact (case)
研究級案例蒐藏(cross-case / cross-TaskRun grouping) corpus 級