mix arcana.graph.summarize_communities (Arcana v3.0.0)

Copy Markdown View Source

Generates LLM summaries for knowledge graph communities.

Use this after detecting communities to generate natural language summaries that provide high-level context for global queries.

$ mix arcana.graph.summarize_communities

Options

  • --collection - Only summarize communities for the specified collection
  • --force - Regenerate all summaries, not just dirty ones
  • --concurrency - Number of parallel summarization tasks (default: 1)
  • --levels - Hierarchy levels to summarize: all or a comma-separated list (default: the levels ask reads, community_summary_level)
  • --quiet - Suppress progress output

Examples

# Default usage (summarize dirty communities)
mix arcana.graph.summarize_communities

# Summarize a specific collection
mix arcana.graph.summarize_communities --collection my-docs

# Force regenerate all summaries
mix arcana.graph.summarize_communities --force

# Summarize every hierarchy level, not just the readable ones
mix arcana.graph.summarize_communities --levels all

# Parallel summarization (4 concurrent tasks)
mix arcana.graph.summarize_communities --concurrency 4

# Quiet mode
mix arcana.graph.summarize_communities --quiet

Requirements

This task requires an LLM to be configured. Supported formats: config :arcana, :llm, "openai:gpt-4o-mini" config :arcana, :llm, {"openai:gpt-4o-mini", api_key: "..."} config :arcana, :llm, fn prompt, context, opts ->

{:ok, MyApp.LLM.complete(prompt)}

end