🧠 Agentica 기반 자산 시장 및 경제 성장률 보고서 자동화 시스템 기획

1. 개요 및 목적

본 시스템은 WrtnLabs의 오픈소스 멀티에이전트 프레임워크인 Agentica를 기반으로, 사용자 자산 정보를 입력받아 시장 분석 + 경제 성장률 평가 + 요약 보고서를 자동으로 생성하는 지능형 에이전트 시스템을 설계합니다.

Agentica의 FSM 기반 상태 관리, 구조화된 memory 저장, Tool 호출 체계를 활용해, 확장성과 유지보수성을 모두 확보합니다.

2. 핵심 기능 요약

기능 설명

자산별 시장 분석	실시간 시세, 감성지수, 거래량 등을 API 연동을 통해 분석
경제 성장률 수집	관련 산업/국가의 최신 성장률 및 전망 데이터 통합
보고서 자동 생성	자산별 요약, 시장전망, 리스크요인 등을 포함한 리포트 작성
FSM 기반 흐름 제어	Agentica의 상태 전이 기반 흐름 관리
툴 체계화	외부 API 또는 분석 함수를 Tool로 등록해 호출

3. 시스템 구성 구조 (Agentica 관점)

✅ Agent 정의 방식

Agent는 다음과 같은 FSM 상태 기계 구조를 따릅니다:

collect-input: 유저 자산 입력을 받아 memory에 저장
fetch-market: 자산별 실시간 시장 데이터 수집
fetch-economy: 관련 산업/국가의 성장률 정보 수집
generate-report: 종합 요약 및 보고서 생성
done: 최종 응답 전달

✅ Tool 구조

각 FSM 상태에서 호출되는 기능은 Tool로 분리되며, 다음과 같이 등록됩니다:

fetchMarketData: 주식, 부동산, 예금, 가상자산의 시장 상태 조회
fetchEconomicIndicators: 각 자산과 연결된 산업/국가 성장률 정보 수집
generateAssetReport: 보고서 작성, 리스크 요인 및 요약 포함

4. 에이전트 처리 흐름 요약

User Input
  ↓
[collect-input] ➜ memory.assets 저장
  ↓
[fetch-market] ➜ Tool: fetchMarketData
  ↓
[fetch-economy] ➜ Tool: fetchEconomicIndicators
  ↓
[generate-report] ➜ Tool: generateAssetReport
  ↓
Response (완성된 보고서)

5. 실무 적용 전략

1단계: 에이전트를 추가 제거, 자산의 성질을 선택하는 기능 구축 (nest js)
2단계: 에이전트 FSM + Tool 모듈 기반 기초 동작 구축
3단계: 외부 API 연동 확장 (금융, 실물자산, 성장률 등)
4단계: Redis Pub/Sub 또는 SSE 기반 실시간 응답 최적화
5단계: 사용자 맞춤 리포트 및 Agent Multi-Session 관리 구조 도입

6. 결론

Agentica 기반 자산 시장 분석 에이전트 시스템은:

상태 기반 FSM 처리로 구조화된 자동화 가능
툴 기반 기능 호출로 유지보수 용이성 확보
확장성과 실시간성 요구를 단계적으로 수용 가능

을 목표로 진행할 예정