Knowledge-and-Memory-Management의 버전 0.0.2는 숙련된 개발자들이 기대하는 바를 정확히 제공합니다. 즉, 이식 가능한 경로(portable path) 지원과 간소화된 지식 수집(knowledge ingestion)을 포함한 깔끔한 릴리스입니다. 모든 개인 경로는 $AGENT_HOME 환경 변수로 대체되어 환경별 설정 문제를 제거했습니다. 웹, 비디오, 기사로부터의 견고한 지식 수집에 초점을 맞추고 있으며, 검색을 위한 지속적인 메모리 계층(persistent memory layer)이 결합되어 있습니다.

아키텍처 및 이식성 (Architecture and Portability)

시스템은 collector와 memory라는 두 개의 패키지로 나뉩니다. 이제 모든 설정 가능한 경로는 기본적으로 $AGENT_HOME을 사용합니다. 이는 더 이상 /home/user/data/ 또는 /var/lib/agent/와 같은 하드코딩된 항목이 필요 없음을 의미합니다. AGENT_HOME이 설정되지 않은 경우 시스템은 플랫폼별 기본값으로 전환되지만, 컨테이너화(containerized)되거나 오케스트레이션(orchestrated)된 배포 환경에서는 이를 명시적으로 정의하는 것을 권장합니다. 지식 엔트리(knowledge entry) 모델은 모든 소스에 대해 표준화되어 있으며, source_url, media_type, raw_content, summary, embedding, timestamp를 포함합니다.

지식 수집 (Knowledge Collection)

• 웹 (Web): 웹 수집기는 동적 콘텐츠를 처리하기 위해 헤드리스 브라우저 (Playwright)를 활용합니다. 렌더링된 텍스트, 메타데이터 및 링크를 추출한 다음, 콘텐츠를 청크(chunk) 단위로 나누고 임베딩(embedding)합니다.
• 비디오 (Video): 비디오 수집은 YouTube Data API와 스크립트 추출을 사용합니다. 자막을 처리하고, NLP 모델을 통해 시간적 요약(temporal summaries)을 생성하며, 재생 시간 및 태그와 같은 메타데이터를 저장합니다.
• 기사 (Articles): 기사 파싱은 PDF 및 HTML 페이지에 대해 가독성 알고리즘(readability algorithms)을 적용합니다. 통합된 요약기 (encoder-decoder transformer)가 간결한 요약을 생성하며, 이는 릴리스 노트의 “S” 기능일 가능성이 높습니다.

모든 수집기는 collect(source: str, **kwargs) -> KnowledgeEntry라는 일관된 인터페이스를 준수합니다. 이를 통해 새로운 소스를 추가하는 것이 매우 간단해집니다.

메모리 관리 (Memory Management)

메모리는 $AGENT_HOME/memory 경로 아래의 벡터 데이터베이스 (FAISS 또는 Chroma)에 저장됩니다. 이번 클린 릴리스 (clean release)는 이전의 모든 경로 참조를 소급하여 업데이트합니다. Memory 클래스는 save, delete, update, search 연산을 지원합니다. 검색은 의미론적 검색 (semantic retrieval)을 위해 저장된 임베딩 (embeddings)에 대한 코사인 유사도 (cosine similarity)를 사용합니다. 임베딩 생성 시 배치 처리 (Batching) 및 선택적인 GPU 가속 (GPU acceleration)을 설정할 수 있습니다.

코드 예시 (Code Example)

다음은 수집 및 메모리 저장을 위해 이식 가능한 경로 (portable path)를 활용하는 방법을 보여주는 짧고 독립적인 예시입니다:

import os
from knowledge_and_memory import Collector, Memory

...

base_dir 파라미터는 모든 것을 $AGENT_HOME에 연결하여 배포를 이식 가능하게 (portable) 만듭니다. 수집기 (collectors)는 콘텐츠를 정규화 (normalize)하므로, 메모리 계층 (memory layer)은 일관된 객체를 전달받습니다.

마이그레이션 및 성능 (Migration and Performance)

기존 사용자들은 $AGENT_HOME을 참조하도록 설정 파일을 업데이트하고 절대 경로 (absolute paths)를 제거해야 합니다. 이를 자동화하기 위해 릴리스에 마이그레이션 스크립트 (migration script)가 포함되어 있습니다. 성능 측면에서, 수집 파이프라인 (collection pipelines)은 비동기적 (asynchronous)이며, 메모리 연산은 오버헤드를 줄이기 위해 배치 (batched) 처리됩니다. 벡터 데이터베이스는 낮은 지연 시간 (low latency)을 위해 인메모리 (in-memory) 방식으로 작동하거나, 내구성 (durability)을 위해 디스크에 영구 저장할 수 있습니다.

v0.0.2는 경로 문제 없이 신뢰할 수 있는 메모리가 필요한 에이전트 개발자들을 위한 실용적인 릴리스입니다. 향후 버전에서는 추가적인 소스 유형과 고급 통합 전략 (advanced consolidation strategies)을 목표로 하겠지만, 이 깔끔한 기반만으로도 지식 수집 및 메모리 관리라는 핵심 약속을 이미 실현하고 있습니다.