ElGraph.Memory.Backend behaviour (ElGraph v0.3.0)

Copy Markdown View Source

교체 가능한 기억 백엔드 behaviour — "기억 저장 + 의미 검색" 두 동작만 추상화한다.

좁은 경계로 둔 이유: Mem0/Zep 같은 외부 메모리 서비스가 잘하는 건 remember + recall 뿐이다. ElGraph의 구조화된 사실(ElGraph.Memory의 3-스코프·시점진실·temporal·충돌해소)은 차별점이라 외부에 위임하지 않고 코어에 남긴다 — 이 behaviour는 그 위에 얹는 시맨틱 회수 층이다.

{module, config} 핸들로 디스패치한다(체크포인터/Store와 동일 패턴):

backend = {ElGraph.Memory.Backend.Mem0, api_key: "..."}
ElGraph.Memory.Backend.remember(backend, ["users", "u1"], "user upgraded to pro")
{:ok, hits} = ElGraph.Memory.Backend.recall(backend, ["users", "u1"], "what plan?")

Summary

Types

config()
handle()
namespace()

Callbacks

recall(config, namespace, query, opts)

쿼리와 의미적으로 가까운 기억들의 텍스트를 회수한다.

remember(config, namespace, text, opts)

기억 한 건을 저장한다.

Functions

recall(arg, ns, query, opts \\ [])

백엔드 핸들로 recall을 디스패치한다.

remember(arg, ns, text, opts \\ [])

백엔드 핸들로 remember를 디스패치한다.

Types

config()

@type config() :: term()

handle()

@type handle() :: {module(), config()}

namespace()

@type namespace() :: [String.t()]

Callbacks

recall(config, namespace, query, opts)

@callback recall(config(), namespace(), query :: String.t(), opts :: keyword()) ::
  {:ok, [String.t()]} | {:error, term()}

쿼리와 의미적으로 가까운 기억들의 텍스트를 회수한다.

remember(config, namespace, text, opts)

@callback remember(config(), namespace(), text :: String.t(), opts :: keyword()) ::
  :ok | {:error, term()}

기억 한 건을 저장한다.

Functions

recall(arg, ns, query, opts \\ [])

@spec recall(handle(), namespace(), String.t(), keyword()) ::
  {:ok, [String.t()]} | {:error, term()}

백엔드 핸들로 recall을 디스패치한다.

remember(arg, ns, text, opts \\ [])

@spec remember(handle(), namespace(), String.t(), keyword()) :: :ok | {:error, term()}

백엔드 핸들로 remember를 디스패치한다.