CMDCRAGArcana.Graph.Maintenance (cmdc_rag_arcana v0.5.0)

GraphRAG 后台索引生命周期 wrapper。

这些函数供 Oban worker、release task 或企业控制面调用。不要注册为 Agent Tool。

Summary

检测 graph communities。

为实体生成 embedding。

重建图索引。

发布前 release hook。

生成 community summaries。

@spec detect_communities(
  module(),
  keyword()
) :: {:ok, map()} | {:error, term()}

检测 graph communities。

@spec embed_entities(
  module(),
  keyword()
) :: {:ok, map()} | {:error, term()}

为实体生成 embedding。

@spec rebuild_graph(
  module(),
  keyword()
) :: {:ok, map()} | {:error, term()}

重建图索引。

@spec release_hook(
  module(),
  keyword()
) :: {:ok, map()} | {:error, term()}

发布前 release hook。

默认顺序为 rebuild graph → embed entities → detect communities → summarize communities。可通过 :steps 传入子集。

@spec summarize_communities(
  module(),
  keyword()
) :: {:ok, map()} | {:error, term()}

生成 community summaries。