Skip to content
intermediatetext

Patient Forum Question Answering

Question answering and response classification for patient health forum posts: annotators write or assess an answer to a patient's question and categorize each response by type (medical advice, experience sharing, information request, emotional support). A generic showcase design for consumer-health forum analysis.

Try it live — no install

Boot the real Potato server in your browser (WebAssembly) and annotate with this exact config. Nothing leaves your machine.

Run live in your browser

Get This Design

View on GitHub(opens in a new tab)

Clone or download from the repository

Quick start:

bash
git clone https://github.com/davidjurgens/potato-showcase.git
cd potato-showcase/text/question-answering/patient-forum-qa
potato start config.yaml

Configuration File

yaml
# Patient Forum Question Answering
# A generic showcase design for consumer-health forum analysis (no specific
# primary source).
#
# This task asks annotators to answer patient forum questions and classify
# the type of response that would be most appropriate. The categories
# reflect different communicative functions in health forums.
#
# Response Type Labels:
# - Medical Advice: Specific medical guidance or treatment suggestions
# - Experience Sharing: Personal experiences with similar conditions
# - Information Request: Asking for more details or clarification
# - Emotional Support: Empathetic support and encouragement

annotation_task_name: "Patient Forum Question Answering"
task_dir: "."

data_files:
  - sample-data.json

item_properties:
  id_key: "id"
  text_key: "text"

output_annotation_dir: "annotation_output/"
export_annotation_format: "jsonl"

port: 8000

annotation_schemes:
  - annotation_type: text
    name: answer
    description: "Write an appropriate answer to this patient forum question"

  - annotation_type: radio
    name: response_type
    description: "What type of response is most appropriate for this question?"
    labels:
      - name: "Medical Advice"
        tooltip: "The question calls for specific medical guidance or treatment suggestions"
        key_value: "1"
      - name: "Experience Sharing"
        tooltip: "The question would benefit from hearing personal experiences with similar conditions"
        key_value: "2"
      - name: "Information Request"
        tooltip: "More details are needed before a meaningful response can be given"
        key_value: "3"
      - name: "Emotional Support"
        tooltip: "The poster primarily needs empathetic support and encouragement"
        key_value: "4"

annotation_instructions: |
  You will see a question posted on a patient health forum along with the forum category.
  1. Read the question carefully.
  2. Write an appropriate response to the question.
  3. Classify what type of response is most appropriate (medical advice, experience sharing,
     information request, or emotional support).
  Note: Do not provide actual medical diagnoses. Focus on the communicative function.

user_config:
  allow_all_users: true
max_annotations_per_user: 50
num_annotators_per_item: 2

Sample Data

json
[
  {
    "id": "patient_qa_001",
    "text": "I was recently diagnosed with type 2 diabetes and my doctor put me on metformin. I've been experiencing stomach cramps and diarrhea for the past week. Is this normal? Should I stop taking the medication?",
    "forum_category": "Diabetes"
  },
  {
    "id": "patient_qa_002",
    "text": "My mother was just told she has early-stage Alzheimer's. I feel completely overwhelmed and don't know how to cope. Has anyone else gone through this with a parent?",
    "forum_category": "Caregiving"
  }
]

// ... and 8 more items

Details

Annotation Types

textradio

Domain

NLPBiomedical

Use Cases

Question AnsweringHealth Forum AnalysisPatient Support

Tags

question-answeringpatient-forumhealthmedicalconsumer-health

Found an issue or want to improve this design?

Open an Issue(opens in a new tab)