Claude Academy
加载中

可见性：您可以衡量的内容

第 11 课10 分钟
本节课内容学完后，您将能够
  • 说明合规 API 记录了什么、未记录什么，以及它与审计日志和完整数据导出有何不同
  • 决定是否将 OpenTelemetry 导出路由到您的可观测性堆栈，作为合规 API 的运营补充
  • 选择与您现有数据政策相匹配的保留窗口，并为根本不应到达 Claude 的内容提出推理钩子建议

这是五项决策中的第五项：可见性。您已经确定了推广的成本。本课涵盖可见性：三个组成部分（合规 API、OpenTelemetry 和保留期）以及其中一项难以撤回的决策。

可见性的作用

您所做的前四项决策配置了 Claude 的行为方式。可见性则是您用来判断这些配置是否有效的方式。可见性还能让您用证据回答具体的事后问题：哪些成员接触过某个特定账户？Claude 在某次敏感对话中生成了什么内容？该对话保留了多长时间？这些答案只能来自您已经保留的记录。

这就是为什么您要在成员获得访问权限之前而不是之后设置可见性：从首次访问到您开启记录功能之间的这段时间，会在记录中留下日后无法填补的空白。三个组成部分为您提供覆盖范围：合规 API（对话内容，加上审计日志事件）、OpenTelemetry（各个界面的运行情况），以及保留期（内容保留的时长）。其中部分记录只有在合规 API 开启时才会被捕获：活动动态事件，以及成员设备上会话的记录，例如 Cowork 和 Claude Code。

合规 API：您的对话内容记录

合规 API 是承载内容的记录。它覆盖 Claude 聊天，并沿用您组织现有的合规访问密钥（Compliance Access Key）和设置扩展到 Cowork 和 Claude Code 会话，因此无需额外集成。请在帮助中心的合规 API 文章中查看它适用于哪些方案，并在 Claude Platform 文档的检索会话记录中查看它记录哪些应用的会话。它承载活动动态事件、聊天数据和文件内容，因此它能够回答"说了什么"和"分享了什么"，而不仅仅是"谁在何时登录"。它是否满足特定的法律或监管要求，由您的法务和合规负责人决定。将其与您已经在使用的 CASB、DLP、eDiscovery 和 SIEM 工具集成——许多此类供应商已经基于合规 API 构建了集成，列在开始使用 Claude 合规 API 集成中。

合规 API 很容易与另外两种记录混淆：

  • 审计日志仅包含元数据。 它们记录事件（谁在何时做了什么：管理员和成员的操作），不包含提示或生成内容。合规 API 也包含审计日志事件，因此一份记录可以同时承载两者，但这种区别仍然很重要：当有人要求获取内容时，仅有元数据是错误的答案。
  • 完整数据导出是一项独立的主要所有者（Primary Owner）功能，用于整体提取您组织的数据，而不是逐案审查。

主要所有者负责启用合规 API。访问密钥在创建时就确定了作用范围：主要所有者密钥可以覆盖父级下的所有组织，而所有者密钥只覆盖该所有者自己的组织。主要所有者也可以创建一个仅作用于单个组织（父级的子组织）的密钥，而不仅限于覆盖整个父级的密钥——作用范围是创建密钥时按密钥逐一选择的，而不是由角色固定的。在此之后真正重要的决策是谁来阅读它：一份无人审查的记录实际上并不构成一种控制手段。许多公司已经有一个安全日志汇集的地方（SIEM 或您安全工具的中央收集点），并由某位负责人负责审查。将合规 API 路由到那里，Claude 就会成为已有审查流程中的又一个来源。

OpenTelemetry：各界面的运行情况

OpenTelemetry 导出会将运营遥测数据发送到您的可观测性堆栈：使用模式和性能数据，在某些界面上还包括对话内容。如果您的工程团队开启该功能，Claude Code 提供了有文档记录的提示日志记录选项（opt-in）；默认情况下，其遥测数据仅为运营数据。在当前版本的 Claude Desktop 中，Cowork 的导出仅携带元数据：提示文本、Claude 的回复和工具输入默认关闭，otlpContentCapture 设备策略可以将其开启。一些旧版本会发送这些内容，除非策略被设置为仅元数据（具体方法参见 Cowork 监控），并且元数据始终包含成员的电子邮件地址以及他们连接的文件夹路径，因此如果您的组织有此要求，请在您的采集器中过滤这些内容。将 OpenTelemetry 视为"运行情况"，作为合规 API "说了什么"的补充，且是可选的：内容方面应依赖的记录是合规 API，而不是遥测数据。如果您的平台团队已经在运行可观测性堆栈，这对他们来说只是一项路由任务。

保留期：内容保留的时长

保留期是指对话内容在删除之前保留的时长。若保持默认设置，内容将无限期保留，直到您或您的成员将其删除。如果您改为设置自定义保留窗口，内容将按照您的计划自动删除；对于保存在项目内的聊天，适用的是项目的窗口而不是聊天自身的窗口。关于保留期从何时开始计算以及自定义窗口不涵盖哪些内容，请参阅自定义数据保留；如果您的组织使用统一版 Claude 体验，另请参阅该体验的设置文章。最短的自定义窗口为 30 天。此设置没有零保留选项。

