이 스킬
Citation Format — evidence ref 표준 format
dartlab 답변 안 evidence ref 인용 표준 format — markdown footnote / JSON-LD / Anthropic Citations API 호환 변환. workbenchEvidenceFlow SSOT 의 ref 형태 → 사용자 보기 좋은 format.
이어 가기
절차
실행 순서
- 1
`[valueRef:<axis>@<target>@<period>]` — 숫자 인용
- 2
`[tableRef:<table_id>]` — 표 인용
- 3
`[dateRef:<YYYY-MM-DD>]` — 시점 명시
- 4
`[docRef:<rcept_no>]` — 공시 본문
4 format
1. Inline ref (기본)
영업이익 21% [valueRef:opMargin@005930@2024Q3] (출처 [tableRef:dartlab.is.005930.2024Q3]) [valueRef:<axis>@<target>@<period>]— 숫자 인용[tableRef:<table_id>]— 표 인용[dateRef:<YYYY-MM-DD>]— 시점 명시[docRef:<rcept_no>]— 공시 본문
2. Markdown footnote
영업이익 21%[^1] 도달.
[^1]: 출처: DART 005930 2024Q3 IS — `dartlab.Company("005930").show("IS", freq="Q")` 결과의 operating_profit / sales 비율 3. JSON-LD (외부 통합)
{
"@context": "https://schema.org",
"@type": "Claim",
"value": 0.21,
"unit": "%",
"source": {
"@type": "Dataset",
"name": "DART 005930 IS Q3 2024",
"url": "dartlab://company/005930/is/2024Q3"
},
"executionRef": "20260528-001",
"skillRef": "engines.analysis.profitability"
} 4. Anthropic Citations API 호환
{
"content": "영업이익 21%",
"citations": [{
"type": "char_location",
"cited_text": "operating_profit / sales = 0.21",
"document_index": 0,
"start_char_index": 0,
"end_char_index": 33
}]
} 강행 룰
- 모든 숫자 claim → inline ref 강행.
- 외부 본문 인용 → untrusted wrap 마커 + sourceRef 동행.
- footnote / JSON-LD 는 사용자 요청 시 변환.
기본 검증
ref 형식 자동 검증 — EvidenceGate 가 ref 누락 시 답변 거부. format 변환은 별 도구 (SaveArtifact 측).
런타임
실행 환경별 호환성
| 환경 | 상태 | 비고 / 제한 |
|---|---|---|
| Local Python | supported | — |
| Server | supported | — |
| MCP | supported | — |
| Web AI | supported | — |
| Pyodide | limited | — |