ADR
-
Agent Memory Architecture: Retrieval System과 Knowledge Container 선택 가이드Knowledge Base/Foundations 2026. 2. 7. 14:43
Author: Claude Opus 4.6, mangowhoiscloudPurpose: Agent Memory Architecture 비교 분석 Knowledge BaseDate: 2026-02-07Executive SummaryAgent 시스템의 메모리 구현 방식은 기술 선택을 넘어 아키텍처 철학의 문제입니다. Vector DB + RAG와 파일/MD 기반 메모리는 흔히 비교 대상으로 거론되지만, 본질적으로 retrieval system과 knowledge container로서 역할이 구분됩니다. 본 문서는 4가지 핵심 축(Retrieval Complexity, Latency & Cost, Knowledge Freshness, Cognitive Load)으로 두 접근 방식을 비교하고, Layered M..
-
ADR: LangGraph Channel Separation이코에코(Eco²) Context/Plans 2026. 1. 18. 16:42
Status: ReadyCreated: 2026-01-18Author: Opus 4.5, mangowhoiscloudRelated (Internal): langgraph-native-streaming-adr, chat-worker-production-architecture-adr문제 상황StateGraph(dict) + Send API 병렬 실행 시 InvalidUpdateError 발생langgraph.errors.InvalidUpdateError: At key '__root__': Can receive only one value per step.Use an Annotated key with a reducer.Root Cause현재: graph = StateGraph(dict) (untyped)각 노드..
-
ADR: Info Service 3-Tier Memory Architecture이코에코(Eco²) Context/Plans 2026. 1. 17. 02:39
상태: In-Progress일자: 2026-01-17관련 ADR: info-service-adr.md 리뷰 히스토리: Info Service ADR 초안 작성 - Redis-Only의 한계 분석 및 3-Tier 제안 1. OverviewInfo 서비스의 뉴스 수집 → 저장 → 캐싱 파이프라인(Redis-Only) 초안으로는 API Call Limits 내 무한 스크롤을 구현 및 운영하기엔 한계가 명확하다고 판단, Persist Layer(Postgres) 추가 및 Read/Write 저장소 분리를 거치며 메모리 계층을 고도화 했습니다.1.1 핵심 설계 원칙Write/Read 분리Worker가 수집/저장, API가 조회만 담당Eventual Consistency5분 주기 갱신으로 최신성과 안정성 균형G..
-
ADR: Info Service - News 피드 API Draft이코에코(Eco²) 2026. 1. 17. 02:37
환경/에너지/AI 관련 뉴스를 Perplexity 스타일로 제공하는 서비스작성일: 2026-01-16최종 수정: 2026-01-17상태: Approved (Infrastructure Provisioned)1. 개요1.1 목적Eco² 앱에서 환경, 에너지, AI 관련 뉴스/시사 정보를 무한스크롤 피드로 제공.1.2 우선순위뉴스 피드 APIP0무한스크롤 지원한국 뉴스P0네이버 검색 API해외 뉴스P1NewsData.io API카테고리 필터P1환경, 에너지, AI, 전체실시간 갱신P2캐시 TTL 기반1.3 비목표 (Non-Goals)뉴스 영구 저장 (PostgreSQL) - 시의성 있는 데이터, 캐시로 충분사용자별 개인화 - MVP 이후 고려뉴스 요약/분석 (LLM) - MVP 이후 고려푸시 알림 - MVP ..
-
ADR: Agentic Chat Worker Production Ready이코에코(Eco²) Context/Plans 2026. 1. 16. 06:58
상태: Reviewed (타임아웃 검증 완료)일자: 2026-01-16관련 ADR (Internal)multi-intent-enhancement-adr.mdchat-worker-prompt-strategy-adr.md리뷰 히스토리:| 2026-01-16 | 초안 작성 (5가지 리뷰 피드백 반영) | 2026-01-16 | 타임아웃 검증: 실제 클라이언트 구현 기반으로 NodePolicy 테이블 수정, P0 항목 추가1. OverviewChat Worker의 "의도 분류 → 라우팅 → 병렬 실행 → 집계 → 답변" 파이프라인이 Production 레벨 부하를 견디도록 안정적으로 운영하기 위한 ADR입니다.1.1 핵심 설계 원칙Fail-Safe부분 실패 시에도 서비스 유지Observable각 단계의 상태/지..
-
ADR: Chat Worker Prompt Strategy이코에코(Eco²) Context/Plans 2026. 1. 14. 17:40
작성일: 2026-01-14상태: Proposed 📋관련 서비스: chat_worker 📋 Executive Summary본 ADR은 Eco² 챗봇 chat_worker의 Answer 노드 프롬프트 전략에 대한 아키텍처 의사결정을 문서화합니다.핵심 결정사항:프롬프트 구조: 단일 통합 프롬프트 → 하이브리드 (Global + Local) 프롬프트Intent별 지침: 코드 내장 → 외부 파일 분리 + 동적 로딩Answer 합성: 단일 템플릿 → 컨텍스트 인젝션 기반 동적 합성1. 배경1.1 현재 구조# 현재: 단일 시스템 프롬프트 (answer_node.py)ANSWER_SYSTEM_PROMPT = """너는 "이코"야, Eco² 앱의 친절한 분리배출 도우미.## 성격- 친절하고 귀여운 말투- 환경 보호..
-
이코에코(Eco²) Agent #0: LangGraph 기반 클린 아키텍처 초안이코에코(Eco²)/Agent 2026. 1. 13. 02:04
Intent-Routed Workflow with Subagent 패턴으로 설계한 LangGraph 기반 Chat 서비스 아키텍처 초안SSE 스트리밍, 컨텍스트 격리, 멀티 모델 지원1. 배경과 목표1.1 기존 구조의 한계기존 domains/chat 서비스는 다음과 같은 문제가 있었습니다:문제설명단일 파이프라인이미지/텍스트 구분 없이 동일한 처리 흐름의도 분류 부재모든 요청을 폐기물 질문으로 처리UX 피드백 없음처리 진행 상황을 사용자에게 알릴 수 없음모델 하드코딩OpenAI만 지원, 멀티 모델 확장 어려움1.2 목표LangGraph 도입: 조건부 분기가 가능한 파이프라인 구축Intent-Routed + Subagent: 의도 기반 분기 + 복잡한 질문 컨텍스트 격리SSE 스트리밍: 실시간 진행 상황 및..
-
ADR: Workflow Pattern Decision for Chat이코에코(Eco²) Context/Plans 2026. 1. 13. 01:56
LangGraph Workflow/Agent 패턴 분석을 통한 Chat 서비스 아키텍처 선택참고: LangGraph Workflows + Agents 1. 개요1.1 Workflow vs Agent흐름사전 정의된 코드 경로LLM이 동적으로 결정예측 가능성높음낮음디버깅용이어려움적합한 작업구조화된 작업탐색적 작업Workflow:A → B → C (고정된 경로)Agent:LLM ⇄ Tool ⇄ LLM (동적 루프)1.2 Chat 서비스 요구사항이미지 분류폐기물 이미지 → 분류 → 규정 → 답변필수텍스트 질의의도 분류 → RAG → 답변필수실시간 피드백SSE로 진행 상황 스트리밍필수멀티 모델GPT, Gemini 지원필수복잡한 질의멀티 카테고리 질문 처리향후2. LangGraph 패턴 분석2.1 Prompt Ch..