通过合规 API 获取的活动动态事件和会话记录遵循各自独立的保留模型：

  • 活动动态：无论您设置的窗口如何，均为六年。
  • 远程会话记录（在网页版或移动版 claude.ai 上启动的 Cowork 会话，这些会话在 Anthropic 托管的云端环境中运行，以及云端 Cowork 计划任务的每次运行）：六年，除非成员提前删除该会话。
  • 来自 Cowork 和 Claude Code 的本地会话记录：如果您设置了有限的自定义窗口，则按该窗口执行；如果未设置，则为六年；在启用了 HIPAA 就绪功能的组织中，即使您的自定义窗口更长，也为自捕获之日起 30 天。

聊天、文件和项目内容遵循您设置的窗口，因此较短的窗口会限制成员所能保留的内容，以及合规 API 能够返回的内容。

保留期是一项组织范围内的设置，因此请根据贵公司已有的针对此类内容的数据治理政策来选择，并让该政策的负责人参与进来，以便在您设置该数值之前获得批准。如果某个受监管的职能部门需要比组织其他部门更短的窗口，那么所有人都将使用这个更短的窗口，因此请向受影响的团队说明这一权衡，让他们知晓。

可以在这次讨论中提出的一项建议是推理钩子（inference hooks）：来自 Claude 聊天、Cowork 和 Claude Code 的每一条提示，都会先发送到由您的安全团队或其供应商运营的服务器，在 Claude 回答之前做出允许或拒绝的决定，这样一来，根本不应到达 Claude 的内容就会在门口被拦截，而不是事后由保留期来管理。帮助中心的推理钩子概述介绍了它们是什么，以及谁可以开启它们。

下面的交互式小部件展示了这些决策中的每一项如何影响您事后回答有关数据问题的能力。

加载中

Pluto 的可见性

Pluto 的主要所有者在全面推广之前就启用了合规 API，并将其纳入 Pluto 已有的安全审查流程，因此有一位指定的审查员将其作为现有流程的一部分进行审阅。Cowork 和 Claude Code 会话属于合规 API 的覆盖范围，它们的运营遥测数据会导出到 Platform 已经在运行的可观测性堆栈。而由于 Payments & Trust（支付与信任）部门所需的窗口比其他部门本会选择的更短，风险负责人将组织范围内的保留期设置为这个更短的数值。审查员会在超出该窗口的内容被删除之前，将 Pluto 必须保留的任何内容提取到 Pluto 自己的存档中，因为合规 API 无法返回已被保留期删除的聊天、文件或本地会话记录。

1 · 您的决策

您设置了怎样的保留窗口？合规 API 是否已开启并路由给审查员？

2 · 您可以做出的选择

选择适用情形含义及影响
匹配您现有的数据政策，开启合规 API默认选项。您已针对此类内容制定了数据治理政策，并且已有一位指定审查员运行安全/合规审查流程。保留期设置为您的数据治理政策对此类内容已规定的数值。合规 API 开启并路由到您已有的审查流程。
受监管态势，预期开启合规 API您处理受监管的数据。合规 API 从可选变为预期必备。保留窗口通常会在组织范围内根据您的监管和合同义务而非一般数据政策来设置——这一决定由您的风险负责人做出。整个组织都将采用受监管部门的数值。
关闭合规 API，记录触发条件不存在审查流程，也没有计划建立。暂时关闭合规 API，并写下开启它的触发条件。请注意，在其开启之前，关于该时期的问题将没有活动动态事件或本地会话记录可供参考。

如果贵公司的部分数据必须与其余数据完全分离，这并不是一个保留期设置问题：这是第 4 课中讨论的独立组织问题，因此请将其转回那里处理，而不要试图在这里解决。

3 · 如果您日后更改此设置

合规 API 和 OpenTelemetry 是可以随时更改的开关和目的地，不过任何一段合规 API 处于关闭状态的时期，都会留下与延迟开启相同的空白。保留期在性质上有所不同：该设置可以自由调整，但它所删除的内容不会恢复。日后缩短窗口会抹去成员在旧窗口下积累的历史记录。因此，请在成员在您日后想要更改的数值下积累工作之前，一次性就该窗口达成一致。

设置资源

当您做出决定后，保留期和合规 API 都在组织设置中进行配置，并由主要所有者开启合规 API。

课程活动

这是通常会升级处理的两项决策之一，因此配套部分同时也是您交给第 2 课中可见性负责人的简报。此项决策由风险负责人做出决定。请按以下四个部分进行整理：

  1. 三个组成部分（对话内容、运营遥测、保留期）、它们在贵公司所对接的流程，以及该流程的负责人。任何没有现有流程的部分，都意味着您需要从零开始建立审查流程。请在推广之前标记出来，因为这类流程建立起来耗时最长。
  2. 您建议的保留窗口，以及它所匹配的现有政策。
  3. 您对合规 API 的建议，以及将阅读该记录的人员姓名。
  4. 遥测数据的去向。

需要带给可见性负责人的内容：三个组成部分、您的保留期建议、您的合规 API 建议及其阅读人，以及遥测数据的去向。将其交给您在第 2 课中指定的可见性负责人，并在他们做出决定后记录下来。

→ 将此记录在配套练习手册中，第 11 课部分。

下载内容

  • Work-along companion (Word)

    The editable Word version of the rollout plan you fill in lesson by lesson.

    下载

  • Work-along companion (PDF)

    The same rollout plan as a fillable PDF.

    下载

接下来是什么

现在您已经能够证明发生了什么。而推广是否有效则是一个不同的问题，有着不同的答案：这需要将分析报告中的采用信号，对照您在第 1 课中设定的推广目标来解读。下一课将向您展示如何解读这些信号、它们可能在哪些地方误导您，以及如何设定节奏目标，为您的目标赋予时间表。