技能介绍

超广角眼底相机一次可覆盖约 150°–200° 视野，周边视网膜病变筛查依赖这类大图，但接入方往往要自行对接上传、鉴权、异步分析与结果解析等多套接口，眼位标注、大图与小图分流也容易踩坑。

本技能把腾讯健康觅影的 超广角多病种 AI（aiType=12）流程固化为 Agent 可执行的顺序：先上传拿 study_id，再轮询查询，最后格式化输出。

上传分流：单张 ≤5MB 或多图同传 → studyupload/v2（Base64，images 数组）；单张 >5MB 且 ≤100MB → fileImageUpload/v1（文件，无需压缩）；可从文件名推断眼位（OD/_R/right → 右眼，OS/_L/left → 左眼）。
鉴权：signature = HMAC-SHA256(token, appId + timestamp)，毫秒级时间戳；Base64 与文件接口请求头字段不同（appId/signature/timestamp vs god-portal-*）。
轮询：约 10 秒 间隔，最长 5 分钟；code=30008 表示处理中；成功需 data.ultraWideResult 非空。
结果呈现：按 leftValue/rightValue（1/0/-1）区分阳性、阴性与不确定；含 47 维体征数组（leftDetail.others / rightDetail.others）及 gzip+Base64 的 Mask 分割字段。

支持 JPEG / PNG / DICOM；超广角彩照分辨率建议 ≥2000×2000。若返回需联系 miying@tencent.com 开通服务，说明当前 APP-ID 未开通超广角能力。本技能面向已具备合规影像处理与临床解读责任的集成场景，不替代 医生判读。

截图预览

社区或门诊用超广角相机拍完彩照后，需按 OD/OS 文件名规则上传并轮询 `ultraWideResult`，归档多病种阴阳性结论。
在医疗 Agent 对话里接收用户眼底图，自动在 ≤5MB Base64 与 >5MB 文件上传之间分流，再格式化左右眼筛查输出。
第三方 PACS 对接时要把单张 5MB～100MB 超广角 JPEG/PNG/DICOM 直传 `fileImageUpload/v1`，无需压缩后查 AI 结果。
科研或质控场景需一次上传左右眼多图，并解析 47 维体征数组与 gzip+Base64 的 Mask 分割做二次统计。

眼科医院或筛查中心信息化工程师，要把觅影超广角 API 嵌入院内系统并处理 `code=30008` 轮询与超时。
健康管理或互联网医疗后端开发，需实现 HMAC-SHA256 签名、`studyupload`/`fileImageUpload` 分流与 `queryEyeAIResult` 查询。
编排临床辅助 Agent 的工程师，要求助手严格按上传→轮询→格式化三步执行并展示 `leftValue`/`rightValue`。
眼底多病种科研或质控项目数据员，需从接口拉取 `ultraWideResult`、47 维 `others` 及解码后的 Mask 做分析。