Skip to content
Last updated

Overview

The Narrative List page in Constellation displays AI-discovered narratives present within a project's data set, enabling analysts to quickly triage, filter, and prioritize narrative threats. Narratives are automatically identified by the Narrative Discovery Agent, which continuously scans project data and surfaces emerging storylines for review. In the best case scenario, a single AI narrative may represent a complete, reportable finding that can be shared with stakeholders directly.

What You Can Do

  • Browse all narratives detected in your project in a familiar inbox-style layout with infinite scroll
  • Sort narratives by risk rating, bot percentage, Compass Risk, total posts, total engagement, or total authors
  • Filter narratives using the Segment Bar with narrative-specific field syntax
  • Search narratives by title and summary using the quick search bar
  • Prioritize high-risk narratives using the default risk-descending sort order
  • Triage narratives efficiently by combining search, filters, and sorting

  1. Log in to Constellation.
  2. Select the desired Project from the project selector in the top navigation bar.
  3. Click Analyze in the top navigation menu.
  4. Select Narratives from the left sidebar.

Page Layout

The Narrative List page is organized into three primary areas:

  1. Segment Bar — Located at the top of the page; used to apply advanced filters using boolean field syntax.
  2. Narrative List Panel — The left-hand panel displaying the list of discovered narratives with summary metadata.
  3. Narrative Detail Panel — The right-hand panel displaying detailed information for the selected narrative.

Narrative Discovery Agent

The Narrative Discovery Agent automatically identifies and groups narratives from the posts in your project data set. Narratives are presented in an inbox-style format, allowing analysts to scan and triage them efficiently without manual grouping or tagging.

Note: A narrative will appear in the list if any posts within that narrative match the active search or segment criteria — not only narratives where all posts match.


Narrative List Panel

The Narrative List Panel displays each discovered narrative as a card with key metadata. Narratives are ordered according to the active sort setting. The list uses infinite scroll — as you scroll down, additional narratives are loaded automatically.

Narrative Card Metadata

FieldDescription
Narrative TitleThe AI-generated title summarizing the narrative's central claim or theme
Post CountTotal number of posts associated with this narrative
EngagementTotal engagement (reactions, shares, replies) across all narrative posts
Author CountNumber of unique authors contributing to the narrative
Narrative IDUnique system identifier for the narrative
Risk IndicatorColor-coded risk badge reflecting the narrative's overall risk rating

Sorting the Narrative List

The Narrative List can be sorted using the sort control located at the top-right of the Narrative List Panel. Click the sort icon to open the Sort by menu. All sort options support both ascending and descending order.

Available Sort Options

Sort OptionDescription
Risk RatingOrders narratives by their overall risk assessment (default: descending)
Bot PercentageOrders narratives by the percentage of posts meeting the bot-like threshold (narrative.botPostPercentage)
Compass RiskOrders narratives by the Compass Risk rating — Low, Medium, or High (narrative.compassScore)
Total PostsOrders narratives by the total number of associated posts
Total EngagementOrders narratives by the aggregate engagement across all posts
Total AuthorsOrders narratives by the number of unique authors participating in the narrative

Pro Tip: The default sort is Risk Rating descending, which surfaces the narratives most likely to pose the greatest risk at the top of the list. It is recommended to begin triage from this default view before applying additional filters.


Filtering the Narrative List

The Search bar at the top of the Narrative List Panel provides fast, keyword-based filtering. The search operates against the narrative title and narrative summary fields. It does not search the full text of individual posts.

Segment Bar Filtering

The Segment Bar at the top of the page supports advanced boolean filtering and includes narrative-specific field syntax.

To view all available narrative fields:

  1. Click into the Segment Bar boolean field input.
  2. Type narrative.
  3. The typeahead assistant will display a list of all narrative-specific fields available for filtering.

Pro Tip: Narrative-specific fields allow you to filter directly on narrative-level attributes (such as risk rating thresholds or bot score ranges), enabling more precise triage than post-level filters alone.

Combining Filters

For projects containing a large number of narratives, it is recommended to use a combination of the Segment Bar filters and sort controls together to identify emergent and evolving narratives efficiently.

Note: Segment filters and the quick search bar can be used simultaneously. The narrative list will reflect all active constraints at once.


Tips & Best Practices

For Efficient Triage

  • Start with the default sort — The risk-descending default ensures the highest-priority narratives are visible immediately upon navigating to the page.
  • Use the quick search bar for known topics — If you are monitoring a specific subject, enter relevant keywords to narrow the list to narratives whose titles or summaries mention that topic.

For Large Data Sets

  • Layer filters and sorting — Projects may contain thousands of narratives. Applying a Segment Bar filter first to narrow the scope, then sorting within the filtered results, is the most effective approach for large data sets.
  • Explore narrative-specific fields — Type narrative in the Segment Bar to discover fields that are not available for standard post-level queries, giving you finer control over which narratives are surfaced.

For Bot and Risk Analysis

  • Sort by Bot Percentage — When investigating coordinated inauthentic behavior, sorting by Bot Percentage descending highlights narratives with the highest concentration of automated activity.
  • Sort by Compass Risk — Use the Compass Risk sort to prioritize narratives flagged by Blackbird AI's analytical framework for geopolitical or influence operation risk.

Troubleshooting

"No narratives are appearing in the list"

  • Verify that a Project has been selected and that it contains ingested posts.
  • Check whether an active Segment Bar filter is too restrictive; clear or modify the filter and re-apply.
  • Confirm that the Narrative Discovery Agent has completed its initial analysis of the project data set.

"My search returns unexpected results"

  • The quick search bar only queries narrative title and narrative summary fields. If you are searching for post-level content, use the Segment Bar or navigate to the Posts page instead.
  • Ensure there are no typographical errors in the search query.

"A narrative I expect to see is not appearing"

  • Recall that a narrative appears if any of its posts match the active criteria. If the segment filter excludes all posts associated with a narrative, that narrative will not be displayed.
  • Broaden the active Segment Bar filter or clear it entirely to confirm the narrative exists in the project.

Summary

The Narrative List page provides an efficient, AI-powered interface for discovering and triaging narratives within a Constellation project. Narratives are automatically surfaced by the Narrative Discovery Agent and displayed in an inbox-style layout with infinite scroll for rapid review.

Key components and capabilities covered on this page:

  • Narrative Discovery Agent — Automatically identifies and groups narratives from project data
  • Narrative List Panel — Displays narrative cards with metadata including posts, engagement, authors, and risk indicators; supports infinite scroll
  • Sort Controls — Order narratives by risk rating, bot percentage, Compass Risk, total posts, total engagement, or total authors; ascending and descending
  • Quick Search Bar — Filters narratives by title and summary for fast topic-based lookup
  • Segment Bar — Applies advanced boolean filters including narrative-specific field syntax accessible via the typeahead assistant