Back to Report Blocks

TopicAnalysis

NLP
Report block

Clusters text into topic groups using the report topic-analysis pipeline.

What It Answers

  • What topics appear in this text corpus?
  • Which examples represent each topic?
  • What keywords describe each cluster?

Use When

  • Exploring unlabeled transcript text.
  • Finding themes in free-form comments.
  • Creating a first-pass taxonomy.

Avoid When

  • You need feedback-vs-rubric contradictions.
  • You need deterministic score metrics.

Run From The CLI

Direct report commands are the simplest path for one-off usage. Saved report configurations use `plexus report config create` and `plexus report run`.

plexus report run --config "Topic Analysis" source=customer-calls sample_size=1000
plexus report config create --name "TopicAnalysis Example" --file topic-analysis.md
plexus report run --config "TopicAnalysis Example"

Minimal Configuration

class: TopicAnalysis
data:
  source: "customer-calls"
  content_column: "text"
llm_extraction:
  method: "chunk"
bertopic_analysis:
  min_topic_size: 10

Live Rendered Example

Rendered with the same dashboard component used by generated reports.

TopicAnalysis Example

Topic Analysis Results

Analysis Details

How To Interpret It

  • Topic names are descriptive labels, not final policy conclusions.
  • Review examples before acting on a cluster.