Appearance
调试与发布
应用配置完成后，还需要确认当前配置已经测试通过，并决定用户或业务系统从哪里使用应用。
一、先分清四种状态
| 状态或操作 | 决定什么 | 不代表什么 |
|---|---|---|
| 应用启用 | 应用是否允许继续提供服务 | 不代表草稿已经发布 |
| 发布应用 | 将当前编排配置发布为可使用版本 | 不代表用户已经获得访问入口 |
| 启用网页/API 等渠道 | 用户或系统可以从该渠道访问 | 不代表已经上架到交付中心 |
| 发布到交付中心 | 应用进入指定交付分组 | 不等于修改了应用编排版本 |
修改编排内容后，线上仍使用最近一次发布的版本；完成发布后，还要检查目标渠道是否已经启用。
二、发布前完成核心测试
在编排页面右侧的 预览与调试 区域测试当前配置。
不要只输入“你好”来判断应用是否可用。至少覆盖：
- 用户只说一个简单症状时，应用是否继续追问；
- 用户一次提供多项信息时，应用是否避免重复询问；
- 用户要求诊断或推荐药物时，应用是否遵守限制；
- 信息收集完成后，应用是否按要求整理；
- 变量、知识库、技能和工具是否正确使用。
| 测试类型 | 重点检查 |
|---|---|
| 正常任务 | 能否完成核心任务并按要求输出 |
| 信息缺失或表述模糊 | 是否继续确认，而不是自行补全事实 |
| 超出服务范围 | 是否明确拒绝或引导到正确渠道 |
| 高风险请求 | 是否遵守诊断、用药和紧急情况等安全边界 |
| 知识库无答案 | 是否避免编造医院内部规定 |
| 工具调用失败 | 是否停止使用无效结果并给出合理提示 |
| 超长、错误格式或无关输入 | 是否能安全结束或要求用户修正 |
通过输入框中的 @ 可以选择技能或工具进行联调。涉及文件任务时，点击 预览与调试 区域顶部的文件按钮展开左侧文件列表，再点击文件列表顶部的上传按钮上传测试文件，然后验证应用是否能够读取或处理文件。
调试时使用测试数据或脱敏数据，不要输入真实患者敏感信息。需要追踪调试记录时，可以进入日志。
发布前的医疗安全检查
- 高风险输出是否需要医务人员复核；
- 知识资料是否有明确来源、适用范围和有效期；
- 是否禁止模型直接给出超出应用定位的诊断、处方或治疗决定；
- 是否对紧急症状提供明确的人工或急救引导；
- 测试、日志、模型和第三方工具是否会接触患者敏感信息；
- 正式上线是否已经获得业务、医疗安全和数据安全责任人的确认。
三、发布当前配置
点击页面右上角的 发布应用，系统会要求选择发布类型。
如果选择 自动发布版本，页面会显示系统为本次发布生成的版本号。页面同时提供 手动发布版本 选项，具体可填写内容以弹窗选择后的实际页面为准。
确认发布类型和版本信息后，点击 发布。
发布前记录本次变更内容和对应测试结果，便于出现问题时定位是哪个版本引入了变化。当前页面未提供的版本比较或回滚能力，不在本文中假定支持；需要恢复旧配置时，应先以实际版本页面提供的操作为准。
发布应用用于发布当前编排配置。发布完成后，还要进入顶部的 发布 页面选择使用渠道。
四、根据使用对象选择渠道
| 使用对象 | 选择方式 |
|---|---|
| 可以直接打开浏览器的用户 | 网页链接 |
| 平台内登录用户 | 交付中心 |
| 开发和联调人员 | 调试 |
| 医院现有业务系统 | API 访问或 SDK 集成 |
| 其他支持 A2A 的平台 | A2A，功能开发中 |
| 微信、企业微信、钉钉或飞书用户 | 对应第三方渠道，功能开发中 |
不需要把所有渠道都配置一遍，只选择真实业务需要的渠道。
五、通过网页链接使用
网页链接适合直接通过浏览器使用应用。进入 发布 → 网页链接，按照页面提示启用渠道并获取访问地址。
正式提供给用户前，应先在实际使用环境中打开链接，确认页面能够访问、应用名称正确，并且当前线上结果与调试结果一致。
六、发布到交付中心
交付中心适合让平台内登录用户使用应用。打开 是否开启 后，选择发布分组。
如果没有可选分组，需要先在交付中心创建分组，再返回当前页面。发布完成后，可以前往交付中心应用管理查看应用是否已经上架。
七、接入现有业务系统
需要把应用接入医院现有系统、Web 应用或其他平台时，可以使用 API 或 SDK。这部分通常由开发人员完成。
7.1 API 访问
进入 发布 → API 访问，页面会显示业务空间 ID 和应用 ID。点击 获取 API 密钥 会跳转到密钥管理，开发人员需要在密钥管理中创建或获取 API Key。
具体接入方式依次参见：
不同应用类型的主要接口：
API Key 属于敏感凭证，不要放入前端代码、公开截图或公开代码仓库。
7.2 SDK 集成
进入 发布 → SDK 集成，点击页面中的 SDK 集成 按钮跳转到开发文档。
先阅读SDK 概览，再根据项目语言选择：
SDK 的安装、鉴权和代码示例以开发者文档为准。
7.3 A2A
A2A 用于在支持 A2A 协议的平台中使用当前应用。该功能正在开发中，暂不支持配置和使用。
八、第三方渠道
微信客服、微信公众号、企业微信、钉钉和飞书等第三方渠道正在开发中，当前暂不支持配置和使用。