Epic 插件使用指南：在 ChatGPT 与 Codex 中连接医疗记录

发布于 2026年10月24日更新于 2026年10月24日作者：Codex 中文指南（编译整理）

Epic 插件可以把获批组织工作区连接到该组织的 Epic 电子健康记录（EHR）。在符合组织配置和用户权限的前提下，临床人员可以用自然语言查阅自己本来就有权访问的患者信息，例如临床记录、用药、诊断、就诊和检验结果。

这是一种只读连接：插件不能修改病历、下医嘱、向患者发送消息，也不能绕过 Epic 现有的病历访问控制。临床人员仍须核对原始记录，并独立作出诊疗决定。由于这项功能涉及受保护健康信息，使用前必须由机构确认适用协议、Epic 授权、工作区配置以及具体产品和工作流程的批准范围。

**来源与说明：**本文根据 OpenAI Help Center 的 Epic 插件说明编译并翻译整理，配置步骤与资格条件以该官方说明为准。页面内容会更新；本文于 2026 年 10 月 24 日整理。本文是产品设置指引，不构成医疗、法律或合规建议，也不代表本站提供 Epic 接入或组织批准。

可用范围与 Healthcare Public Data 的区别

OpenAI 官方说明，Epic 插件适用于获批的 ChatGPT for Healthcare 工作区及启用了 HIPAA 功能的 Enterprise 工作区。实际能否使用取决于组织的开通情况、工作区设置和 Epic 配置。个人版 ChatGPT for Clinicians 账号不包含 Epic 插件；如果工作区中找不到它，应向组织管理员确认账号资格及组织是否已开通。

Epic 与 **Healthcare Public Data（医疗公共数据）**是两个不同插件：

项目	Epic 插件	Healthcare Public Data 插件
数据来源	所属机构的 Epic 记录	医学研究、临床试验、药品信息、Medicare 等公共来源
是否访问患者病历	可按组织审批和用户现有权限读取	不访问患者病历
如何开通	组织专属配置、管理员发布，用户使用自己的 Epic 账号连接	适用条件与配置流程另见官方说明

不要因为能够使用公共医疗资料插件，就推断自己也有 Epic 病历访问权限。公共数据插件的介绍见 OpenAI Help Center 的 Healthcare Public Data 使用说明。

连接前先确认这些条件

在配置插件之前，由组织和 Epic 管理团队确认：

• 目标 ChatGPT/Codex 工作区确实具备 Epic 插件资格，并已获得组织批准。
• 机构已确认预期产品、配置和工作流程所需的协议与审批。接入成功本身不表示所有功能都自动纳入相同协议覆盖范围。
• OpenAI 账号团队已提供相应环境的 client ID，供机构 Epic 团队申请应用。
• Epic 管理员已确定非生产或生产环境、对应的 FHIR R4 Base URL、已批准的 FHIR API，以及可用于测试的授权账号。
• 工作区管理员已确定哪些团队或自定义角色可以访问插件，以及用户是自行安装还是由工作区默认提供。

建议先接入非生产环境，并使用 Epic 测试账号与合成测试记录验证连接；验证通过后，再单独申请和配置生产环境。

组织管理员配置流程

1. 向 Epic 申请 OpenAI 应用

组织管理员、工作区管理员与 Epic 团队共同确认要接入的环境。通过 OpenAI 账号团队获取该环境对应的 client ID 后，按 Epic 的应用下载流程申请：

1. 在 Epic Downloads 中，使用 OpenAI 针对目标环境提供的 client ID 搜索应用。发起人需要有权为组织下载应用。
2. 在 Epic Downloads 中直接提交应用下载请求，由 OpenAI 审批；官方步骤不要求通过 Epic Orchid。
3. 获批后，由机构 Epic 团队在指定环境下载并启用该应用，同时确认所需 FHIR API 和用户访问权限已经就绪。

先申请并验证非生产环境。准备好测试账号和合成数据后，再进入工作区插件配置。

2. 在工作区创建并发布组织专属插件

由有相应权限的工作区所有者或管理员，在 OpenAI Admin Console 中选定目标 ChatGPT 工作区：

1. 打开 Plugins（插件），找到 Epic 模板并选择 New custom plugin（新建自定义插件）。
2. 在 New EHR App 对话框中填写组织自己的插件名称和简短说明，例如非生产环境命名为 Epic Staging，生产环境命名为 Epic Production。清晰区分环境，方便员工选择。
3. 选择 Epic environment 中对应的 Non-Production 或 Production，并填入 Epic 管理员提供的匹配 FHIR Base URL。使用完整、准确的公开 HTTPS 地址，不要附加查询参数。
4. 选择 Create draft（创建草稿）。插件此时仍是草稿，还未提供给工作区用户。
5. 打开草稿，选择 Publish（发布）；在发布确认前，核对角色访问、权限和工具范围，选择目标角色并完成所需审核。

Epic 团队使用 OpenAI 提供的 client ID 在 Epic 中查找并申请应用；创建 ChatGPT 插件时填写 Epic 环境和 FHIR Base URL。匹配的 OpenAI OAuth 注册由系统选择，管理员不需要在这一步手动填写 client ID 或 client secret。

