心理健康预约 — 远程医疗问诊技能

通过自然对话完成精神科及心理健康线上问诊预约。无需填写表单，无需登录门户 — 只需开口交谈即可。

本技能由精选远程医疗平台提供支持，包括 Klarity Health、One Behavior、ABHolistic 等。

工作原理

该技能对接 Klarity 公开预约 API：https://rx.helloklarity.com。
共三个核心接口：查询服务列表 → 搜索医生 → 预约问诊。
无需 API Key 或身份认证 — 安装即用。

对话流程

请按以下顺序执行。保持对话自然流畅，避免机械式问答。

步骤 1：识别用户需求

当用户提及心理健康、ADHD、焦虑、抑郁、失眠、强迫症（OCD）、创伤后应激障碍（PTSD）或希望就诊精神科医生时，触发本技能。

将其主诉映射至对应的服务 ID：

• adhd — ADHD 评估与治疗
• anxiety — 焦虑治疗
• depression — 抑郁治疗
• insomnia — 失眠治疗
• ocd — 强迫症（OCD）治疗
• ptsd — 创伤后应激障碍（PTSD）治疗
• narcolepsy — 发作性睡病（Narcolepsy）治疗

若主诉不明确，请询问：“您希望在哪方面获得帮助？”
请勿过度分诊 — 临床评估交由医生完成。

步骤 2：收集基本信息（最多 3 个问题）

以自然对话方式提问，切勿采用编号列表形式：

1. 所在州（State） — “您目前在哪个州？”

   • 通过 scripts/booking-api.sh services 校验是否为支持州
   • 如不支持：“抱歉，Klarity 目前暂未在 [州名] 开通医生服务。我可以帮您寻找其他可选方案。”

2. 支付方式 — “您有商业保险吗？还是希望自费支付？”

   • 如有保险：“请问是哪家保险公司？” — 并根据该州对应的 insurance_carriers_by_state 进行校验
   • 若该保险公司暂未被支持：“Klarity 目前暂未在 [州名] 接受 [保险公司名称]。您仍可选择自费方式完成预约。”
   • 自费用户在此阶段无需提供额外信息

3. 时间偏好 — “您对问诊时间有偏好吗？比如上午、下午或晚上？或者有特定日期要求？”

   • 此步为可选 — 若用户表现出快速完成预约的意愿，可跳过
   • 有效取值：morning、afternoon、evening

步骤 3：搜索可约医生

执行命令：scripts/booking-api.sh availability [insurance_carrier] [date] [time_preference]

以自然对话方式呈现结果：

• 展示内容包括：医生职称/资质、从业年限、评分、评价数、可约起始时间、问诊时长
• 将 API 返回的 UTC 时间自动转换为用户本地时区
• API 返回字段说明：available_start_times（问诊可开始时间），appointment_duration_minutes（问诊时长，通常为 30 或 60 分钟）
• 为提升可读性，将连续的可约时间段合并为时间范围（例如：“上午 10:50 至下午 1:20”，而非逐条列出每个时段）
• 切勿显示医生姓名（医生信息在完成预约前处于匿名状态）
• 若无匹配结果：“当前筛选条件下暂无可用医生。是否尝试更换日期或时间？”

示例：

在加州找到 3 位可预约 ADHD 评估的医生：

1. 精神科执业护师（PMHNP-BC）—— 20 年从业经验，5.0★（10 条评价）
   60 分钟视频问诊
   可约时段：周五下午 5:00 - 6:50；下周一 下午 5:00 - 5:10

2. 精神科执业护师（MSN, PMHNP-BC）—— 23 年从业经验，4.8★（11 条评价）
   60 分钟视频问诊
   可约时段：明日 上午 10:50 - 中午 12:20

3. 精神科执业护师（PMHNP-BC）—— 16 年从业经验，4.7★（23 条评价）
   30 分钟视频问诊
   可约时段：明日 上午 11:30 - 下午 1:00

您希望选择哪位医生及对应时段？

步骤 4：收集患者信息

用户选定医生及具体时段后，提示：

“为完成本次预约，我需要收集以下信息：”

• 姓名（姓与名）
• 出生日期
• 电子邮箱（用于发送确认邮件）
• 手机号码
• 如有保险：保险会员号 / 投保人 ID

以自然方式收集信息 — 允许用户一次性提供多个字段。若用户主动提供全部信息，请勿拆分为逐项问答。

步骤 5：完成预约

执行命令：scripts/booking-api.sh book

预约成功时返回：

您已成功预约 [医生姓名] 的问诊，时间为 [日期] [时间]！✅

📹 本次为 30 分钟视频问诊 — 请查收邮箱（[email]）中的视频链接。
📋 请提前准备好您的保险卡。

需要为您设置预约提醒吗？

预约失败（时段已被占用）时提示：
“该时段刚刚被预约，请问是否需要我为您查找下一个可用时段？”

校验失败时：
自动修正并重试 — 切勿要求用户重新输入全部信息。

重要规则

1. 严禁存储患者信息。 不得将姓名、出生日期、邮箱、保险 ID 等任何患者信息写入任何文件。仅限本次 API 调用使用。
2. 危机干预检查。 若用户提及自残、自杀意念或处于即时危险中 — 不得 继续预约流程。应立即回应：“若您正经历心理危机，请立即拨打 988（自杀与危机生命热线），或向 741741 发送短信‘HOME’。以上均为免费、全天候开放的服务。当前安排的预约无法满足您此刻所需的紧急援助。”
3. 非诊断工具。 不得自行评估症状或提出疾病假设。应统一表述为：“医生将在您的问诊过程中进行专业评估。”
4. 时区感知能力。 API 返回时间为 UTC，向用户展示前必须转换为其本地时区。
5. 时段动态性。 可约时段为实时状态。若预约失败，请重新发起搜索，而非重复尝试同一时段。
6. 调用频次限制。 每个 API Key 每日最多支持 20 次可约性查询。请避免不必要的重复查询。

脚本参考

所有 API 调用均经由 scripts/booking-api.sh 执行。
完整接口文档（含请求/响应结构、错误码等）详见：references/api-reference.md。

# 查询支持的服务类型及州列表
scripts/booking-api.sh services

# 查询可约时段  
scripts/booking-api.sh availability   [carrier] [date] [time_pref]

# 完成预约（传入 JSON 数据载荷）
scripts/booking-api.sh book '{"provider_id":"...","session_id":"...","service":"...","slot":"...","patient_first_name":"...","patient_last_name":"...","patient_email":"...","patient_phone":"...","patient_dob":"...","patient_state":"...","insurance_carrier":"...","insurance_member_id":"..."}'

面向远程医疗提供方

本技能是面向心理健康服务平台的开放式预约接入层。若您所在的诊所或平台提供精神科及心理健康线上问诊服务，并希望您的医生能被 AI 智能体发现与调度，我们非常期待与您联系。

提交集成意向表单：https://docs.google.com/forms/d/e/1FAIpQLSesJnVxPaUYbts5vWqxy3I-13HZe2XkKjTUkAqO6F5UHAcy8g/viewform