Back to Voice Agents

In this article

Overview

Context is the background information that guides how your voice agent responds to callers. Well-crafted context ensures your voice agent has the knowledge it needs to accurately represent your healthcare organization and provide helpful responses to callers. This guide will walk you through the process of setting up effective context for your voice agents.

Why Context Matters

Context provides your voice agent with essential information about:

  • Your Organization: Who you are and what services you provide
  • Communication Guidelines: How to interact with callers appropriately
  • Domain Knowledge: Specific healthcare information relevant to your practice
  • Operational Details: Hours, procedures, and policies callers might ask about

Without proper context, your voice agent may provide generic or inaccurate information that doesn't align with your organization's practices.

Writing Effective Context Prompts

To write effective context for your voice agent, follow these guidelines:

  • Be Clear and Specific: Provide concrete details rather than vague guidelines. For example, use specific descriptions of your practice.
  • Use a Structured Format: Organize your context into clear sections such as 'About Our Practice,' 'Services Offered,' etc.
  • Include Essential Information: Cover your organization's name, locations, hours, insurance information, and services.
  • Avoid Unnecessary Details: Focus on information callers are likely to ask about.

Personalizing Responses Based on Patient History

AlloMia's voice agents can personalize interactions using patient data when integrated with your systems:

  1. Enable Patient Recognition

    In the 'Advanced Settings' tab, enable the 'Caller Recognition' feature to allow your voice agent to identify callers based on their phone number.

  2. Configure Data Connections

    Set up integrations with your Electronic Health Record (EHR) or Customer Relationship Management (CRM) system to allow secure access to relevant patient data.

  3. Define Personalization Rules

    In the 'Personalization' section, specify how your voice agent should use patient information:

    • Greeting returning patients by name
    • Referencing recent appointments or treatments
    • Acknowledging recurring concerns
    • Adapting to communication preferences
  4. Set Privacy Guidelines

    Configure privacy rules that determine what information can be discussed without verification and what requires additional patient authentication.

Note: Always ensure your use of patient data complies with HIPAA and other relevant regulations.

Adding Custom Instructions

Custom instructions help fine-tune how your voice agent behaves in specific situations:

  1. Access the Instructions Panel

    Navigate to the 'Custom Instructions' tab in your voice agent settings.

  2. Add Scenario-Based Guidelines

    Create instructions for specific scenarios such as:

    • Appointment Scheduling: Guidance on collecting necessary information, checking availability, and confirming appointments.
    • Medical Emergencies: Clear protocols for identifying urgent situations and directing callers to appropriate care.
    • Billing Inquiries: How to handle sensitive financial questions and direct callers to billing resources.
  3. Set Response Limitations

    Specify topics your voice agent should avoid discussing or defer to human staff, such as:

    • Providing specific medical advice or diagnoses
    • Discussing personal health information without verification
    • Managing complex billing disputes
  4. Define Escalation Pathways

    Create clear instructions for when and how to transfer calls to human staff members.

Context Examples for Different Healthcare Settings

Below is an example of an effective context format with a specific appointment booking workflow:

You are the receptionist for Oakwood Dermatology Clinic. We specialize in medical, surgical, and cosmetic dermatology with four board-certified dermatologists (Dr. Chen, Dr. Washington, Dr. Rivera, and Dr. Patel) and two physician assistants (Sarah Johnson and Michael Lee).

When scheduling appointments, follow this specific workflow:

  1. First, determine if the caller is a new or existing patient. New patients require verification of name, date of birth, contact information, and insurance details.
  2. For appointment type, offer these options with their required time slots:
    • General skin check/annual exam (30 minutes)
    • Specific skin concern/issue (30 minutes)
    • Acne consultation (45 minutes)
    • Cosmetic consultation (60 minutes)
    • Minor surgical procedure (60 minutes, requires prior consultation)
  3. Check provider availability in our scheduling system based on urgency and preference:
    • Urgent concerns (rash, infection, pain) should be scheduled within 48 hours
    • Routine appointments can be scheduled 1-4 weeks out
    • Cosmetic consultations typically have a 2-3 week wait time
  4. Inform patients about our cancellation policy: appointments must be cancelled 24 hours in advance to avoid a $50 fee.
  5. For patients with insurance, always verify we accept their plan. We currently accept BlueCross, UnitedHealthcare, Aetna, Cigna, and Medicare. If we don't accept their insurance, explain our self-pay rates ($150 for initial visit, $100 for follow-ups).
  6. End by confirming the appointment details and remind patients to arrive 15 minutes early with their insurance card and photo ID.

If a patient describes symptoms that sound urgent (spreading rash with fever, rapidly changing mole, severe pain), offer our urgent appointments or direct them to urgent care if no appointments are available within 24 hours.

If a caller has questions about costs or insurance coverage for specific procedures, transfer them to our billing specialist at extension 203.

Testing and Refining Your Context

After setting up your initial context, it's crucial to test and refine it:

  1. Conduct Test Calls

    Use the test call feature to interact with your voice agent, asking questions a typical caller might ask.

  2. Review Call Transcripts

    Analyze transcripts to identify where your voice agent:

    • Provided incorrect or incomplete information
    • Couldn't answer questions it should know about
    • Misunderstood or misinterpreted caller questions
  3. Gather Feedback

    Have team members test the voice agent with different scenarios and questions to identify gaps in the context.

  4. Iteratively Update

    Refine your context based on testing results, addressing identified issues and adding missing information.

  5. Monitor Live Calls

    Once your voice agent is deployed, regularly review transcripts from real calls to identify areas for improvement.

Remember that context development is an ongoing process. Continue to refine your voice agent's context as you gather more data about caller needs and questions.