Skip to main content

Speaker targeting

Use target in conduitClient.reports.create(...) to choose which speaker is analyzed.

Strategies​

StrategyUse whenKey fields
dominantone clear primary speakerstrategy
magic_hintrole known in natural languagehint, optional onMiss
entity_idsame speaker tracked across sessionsentityId, optional onMiss
timerangespeaker in a specific segmenttimeRange, optional onMiss

Dominant speaker​

const receipt = await conduitClient.reports.create({
  source: { mediaId: "media_abc123" },
  output: { template: "general_report" },
  target: { strategy: "dominant" },
})

Magic hint​

const receipt = await conduitClient.reports.create({
  source: { url: "https://example.com/interview.mp3" },
  output: {
    template: "general_report",
    templateParams: {
      roleTitle: "Senior Software Engineer",
      roleDescription: "Backend development",
      companyCulture: "Collaborative",
    },
  },
  target: {
    strategy: "magic_hint",
    hint: "the job candidate being interviewed",
    onMiss: "fallback_dominant",
  },
  webhook: { url: "https://your-app.com/webhooks/conduit" },
})

Entity ID​

const round1Receipt = await conduitClient.reports.create({
  source: { url: "https://example.com/round-1.mp3" },
  output: { template: "general_report" },
  target: { strategy: "magic_hint", hint: "the candidate" },
})

const round1 = await round1Receipt.handle?.wait()
const entityId = round1?.entity?.id
if (!entityId) throw new Error("Entity not found")

const round2Receipt = await conduitClient.reports.create({
  source: { url: "https://example.com/round-2.mp3" },
  output: { template: "general_report" },
  target: { strategy: "entity_id", entityId },
})

Time range​

const receipt = await conduitClient.reports.create({
  source: { mediaId: "media_meeting789" },
  output: { template: "general_report" },
  target: {
    strategy: "timerange",
    timeRange: {
      startSeconds: 0,
      endSeconds: 300,
    },
    onMiss: "fallback_dominant",
  },
})

Hint quality​

  • Good: "the interviewer asking questions"
  • Good: "the potential customer or prospect"
  • Avoid: "speaker 1", "the loud one"

Best practices​

  • Default to magic_hint for multi-speaker calls.
  • Store report.entity?.id and switch to entity_id in future sessions.
  • Use onMiss: "fallback_dominant" only when best-effort fallback is acceptable.

Next steps​