技能

了解文档处理能力

先选择一个任务。以下步骤适用于当前组织中有权访问相应功能的账户；具体前提请见链接中的流程。

1. 了解共享方法
2. 先检查可用性
3. 查看提取范围

检查结果：使用 AI 结果前，你能区分受支持的内容、来源和覆盖限制。

遇到问题：如果格式或能力不可用，请查阅可用性说明并使用受支持的资料。手册已发布不代表功能已在生产环境开放。

什么是技能

使用场景：了解同一文档为何能在不同 Atlas 功能中提供一致证据。

技能是 Atlas 按准确身份解析的具名、可版本化方法。知识（我的文档和公司文档，即同一个资料库的两个范围）和助手可以共用同一个 PDF 理解约定，不必各自维护读取器。

技能不是权限授权。你能读取或修改什么，仍由登录角色及数据所属服务决定。技能定义不包含可执行上传内容、凭据或连接器。

预期结果：你能区分“使用了什么方法”和“是否有权使用”。

在知识库中使用 PDF 理解

页面：/knowledge/library/:fileId

使用场景：把文本 PDF、扫描件或含大量图像的 PDF 转为可引用知识。

操作前：使用有知识文件贡献权限的组织角色。

操作步骤

1. 进入知识 → 我的文档或公司文档——两者都是同一个资料库的范围——并上传 PDF，核对名称和位置后确认草稿。
2. 打开就绪文档。在 PDF 理解区域核对技能身份、文件元数据、已检查页数，以及分别列出的文本、视觉和 AI 覆盖范围。
3. 阅读带页码和来源类型的段落。文本来自 PDF 文本层，扫描是从渲染页面识别出的文字，视觉用于描述图形、图表、表格或图片。
4. 如需让当前技能版本重新读取原文件，选择“重新提取”。替换结果就绪前，旧结果仍会保留。
5. 若 Atlas 显示“部分覆盖”，依赖结果前应阅读每一项缺口。

预期结果：文档显示带页码的段落、元数据和如实记录的覆盖范围，原文件不会被修改。

在助手中读取 PDF

页面：/assistant

使用场景：询问当前对话所附 PDF 的内容。

操作步骤

1. 通过AI 助手 → 新对话，或圆形悬浮助手按钮开始对话，并附上目标 PDF。仅在问题需要时加入相关客户上下文。
2. 提出具体问题，例如文件中的保修期限或型号。
3. 确认回答引用了对应页码，例如 [第 1 页]，并在内容来自扫描识别时明确说明。
4. 若决策取决于准确措辞或视觉细节，请打开或下载原文件。提取引用用于定位证据，不能替代原文。

预期结果：助手使用同一可版本化 PDF 方法，并以页级证据回答。

查看来源与覆盖范围

• 技能身份：本次运行使用的技能 ID 和版本。首个已发布能力为 document_pdf_extract v1.0.0。
• 元数据：可取得的标题、作者、创建和修改日期、页数及检测语言。
• 已检查页面：本次运行在限制内尝试的页面。超出限制的页面会显示为缺口，不会静默丢失。
• 文本、视觉和 AI 覆盖：分别列出 Atlas 找到文本层、渲染视觉内容及模型辅助理解的位置。
• 段落来源：每段内容标明页码和类型；模型辅助内容也会标明模型线路。

“完整覆盖”表示限定范围内的检查完成且没有已知缺口，并不保证每句话或每项视觉细节都被完全正确理解。

平台超级管理员检查技能

页面：/platform?view=skills

使用场景：确认某次运行采用的受控定义及版本。

操作前：此页面要求独立的平台超级管理员角色。组织管理员不会因技能而获得平台权限。

操作步骤

1. 进入平台 → 质量 → 技能。
2. 选择定义，检查所属服务、输入输出约定、限制、模型线路及活跃版本。
3. 按使用界面和状态查看近期运行，把技能 ID、版本及摘要与正在调查的文档或助手结果对应起来。
4. 使用已计价用量核对模型 token 和提供商费率身份。缺失或未计价的用量是待调查缺口，不代表成本为零。
5. 除非该平台操作另行获得授权，不要启用、停用或发布版本。

预期结果：你可以把用户可见结果追溯到准确的受控方法，并且不会把检查权限误当成修改权限。

使用图片理解

在知识 → 资料库中上传并确认 JPEG、PNG、WebP、GIF、BMP 或安全 SVG。详情会显示准确的 document_image_extract 版本、尺寸、存在时的原始拍摄元数据、分别列出的转录和描述段落，以及覆盖范围。GIF 仅读取首帧；SVG 由 Atlas 检查和光栅化，绝不会在浏览器中执行。

助手的 read_artifact 会为已附加图片走同一授权证据路径。决策依赖细节时应打开原文件：图片输出是不可信证据，不用于识别个人，也不是应执行的指令。

让视频可供 AI 使用

视频超过 50 MB（50 MiB）时，按提示从设备中重新选择该视频原文件，再查看处理确认。Atlas 会核对它是否与已上传原件一致；不匹配时请重新选择原文件。仅上传文件不会授予处理许可。

操作前：准备一个不超过五分钟的视频，并使用支持 WebGPU 的浏览器。

上传最大 1 GB（1 GiB）的 MP4、MOV 或 WebM。原文件会以未处理状态保留在资料库中，上传不会自动转录或分析。

1. 打开视频，选择AI 就绪处理。处理上限为五分钟；较长的视频请先截取较短片段再上传。
2. 阅读保持页面打开的说明后开始。首次使用时，浏览器会下载本地模型。转录和画面描述均在你的设备上运行；画面分析需要支持 WebGPU 的浏览器与设备。
3. 等待媒体准备、转录、画面分析和保存完成，也可以取消。离开时选择“留下”继续处理，选择“离开”停止处理；刷新或关闭提示由浏览器控制。
4. 只有完整保存的结果才会显示为 AI 就绪。重新打开后可查看转录、抽样画面描述、时间戳和覆盖范围；选择时间戳可定位原视频，也可在资料库搜索已记录的文字。

语音保留原语言，画面描述保留模型的输出语言。两者均为浏览器报告的 AI 结果，可能有误，请对照原视频核查。抽样画面不代表所有时刻或完整运动分析。无语音视频可仅保存画面结果。

解码、设备能力或推理失败时，原文件仍会保留。请按提示处理或在兼容设备上重试。关闭浏览器不会在后台完成任务，也不会启用付费推理作为备用方案。

结果：完整保存后，视频的带时间戳证据可供重新查看和搜索。

为控制设备内存，画面会缩小；超出大小限制的抽样会跳过，并反映在覆盖范围中。

可用范围与限制

当前可用范围：图片理解已随共享技能框架进入预发布；生产可用性仍需独立验证的产品发布。

• JPEG、PNG、WebP、GIF、BMP 和安全 SVG 限制为 8 MiB 和 400 万像素。
• 一次禁用缓存的受治理模型请求生成受限的文字和描述。达到限制或模型不可用会明确显示为“部分覆盖”。
• GIF 仅读取首帧。不安全 SVG 功能或外部引用会在调用模型前被拒绝。
• 视频处理须在资料库中显式开始，并保持兼容浏览器打开；结果标注为浏览器报告。