Skip to content

Minutes Generation Reference

Detailed documentation of all minutes generation options and settings.

Context Field

Purpose: Provide background information to improve AI understanding.

Best practices:

  • Include meeting type (standup, review, planning)
  • List key participants and their roles
  • Define domain-specific terms
  • Mention expected topics

Examples:

Meeting TypeContext Example
Engineering standup"Daily standup for Backend team. Alice (Tech Lead), Bob (Senior Dev), Carol (Junior). Terms: PR, CI, k8s, hotfix."
Client meeting"Project status with Acme Corp. Internal: John (PM), Sarah (Dev). Client: Mike (Product Owner). Project: E-commerce redesign Phase 2."
Board meeting"Q4 Board of Directors meeting. Board: Dr. Smith (Chair), Johnson (CFO). Management: CEO, COO. Topics: Q4 financials, 2025 budget."
Interview"Technical interview for Senior Developer. Interviewers: Sarah (Hiring Manager), Tom (Team Lead). Candidate: Alex Chen."

Correct Transcript First

Purpose: Improve transcript accuracy before generating minutes.

When to enable:

  • Audio quality was poor
  • Many technical terms were misrecognized
  • Speaker names are incorrect
  • Heavy accents or fast speech

Trade-offs:

BenefitCost
Improved word accuracyAdds 30-60 seconds processing
Better speaker namesUses additional AI tokens
Cleaner source textBeta feature—may need review

When to skip:

  • High-quality recording
  • Already manually corrected
  • Short meetings (<5 minutes)
  • Time-sensitive delivery

Custom Templates

Purpose: Control the structure of generated minutes.

Default Sections

The AI pipeline can extract and fill these sections:

SectionDescription
Summary / OverviewHigh-level meeting synopsis
Attendees / ParticipantsWho was present
Action ItemsTasks with owners and deadlines
DecisionsChoices made with rationale
Discussion PointsKey topics covered
Next Steps / Follow-upsPlanned future actions

Template Syntax

Use {{placeholder}} syntax for dynamic content:

markdown
# {{title}}

**Date:** {{date}}
**Attendees:** {{attendees}}

## Summary
{{summary}}

## Decisions
{{decisions}}

## Action Items
| Owner | Task | Due Date |
|-------|------|----------|
{{action_items}}

Template Examples

Executive Summary:

markdown
# {{title}} - Executive Summary

**Date:** {{date}}
**Participants:** {{attendees}}

## Key Takeaways
{{summary}}

## Decisions Made
{{decisions}}

## Action Items
{{action_items}}

Scrum/Standup:

markdown
# Daily Standup - {{date}}

**Team:** {{attendees}}

## Updates by Person
{{discussion}}

## Blockers
{{blockers}}

## Action Items
{{action_items}}

Client Meeting:

markdown
# Client Meeting Minutes

**Client:** [Client Name]
**Date:** {{date}}
**Attendees:** {{attendees}}

## Purpose
{{summary}}

## Discussion
{{discussion}}

## Agreed Actions
{{action_items}}

## Decisions
{{decisions}}

## Next Steps
{{next_steps}}

Template Limitations

Templates work best when they align with what the AI extracts. The pipeline extracts fixed elements from transcripts:

Supported (will be filled):

  • Action items (with owners, deadlines, status)
  • Decisions (with rationale)
  • Key discussions and topics
  • Attendees/participants
  • Status updates
  • Follow-ups and next steps
  • Meeting metadata

Not supported (may be empty):

  • Risk assessment
  • Budget analysis
  • Sentiment analysis
  • Legal review
  • Custom KPIs

WARNING

Custom sections requesting analysis beyond extraction scope will result in empty content or potential hallucinations. Stick to extractable elements for reliable results.

Output Format

Available formats:

FormatExtensionUse Case
Word.docxSharing, printing, formal documentation
Markdown.mdWiki, technical documentation, further processing
Plain text.txtSimple archives, email pasting, universal compatibility
AutovariesSystem chooses based on template (recommended)

Format recommendations:

  • Use Word for distribution to non-technical stakeholders
  • Use Markdown for technical teams or wiki integration
  • Use Auto when using custom templates (matches template format)

