Ambient Scribe Template

The ambient-scribe template is optimized for medical transcription with automatic PII/PHI handling.

Overview

Configuration

template: ambient-scribe
config:
  stt:
    provider: whisper
    model: whisper-1
    language: en
  phi_detection:
    enabled: true
    action: redact  # or "flag"
    entity_types:
      - PERSON
      - DATE_OF_BIRTH
      - SSN
      - MEDICAL_RECORD_NUMBER
  llm:
    model: gpt-4o
    system_prompt: |
      You are a medical scribe. Convert the transcription into
      a structured clinical note with:
      - Chief Complaint
      - History of Present Illness
      - Assessment
      - Plan
  output:
    format: structured
    include_raw_transcription: false

Usage

result = await agent.tools.voice_pipeline(
    audio=consultation_audio,
    template="ambient-scribe"
)

print(result.structured_note)
# {
#   "chief_complaint": "Patient presents with...",
#   "hpi": "...",
#   "assessment": "...",
#   "plan": "..."
# }

PHI Handling

The template automatically detects and handles PHI:

{
  "phi_detected": [
    {"type": "PERSON", "text": "[REDACTED]", "original_position": 45},
    {"type": "DOB", "text": "[REDACTED]", "original_position": 120}
  ],
  "phi_action": "redacted"
}

Permissions Required

permissions:
  tools:
    - voice/transcribe
    - voice/pipeline
    - llm/chat
  models:
    - whisper-1
    - gpt-4o
  data_classification:
    - phi  # Required for medical data

Compliance

• HIPAA: Template designed for HIPAA compliance
• Audit Logging: All PHI access logged
• BAA: Requires signed BAA for production use

Customization

Override template defaults:

result = await agent.tools.voice_pipeline(
    audio=audio,
    template="ambient-scribe",
    config_override={
        "llm": {
            "model": "claude-3-5-sonnet"  # Use Claude instead
        },
        "phi_detection": {
            "action": "flag"  # Flag instead of redact
        }
    }
)

Next Steps

• Voice Agent Fast - Low-latency voice assistant
• Custom Templates - Build your own templates