FinRobot 버전 및 사용자 지정 API 가이드

실행 중인 FinRobot의 종류를 식별하세요

2026년 9월 5일 d2219100에서 검토한 공식 README는 PydanticAI, FastAPI, React/Tauri를 사용하는 FinRobot Desktop v0.1.0을 설명합니다. finrobot_equity Pro 워크플로와 오래된 AutoGen 튜토리얼도 남아 있습니다. 이들은 서로 바꿔 쓸 수 있는 구성 표면이 아닙니다. 데스크톱 릴리스는 6a8161ff의 desktop-v0.1.0으로 태그되어 있으며 master 스냅샷은 별도의 소스 식별자입니다. 실제 릴리스 또는 커밋, 진입 명령, 구성 파일을 기록하세요. 같은 저장소에 레거시 OAI_CONFIG_LIST 지침이 있다는 사실만으로 데스크톱 애플리케이션이 모델을 로드하는 방식이 확립되지는 않습니다.

문서화된 애플리케이션 경로를 비교하세요

버전 선택을 첫 번째 호환성 확인으로 다루세요. 데스크톱 문서는 오케스트레이션, 전문 리서치 역할, 결정론적 금융 계산을 설명하지만 이 검토에서는 사용자 지정 APIsRouter 엔드포인트 경로를 확립하지 않았습니다. Pro 스크립트와 레거시 Python 에이전트는 소스에 보이는 설정이 서로 다릅니다. 한 경로를 통한 성공적인 요청이 다른 경로를 인증하지는 않습니다. 설치 전에 공식 데스크톱 플랫폼 및 서명 안내도 검토하세요. 통합 튜토리얼을 완료하려고 운영체제 보안 확인을 우회하지 마세요.

Pro 스크립트에는 Pro 엔드포인트 필드만 사용하세요

현재 finrobot_equity/core/config/config.ini.example에는 openai_api_key, openai_base_url, openai_model이 포함되어 있습니다. generate_financial_analysis.py는 선택적 base URL과 모델을 읽어 텍스트 생성 경로로 전달합니다. 아래 템플릿은 확인된 필드를 조정한 것입니다. 대문자 플레이스홀더는 로컬에서 바꾸세요. 이 INI 파일이 환경 변수 보간을 지원한다는 뜻은 아닙니다. 실제 파일은 로컬 권한으로 보호하고 버전 관리에서 제외하며 지원 로그에 게시하지 마세요. 금융 데이터 키는 모델 자격 증명과 계속 분리됩니다.

[API_KEYS]
fmp_api_key = YOUR_FINANCIAL_DATA_KEY
openai_api_key = YOUR_APISROUTER_KEY
openai_base_url = https://api.apisrouter.com/v1
openai_model = CURRENT_CATALOG_MODEL_ID

명시적인 입력으로 Pro 텍스트 생성 경로를 실행하세요

기업 식별자와 보호된 구성 파일을 사용해 Pro 분석 스크립트를 실행한 다음 보고서 렌더링 전에 생성된 분석을 검사하세요. 금융 데이터 확보, 예측 가정, 수치 계산은 아래에 보이는 모델 서술 경로와 별개입니다. 국제 발행인이라면 결과를 비교하기 전에 데이터 제공업체의 거래소 커버리지, 보고 통화, 회계 기준을 확인하세요. 주식 수, 회계 기간, 통화 변환을 명시적으로 해결합니다. 처음 검사 가능한 보고서 패킷을 만드는 동안 필요한 단계만 실행하세요.

python finrobot_equity/core/src/generate_financial_analysis.py \
  --company-ticker "$RESEARCH_TICKER" \
  --company-name "$RESEARCH_COMPANY" \
  --config-file finrobot_equity/core/config/config.ini \
  --generate-text-sections

금융 계산을 재현 가능하게 유지하세요

현재 데스크톱 아키텍처는 금융 계산과 LLM 설명을 명시적으로 분리합니다. FinRobot 산출물을 검토할 때도 같은 승인 원칙을 적용하세요. 표시된 수치를 소스 입력, 단위, 가정, 이를 만든 계산까지 추적합니다. 결정론적인 가치 평가도 불확실한 예측에 의존하며 재현 가능하다고 해서 예측이 실현된다는 증거는 아닙니다. 기본 가정과 대안 시나리오를 분리하고 공식을 보존하며 모델이 목표 값을 조용히 선택하지 말고 민감도를 논의하게 하세요. 검토자가 승인된 가정을 제공할 때까지 누락된 입력은 누락 상태로 유지해야 합니다.

레거시 AutoGen 노트북을 별도 마이그레이션으로 다루세요

남아 있는 finrobot/agents/workflow.py는 AutoGen을 가져오고 llm_config를 받습니다. 레거시 튜토리얼은 OAI_CONFIG_LIST를 통해 모델 항목을 로드하고 config list를 해당 워크플로에 전달합니다. 이 경로를 유지한다면 노트북과 의존성 버전을 함께 따르세요. 최신 PydanticAI 구성을 이 경로에 옮기거나 OAI_CONFIG_LIST를 범용 FinRobot 설정으로 설명하지 마세요. 기존 보고서 프로세스를 마이그레이션하려면 base URL만 바꾸는 것이 아니라 도구, 데이터 키 로딩, 코드 실행 동작, 보고서 생성을 확인해야 합니다.

입력에서 소스 위치까지 보고서 하나를 검증하세요

범위가 정해진 공개 공시 패킷과 좁은 질문으로 시작하세요. 별도로 승인된 클라이언트 테스트 후 필요한 데이터 도구 하나, 수치 계산 하나, 인용이 있는 보고서 섹션 하나를 검증합니다. 애플리케이션 리비전, 소스 해시, 시크릿을 제외한 구성, 해결된 모델 ID, 관찰된 사용량을 기록하세요. 생성된 텍스트가 단위를 보존하고 보고된 사실과 전망을 구분하는지 확인합니다. 전송 hello나 모델 팩토리 응답은 해당 단계만 입증합니다. 완전한 보고서 승인을 위해서는 데이터 완전성, 계산 검토, 읽을 수 있는 출력, 추적 가능한 주장이 추가로 필요합니다.

단계 경계에서 예산을 관리하고 복구하세요

금융 데이터 요금, 모델 요청, 보고서 렌더링 리소스, 분석가 검토를 분리하세요. 추정에는 현재 가격을 사용한 뒤 재시도와 실패를 포함한 요청 원장을 대조합니다. API 필드가 무시되면 구성 파일을 더 추가하기 전에 정확한 진입 스크립트를 검사하세요. 보고서가 비어 있으면 모델을 바꾸기 전에 확보 및 파싱 로그를 확인합니다. 수치 입력이 충돌하면 보고서를 검토를 위해 일시 중지하고 두 소스 값을 모두 보존하세요. 수정된 단계에서 재개해 완성된 보고서가 각 변경의 이유를 보존하게 하세요.

근거와 한계

소스 및 릴리스 문서는 2026년 9월 5일 검토되었습니다. Pro 엔드포인트 필드와 전달은 d2219100에서 확인되었지만 데스크톱 사용자 지정 게이트웨이 경로는 검증되지 않았습니다. 이 가이드를 위해 APIsRouter 요청, 완전한 보고서, 측정된 사용량 사례를 실행하지 않았습니다. Pro 예시는 명시된 스크립트에 적용되며 Desktop 또는 모든 레거시 노트북에 적용되지 않습니다.

자주 묻는 질문