Verbosity

Levels:

LevelDescriptionBest For
ConciseKey points only, minimal detailExecutive summaries, quick updates
NormalBalanced coverage (default)Standard meeting notes
DetailedComprehensive, includes contextLegal records, thorough documentation

Examples:

Concise action item:

  • John: Deploy to staging (Friday)

Normal action item:

  • John will deploy the updated API to staging by Friday to enable QA testing

Detailed action item:

  • John (Backend Lead) committed to deploying the updated REST API v2.1 to the staging environment by end of day Friday, January 31st. This deployment is necessary before QA can begin their testing cycle scheduled for the following week. Dependencies: Database migration must complete first.

Progress Steps

The 8-step agentic pipeline:

StepNameDescriptionTypical Duration
1SegmentIdentify topic boundaries in transcript5-10s
2Extract (Per-Segment)Extract items from each topic (parallel)15-30s
3Extract (Global)Find meeting-level items spanning topics5-10s
4Verify ExtractionsSecond pass for missed items5-10s
5MergeCombine and associate items with topics2-5s
6Verify ClaimsCheck claims against source transcript10-20s
7OrganizeMap extracted data to template structure2-5s
8WriteGenerate polished final document10-15s

Total typical time: 30-90 seconds depending on transcript length

Pipeline Features

  • Source traceability: Each claim includes source indices and quotes
  • Faithfulness scoring: Claims verified with score 0-1
  • Speaker attribution confidence: Tracks confidence in owner assignments
  • Anti-hallucination grounding: Explicit examples in prompts prevent fabrication
  • Parallel extraction: Step 2 processes segments simultaneously (4 workers)
  • Conditional verification skip: Step 6 skipped when extraction confidence ≥ 0.85

Performance Optimizations

  • Parallel per-segment extraction: 4 workers process segments simultaneously
  • Conditional claim verification: Skipped when aggregate confidence is high
  • Per-segment limits: Long segments (>12K chars) get smart truncation
  • No upfront truncation: Full transcript processed via per-segment extraction

Expected improvement: ~40% reduction in total pipeline time for typical meetings

Troubleshooting

Empty Sections

Causes:

  • Meeting didn't contain that information type
  • Template requested unsupported content
  • Information wasn't explicitly stated

Solutions:

  • Check if transcript actually contains action items, decisions, etc.
  • Use templates that match the meeting content
  • Add context to help AI recognize relevant content
  • Try "Detailed" verbosity to capture more information

Inaccurate Speaker Names

Causes:

  • Original transcript had misrecognized names
  • Speakers not identified in audio
  • Similar-sounding names confused

Solutions:

  • Enable "Correct transcript first" option
  • Include speaker names in context field: "Participants: John Smith (PM), Sarah Chen (Dev Lead)"
  • Edit transcript before generating minutes

Missing Action Items

Causes:

  • Actions weren't explicitly stated in meeting
  • Owners not mentioned by name
  • Implicit assignments not captured

Solutions:

  • Add participant names and roles to context
  • In future meetings, be explicit: "John will handle X by Friday"
  • Use "Detailed" verbosity to capture implicit items

Processing Errors

Causes:

  • Server under high load
  • Very long transcript timeout
  • Network interruption

Solutions:

  • Wait a moment and retry
  • For transcripts >2 hours, consider splitting
  • Check transcript has actual content (not empty)
  • Verify network connectivity

Wrong Language Output

Causes:

  • System detected wrong source language
  • Mixed-language transcript confused detection

Solutions:

  • Specify language in context: "Meeting in German"
  • Ensure transcript language setting is correct

Token Usage

Minutes generation tracks AI token consumption:

  • Metrics: stenoris_ai_input_tokens_total{feature="minutes"}, stenoris_ai_output_tokens_total{feature="minutes"}
  • Factors affecting usage: Transcript length, verbosity level, number of topics

Token-efficient practices:

  • Use "Concise" verbosity when detailed notes aren't needed
  • Split very long meetings (>2 hours) into separate transcripts
  • Avoid "Correct transcript first" if transcript quality is already good