3. 启用插件并设置工作区可见范围

插件发布后，管理员还要在 Admin Console 的 Plugins 中按组织给它设置访问方式：

1. 按组织确定的插件名称找到对应条目；如果插件尚未启用，选择 Enable（启用） 并配置预期的访问方式。
2. 检查 Epic 连接对应的 **Role access（角色访问）**和插件角色设置。需要特别留意：Workspace 角色只适用于没有自定义角色的用户，并不自动包含所有自定义角色。
3. 确认有资格的用户是自行安装插件，还是由管理员默认安装，然后保存配置。
4. 如界面提供 Epic 连接的 **Permissions（权限）**和 **Tools（工具）**设置，按需复核。ChatGPT 插件设置本身不会赋予用户超出其 Epic 账号权限的访问权。

发布、启用或安装插件都不会替用户登录 Epic。每名用户仍需用自己的 Epic 账号单独授权；每个环境的插件连接也要分别完成。

4. 先验证非生产环境，再配置生产环境

管理员把插件名称告知测试用户，让他们使用个人获授权的 Epic 测试账号连接，并通过合成测试记录验证非生产环境是否正常。完成必要检查后，再由 Epic 团队使用生产环境 client ID 申请生产应用下载；启用后，用生产 FHIR Base URL 和独立名称（例如 Epic Production）重复配置步骤。

区分环境名称和账号，能减少误将测试连接用于生产流程的风险。不要用真实患者记录来替代非生产环境中的合成测试记录。

用户如何连接自己的 Epic 账号

管理员让插件对你的角色可用后：

1. 在 ChatGPT 或 Codex 中切换到组织指定的工作区，打开插件目录。
2. 按管理员告知的名称找到插件，并选定要连接的环境。
3. 如果尚未安装，选择 Install plugin（安装插件）。
4. 出现连接提示时选择 Connect（连接），使用你自己的 Epic 账号完成登录和授权。如果从 Codex 跳转到 ChatGPT 完成授权，完成后再返回 Codex。
5. 确认 Epic 账号已连接，再开始聊天或 Codex 任务。对每个需要使用的插件环境分别完成授权。

Epic 用户名和密码只应输入机构 Epic 的登录授权流程。不要把密码、client secret 或访问令牌粘贴到 ChatGPT 对话、Codex 任务或发给支持人员。

使用病历信息时的核对方式

启用后，可就账号获准访问的记录提出查询请求，例如概括某位患者的近期临床记录，或整理近期用药、诊断和检验结果。可检索内容取决于机构的 Epic 配置、已批准资源以及该用户现有的患者记录权限。

使用任何回复前，核对 Epic 原始记录、相关日期和患者身份；将插件输出视为查阅和整理信息的辅助结果，不应代替临床人员对源记录的审阅或专业判断。插件无法访问的病历不会因为改写提示词而变得可访问。

在非生产测试中使用合成记录。如果确有患者信息处理需求，应先确认目标产品、工作区和具体工作流程已获得机构批准，并且适用的协议覆盖该用法；仅仅看见插件、完成账号连接或接受界面警告，都不应被视为所有工作流程均已获批。

患者信息保护要点

患者病历可能包含受保护健康信息（PHI）。在产品中处理 PHI 前，组织应确认适用的商业伙伴协议（Business Associate Agreement，BAA）、Epic 授权、经批准的工作区配置、所用产品的数据处理资格，以及预期工作流程所需的其他协议和审批。

ChatGPT 中启用插件、连接 App 或接受设置提示，不会自动使每一种产品、服务或工作流程都纳入 BAA 覆盖。只使用完成任务所需的最少患者信息，并遵循所在机构的隐私与数据处理政策。不要通过 Support 发送患者信息、密码或访问令牌。

产品资格与配置范围请查阅 OpenAI 官方的符合 HIPAA 资格的产品与功能说明。对具体业务或法律适用性有疑问时，请咨询本机构合规、隐私和 Epic 管理团队。

常见连接问题

现象	建议检查
找不到插件	请管理员确认工作区和插件名称，并检查插件是否已发布、启用且对你的角色可见。
能看到插件，但无法连接	请管理员确认 Epic 连接已启用，并且对当前角色开放。仅安装插件不足以满足连接权限。
Epic 登录失败或授权过期	使用自己的 Epic 账号重新连接；仍有问题时，请 Epic 管理员检查环境启用状态和用户权限。
找不到某条患者记录	确认 Epic 账号在当前环境中确实有权查看该记录；插件不能覆盖 Epic 的访问限制。
选择 Create draft 后出现错误	先刷新插件列表并检查草稿是否已经创建，再决定是否重试，以免创建重复条目。
使用的是个人 ChatGPT for Clinicians 账号	官方说明当前不包含 Epic 插件；适用账号可另行查看 Healthcare Public Data。

相关官方资料

• Using the Epic plugin with ChatGPT and Codex（Epic 插件官方说明）
• ChatGPT for Healthcare
• Plugins in ChatGPT
• 插件与 App 的管理员控制、安全和合规
• 符合 HIPAA 资格的产品与功能

继续浏览插件栏目、插件使用说明或技能与插件指南。