How to Start Generating Insights

Insights are the data points Harmony extracts from your conversations. They live inside Projects, which group Insight Definitions (the questions you want to ask) with Project-owned Dynamic Collections that decide which conversations enter the Project.

Open or create a project

In the sidebar, open Data Lake and pick an existing project. If you don't have one yet, see How to set up a project.

A project's tabs follow this layout:

• Reports — generated insight cards and charts.
• Configuration — the list of Insight Definitions that run for the project.
• Dynamic Collections — the Project-owned Collections that decide which conversations enter the Project.
• Teams — ownership and reporting context; add a Team condition inside a Dynamic Collection when routing should be Team-specific.
• Revisions — reruns of past conversations (only visible when enabled for your workspace).
• Basics — name, language, Project Knowledge, teams.

Decide which conversations are in scope

Open Dynamic Collections to choose which conversations are in scope. Each Collection belongs to this Project, and a conversation enters the Project if it matches any Collection. A Project with no Dynamic Collections receives no conversations.

Select Add Dynamic Collection, give it a clear name, and use Add filter for conversation details such as Team, tags, or duration. For questions that require understanding the transcript, use AI Checks and select Create new AI check. Open Advanced only when you need OR or grouped conditions, then select Save.

For a five-minute walkthrough with examples, see Dynamic Collections.

Add an Insight Definition

Open the Configuration tab (?tab=configure). This is where you add and manage the questions Harmony will answer for every in-scope conversation.

1. Click the + button at the top right of the tabs row.
2. Step 1 — Pick a type. Harmony shows the catalogue grouped by category (Most Popular, Custom, Built-in) with descriptions and supported report-type badges.
3. Step 2 — Configure. The form is dynamic per type. The right-hand column always includes a Project Knowledge panel so you can add or edit project knowledge from this flow without leaving it.
4. Most types accept an optional Additional Context string. This is appended to the prompt for this single definition alongside Project Knowledge — useful for instructions that apply only to one definition.
5. Click Create to save. The button stays disabled until the type-specific minimum is filled.

Insight types you can create

Harmony ships with 12 definition types in 3 categories.

Most Popular

• Summary — a short, structured summary of the conversation with key points and action items. No configuration required.
• Competitors Analysis — list of competitors mentioned, with positioning and advantages. You can pre-define Known Competitors to look for and Excluded Names that should never be flagged.
• Discount — detects whether a discount was mentioned and, when relevant, captures the rate.
• Buyer Engagement — fixed 0–10 score with built-in interpretation per band (8–10 strong engagement, 6–7 shows interest, 0–5 limited engagement). No configuration required.

Custom

• Open Question — free-text question, free-text answer per conversation.
• Yes/No Question — a question with a Yes/No answer. You can choose which answer counts as the positive (green) outcome in reports — useful when "No" is the desired answer.
• Checklist — a list of items the AI checks for. Each item gets a Yes / No / Unsure answer with a reason.
• Markdown — a free-text custom prompt that runs against the conversation. The reply is rendered as Markdown.
• Group — a list of named buckets (with descriptions). The AI assigns each conversation to one bucket.
• Scale Rating — a configurable numeric scale (default 1–5, configurable min/max) with optional labels per value.

Built-in

• Funnel — tracks which stages of a sales funnel were reached during the conversation.
• SPIN Improvement — suggests how to improve the rep's use of SPIN selling.
• SPIN Distribution — distribution of Situation / Problem / Implication / Need-Payoff questions in the conversation.

Both produce a numeric score, but they are different. Buyer Engagement is fixed 0–10 with built-in band guidance — the score does not adapt by team type. Scale Rating is fully configurable — you choose the range and the labels.

Manage existing definitions

The Configuration tab lists every definition in the project. From there you can:

To manage existing insight definitions within your project, you have several options, each accessible from the Configuration tab.

If you wish to change the name of an insight definition, simply click on the definition’s current name. This action makes the name field editable, allowing you to type in a new name directly and save your changes immediately.

To change the order in which definitions are displayed, look for the handle icon next to each row. You can click and drag a definition to a new position in the list. The order you set here determines how insight cards are presented on the Reports tab, giving you control over which insights appear most prominently.

If you find that a particular definition is temporarily not relevant, or you want to stop collecting new data for it without losing the existing results, you can pause it. This is done by toggling the active state for that definition. Once paused, the definition will not run on any new conversations, but all previous results remain available. At any time, you can resume the definition, making it active again for future conversations.

When you need to permanently remove a definition from your project, you can delete it. Deleting a definition is irreversible and removes both the definition itself and all of its associated insight results across conversations, so proceed with caution if you choose this action.

Finally, if you want to dive deeper into how a definition is performing across multiple conversations, simply click on its row. This opens the detailed report view, letting you analyze aggregated results and trends for that particular insight definition.

In summary, these management actions are designed to give you flexibility and full control over your project’s definitions, letting you adapt your reporting and insights as your needs evolve.

Re-activating a paused definition does not automatically re-run it on past conversations. To back-fill, see Reports and exports for the Revisions / rerun flow.

Reprocess a single conversation

If you change definitions, Dynamic Collections, or project knowledge after a conversation has already been processed, the existing results don't update automatically. You can reprocess that single conversation:

1. Open the conversation.
2. Use the ⋯ action menu next to the title.
3. Pick the option that restarts from extraction or insights.

For project-wide reruns of past conversations, see the Revisions flow in Reports and exports.

View the results

Once configured, results appear in two places:

• Meeting level: open any meeting and switch to the Data Lake tab to see specific answers for that conversation, grouped by project.
• Reports tab: each project's Reports tab shows aggregated charts and metrics. Use the Display dropdown to switch between Graphs and List.

Best practices

• Start simple. A handful of high-quality definitions beats dozens of vague ones.
• One question per definition. "Did the buyer ask about pricing AND mention competitors?" is two definitions.
• Use the right type. A Yes/No question gives a clean graph; an Open Question is more flexible but harder to chart.
• Use Project Knowledge for context that applies to every definition (product names, methodology). Use Additional Context for instructions that apply to one definition only.

Think of custom insights as asking the AI a question. Start with "What do I want to know?" and phrase it the way you would for a teammate.