事件
查找已记录的翻译活动,查看相关文本与来源,并追踪对这些活动进行的测量。
事件记录内容发生的变化:添加了建议、修改了翻译,或完成了本地化。如果需要在解读测量结果前确认 Radar 收到了什么,请打开相应事件。
事件类型很重要。翻译建议、已批准的建议和已更新的目标文本可能涉及同一个字符串,却代表不同的活动。将三者计为三个已翻译的字符串,会夸大实际工作量。
查找并打开事件 #
Radar → 日志有两个选项卡:原生列出收到的所有事件,测量列出测量针对事件计算出的所有值。两个选项卡都支持按最近 7 天、最近 30 天、最近 90 天或全部时间限定范围,也可按语言、事件类型和来源筛选;在原生选项卡中,生成者用于选择生成者类型。语言、来源和生成者的可选值仅包含组织事件中出现的值,以及已选中的值。生成者会完整显示各代码的含义:llm 为 AI 模型,human 为人员,mt 为机器翻译,tm 为翻译记忆库,algo 为算法。语言按事件的语言区域精确匹配。与审计日志一样,时间、每行显示的日期和时间范围都以组织时区为准,该时区可在“设置 → 常规”中设置;时间范围涵盖所选天数,直至今天结束。将鼠标悬停在时间上,可查看带时区的精确时间。清除会一次性清除语言选择和所有筛选条件,但保留时间范围。
将鼠标悬停在类型筛选器、表格或事件页面中的事件类型上,可查看其含义。参考列出了所有事件类型,以及发送这些事件的集成。
打开事件,查看可用的源文本、目标文本、草稿和上下文。事件页面会显示类型、语言区域、生成者、执行者、发生时间、采集时间、单元和关联,随后在值下显示测量结果,并展示已存储的载荷。分享调查信息时,请保留事件标识和记录的事件时间。读取契约使用 eventId,并将事件的 eventAt 值作为 at 来定位详情。
事件历史采用游标分页:默认每页 50 条,最多 200 条。如果需要获取所选范围内的完整历史,请保持筛选条件不变,使用 meta.nextCursor 继续查询,直到不再返回下一页游标。单页显示的行只是这段历史的一部分。
了解记录的标识 #
| 字段 | 标识的内容 |
|---|---|
eventId, eventType | 记录的事件及活动类型。 |
unitId, displayKey | 底层内容单元及其可读标识符。 |
locale | 与此活动关联的语言区域。 |
providerType, providerId, actorId | 可用的生成者或执行者信息,具体角色取决于事件。 |
correlationId | 可用的关联引用,或空值。 |
eventAt, ingestedAt | 源端提供的事件时间和采集时间。请根据源端的时间戳规则解读两者的差异。 |
详情 payload | 已存储的事件证据,不可用时为空值。 |
了解源端的单元 #
Lingo.dev 事件可以描述一条已记录的翻译请求,也可以描述文档任务中的一个目标语言区域。请求中的文本包含源文本和目标文本的键值映射对象。任务中的文本按源文件对单元分组,并包含已完成的目标值;其中可能不含生成模型和令牌用量。两种形式都不能直接视为一个字符串。
Crowdin 事件标识提供方的字符串及其语言区域。源文本的添加、更新和删除,目标文本的更改,以及建议的创建、编辑、删除、批准和拒绝,都会映射为相应的事件类型。如果新旧目标文本均为空,则不会产生目标文本更改事件。复数形式对象会以 JSON 文本保留。
目标文本发生更改时,编辑测量会将其与该字符串的前一个版本比较:即同一字符串、同一语言区域在此次更改前最近一次创建或更新的目标文本,或事件携带的更改前文本。该版本通常是已交付的翻译,但也可能是更早的一次编辑。在将每处差异都归因于人工修正之前,请先核实比较的版本是否对应。同一建议的重复批准只记录一次。重复的拒绝操作会将接收时间纳入事件标识,因此无法保证所有重试都能去重。
Crowdin 的翻译和建议事件使用翻译的 createdAt 作为事件时间,批准事件也不例外。因此,今天收到的批准可能会显示在更早的建议创建日期下。接收时间用于区分对同一建议的重复拒绝,但不会替代事件时间;每个建议的批准只记录一次。日期筛选和历史评估使用 eventAt;请按记录的日期查找,而不要只查批准当天。与 ingestedAt 的时间差可能包含批准前的时间,因此不能将其视为单纯的采集延迟测量。源端时间戳缺失或无效时,会改用接收时间。
提供方、生成者和审核者的身份也各不相同。Lingo.dev 请求中的模型标识翻译的生成来源;Crowdin 批准记录中的用户标识在该提供方执行活动的人员。看到批准记录,并不能证明翻译已导出或已被应用加载。
追溯结果的证据 #
打开事件的测量结果,结合受检文本阅读评判标准。如果怀疑术语不符合要求,请检查该术语及其适用范围。如果规则未满足,请检查具体规则和解释。结果介绍了可用的回答、建议、用量和评判轨迹。
基于算法的测量可能不含 AI 请求,因为它会直接计算结果。基于模型的结果可能会展示实际使用的提示词和响应;如果结论似乎假定了未提供的上下文,请查看这些内容。轨迹不可用时,也就无法从中获得额外的评判信息。
如果使用智能体协助调查,请明确授权读取操作。已连接的工具也能更改配置或提交新翻译,因此是否复现需要另行决定,且可能产生用量。请求可帮助区分对原始工作的检查与新的尝试。