analysis

엔진 역할

analysis는 단일 기업을 재무제표의 인과 구조로 읽는 L2 엔진이다. 이 엔진은 매출과 비용, 자산과 부채, 현금흐름, 수익성, 성장성, 안정성, 효율성, 가치평가, 지배구조, 전망 신호를 축별로 계산하고 해석한다.

담당하는 질문은 "이 회사는 무엇으로 돈을 벌고, 그 돈은 진짜 현금으로 남고, 그 성장은 지속 가능하며, 지금 가격은 어느 정도인가"이다. 시장 전체 매크로 전망은 engines.macro, 신용등급/부도위험 중심 평가는 engines.credit, 여러 종목을 찾는 작업은 engines.scan, 최종 보고서 조합은 engines.story가 담당한다.

공개 호출 방식

기본 호출은 Company.analysis()이다. 축을 모르면 먼저 가이드를 보고, 축을 알면 group과 axis를 지정한다.

import dartlab

c = dartlab.Company("005930")

# 1. 전체 분석 축 가이드
guide = c.analysis()

# 2. 그룹 가이드 또는 그룹 내 계산 항목 확인
financial = c.analysis("financial")

# 3. 특정 분석 축 실행
profitability = c.analysis("financial", "수익성")
cashflow = c.analysis("financial", "현금흐름")
valuation = c.analysis("valuation", "가치평가")
forecast = c.analysis("forecast", "매출전망")

# 4. 축 이름만으로 실행 가능한 경우
profitability = c.analysis("수익성")

# 5. 모듈 함수형 호출 — Company 객체는 company= keyword (positional 3 번째 안 받음)
profitability = dartlab.analysis("financial", "수익성", company=c)
valuation = dartlab.analysis("valuation", "가치평가", company=c)
# stockCode 단독 호출도 가능
profitability = dartlab.analysis("financial", "수익성", stockCode="005930")

노트북이나 MCP에서 사람이 따라 할 때도 같은 순서로 쓴다. 먼저 c.analysis()로 가능한 축을 확인하고, 그 다음 실제 축을 호출한다.

강행 호출 룰 (agent 답변 품질 회귀 차단)

22 axis 질문 (수익성·밸류에이션·안정성·효율성·종합평가·이익품질·자본배분·성장성 등) 에서 다음 4 룰은 강행이다 — 위반 시 refs=0 회귀로 답변 품질 65 점 이하 하락.

1. 1 차 도구는 EngineCall 강제. axis 명이 질문에 있거나 22 axis 가이드 표에 매칭되면 EngineCall(apiRef="Company.analysis", args={...}) 또는 EngineCall(apiRef="Company.panel", args={...}) 가 첫 호출. RunPython 직접 ratio 계산은 engine 호출 결과가 부재할 때만 fallback — 처음부터 raw 계산 금지.

   이유: EngineCall 결과 dict 는 @tagConfidence 데코레이터로 tableRef·valueRef·dateRef·executionRef 자동 발급. RunPython 은 raw eval — refs 0 발급. 답변 본문 인용 가치체인이 깨진다.

2. 본문 안 모든 숫자에는 inline ref 표기 필수. 형식: 13.07% [ref:vr_...] 또는 [tableRef: tr_...]. ref 없는 숫자는 답변에 적지 않거나 "EngineCall 재시도 필요" 명시.

3. dataAsOf 확인 → 답변 첫 줄 명시. 결과 dict 의 dataAsOf 가 stale (3 분기 이상 전) 이면 "현재 시점 단정 X — dataAsOf 기준" 명시.