Repolode
neo4j-labs

neo4j-labs/agent-memory

Neo4j를 기반으로 대화 내용을 저장하고 지식 그래프를 구축하며 추론 과정을 기록하는, AI 에이전트용 그래프 네이티브 메모리 시스템입니다.

스타
588
포크
109
열린 이슈
104
마지막 커밋
그저께

어떤 프로젝트인가요?

Neo4j Agent Memory는 AI 에이전트에 세 가지 계층으로 구성된 영구 메모리를 제공합니다. 대화와 메시지를 위한 단기 메모리, 지식 그래프에 저장되는 엔티티·선호도·사실을 위한 장기 메모리, 그리고 향후 비슷한 작업에서 검색할 수 있는 의사 결정 및 도구 사용 기록을 위한 추론 메모리입니다.

설정 가능한 파이프라인을 통해 spaCy, GLiNER2.5 또는 LLM으로 메시지에서 엔티티를 추출하고, 유형이 지정된 관계와 엔티티 해소를 이용해 중복 항목을 통합합니다. 백엔드는 두 가지입니다. API 키만 있으면 되는 호스팅 NAMS 서비스와 Neo4j 또는 AuraDB에 직접 연결해 원하는 임베딩 및 LLM 제공자를 사용할 수 있는 자체 호스팅 bolt 백엔드입니다.

또한 Claude Desktop 및 Cursor 같은 어시스턴트에서 메모리를 도구로 사용할 수 있도록 MCP 서버를 제공하고, LangChain, Pydantic AI, Google ADK, CrewAI, LlamaIndex 및 기타 프레임워크용 어댑터와 동일한 메모리 모델을 공유하는 Python 및 TypeScript SDK도 제공합니다.

핵심 기능

  • 01세션별 대화 기록을 저장하고 벡터 검색과 텍스트 검색을 지원합니다.
  • 02엔티티 해소 및 중복 제거 기능으로 엔티티, 선호도, 사실의 지식 그래프를 구축합니다.
  • 03추론 과정과 도구 사용을 기록하고 과거의 유사한 작업을 검색합니다.
  • 04핵심 및 확장 프로필을 통해 메모리를 MCP 도구로 제공합니다.
  • 05호스팅 NAMS 서비스 또는 자체 호스팅 Neo4j 백엔드에서 사용할 수 있는 Python 및 TypeScript SDK를 제공합니다.
  • 06OpenAI, Anthropic, Bedrock, LiteLLM을 비롯한 여러 임베딩 및 LLM 제공자를 지원합니다.

활용 사례

  • 세션이 바뀌어도 챗봇이나 어시스턴트가 사용자 선호도를 기억하게 하기.
  • 자체 대화에서 구축한 지식 그래프를 바탕으로 답변하는 에이전트 만들기.
  • 유사한 작업에서 에이전트의 과거 추론 단계를 감사하고 재사용하기.
  • MCP 서버를 통해 Claude Desktop 또는 Cursor에 영구 메모리 추가하기.

빠른 시작

  1. 1

    호스팅 NAMS 서비스에 가입하고 API 키를 복사합니다

  2. 2

    NAMS를 지원하는 SDK를 설치하고 API 키를 환경 변수로 설정합니다

    pip install 'neo4j-agent-memory[nams]==0.7.0'
  3. 3

    대화를 만들고 메시지를 추가하는 Python 예제를 실행합니다

사용 전 알아둘 점

  • 공식적으로 Neo4j Labs 프로젝트이며, SLA나 하위 호환성을 보장하지 않습니다.
  • 상태는 Beta이며 릴리스에 따라 API가 변경될 수 있습니다.
  • 호스팅 NAMS를 사용하려면 가입과 API 키가 필요하며, 자체 호스팅 Bolt에는 Neo4j 데이터베이스와 모델 제공업체 키가 필요합니다.
  • NAMS와 Bolt 백엔드에서는 일부 기능과 메서드가 다릅니다.

토픽

자주 묻는 질문

agent-memory은(는) 무엇인가요?
Neo4j를 기반으로 대화 내용을 저장하고 지식 그래프를 구축하며 추론 과정을 기록하는, AI 에이전트용 그래프 네이티브 메모리 시스템입니다. Neo4j Agent Memory는 AI 에이전트에 세 가지 계층으로 구성된 영구 메모리를 제공합니다. 대화와 메시지를 위한 단기 메모리, 지식 그래프에 저장되는 엔티티·선호도·사실을 위한 장기 메모리, 그리고 향후 비슷한 작업에서 검색할 수 있는 의사 결정 및 도구 사용 기록을 위한 추론 메모리입니다.
agent-memory은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
agent-memory은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
agent-memory은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. agent-memory의 마지막 커밋은 2026년 10월 19일입니다.
agent-memory은(는) 어디에 사용할 수 있나요?
세션이 바뀌어도 챗봇이나 어시스턴트가 사용자 선호도를 기억하게 하기. 자체 대화에서 구축한 지식 그래프를 바탕으로 답변하는 에이전트 만들기. 유사한 작업에서 에이전트의 과거 추론 단계를 감사하고 재사용하기. MCP 서버를 통해 Claude Desktop 또는 Cursor에 영구 메모리 추가하기.
agent-memory는 어떻게 설치하나요?
호스팅 NAMS 서비스에 가입하고 API 키를 복사합니다 NAMS를 지원하는 SDK를 설치하고 API 키를 환경 변수로 설정합니다: pip install 'neo4j-agent-memory[nams]==0.7.0' 대화를 만들고 메시지를 추가하는 Python 예제를 실행합니다
agent-memory은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/neo4j-labs/agent-memory

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트