Skip to main content

User (Human-in-the-Loop)

The User client enables human participation in therapy simulations, allowing real people to act as clients/patients in interactive sessions.

Overview​

PropertyValue
Keyuser
TypeHuman-in-the-loop
FocusInteractive Sessions

Description​

The User client is a special agent type that delegates client responses to a human operator. This enables interactive training scenarios, human evaluation studies, and live demonstrations where a real person plays the role of a patient while interacting with therapist agents (either AI or human).

Key Features​

  • Real-time interaction - Human provides responses in real-time
  • Full control - Complete flexibility in presenting symptoms and behaviors
  • Training mode - Ideal for standardized patient practice
  • Evaluation studies - Enables human evaluation of therapist agents

Configuration​

YAML Configuration​

client:
agent_name: user

Usage​

CLI​

patienthub simulate client=talkDep

Python​

from patienthub.clients import get_client

client = get_client(agent_name="user", lang='en')

Parameters​

The User client does not require additional configuration parameters as it relies on human input.

Use Cases​

  • Standardized Patient Training - Medical/psychology students practice with real SPs
  • Therapist Agent Evaluation - Human clients evaluate AI therapist quality
  • Interactive Demonstrations - Live demos at conferences or training sessions
  • Research Studies - Controlled experiments with human participants
  • Quality Assurance - Testing therapist agent responses to edge cases

Integration​

The User client integrates with PatientHub's interactive interfaces:

  • Chainlit Web Demo - Provides a chat interface for human interaction
  • Command Line - Text-based interaction through the terminal
  • Custom Interfaces - Can be integrated with custom UIs