网易首页 > 网易号 > 正文 申请入驻

六条记录就是六次尝试?追踪日志最容易数错的东西

0
分享至

一条追踪记录里,同一个工具名出现了六次。这个智能体到底尝试了几次操作?


六,是个很诱人的答案。但它也可能是三次调用、每次留下开始和结束两条记录;可能是两次调用,其中一次遥测数据被重复投递;也可能是六次互不相关的操作,只是恰好用了同一个工具名。

数行数很容易,数尝试次数则需要一套身份模型。这是 AgentInspect 维护者在测试中反复强调的一点:这里讨论的是如何解读执行证据,而不是实现实时重试,也不是承诺"恰好一次"的效果。

给每个标识符安排一个职责

一套可用的词汇是这样的:一次尝试可以发出多条事件;一条事件可能被投递不止一次;一次操作可以跨越多次尝试。这些是关系,不是可以互换的计数器。传输层的重复投递,和应用层的重复执行,必须保持可区分。

记录身份要放在操作被调用的地方。测试中安装的是固定版本:

  • npm install --save-exact agent-inspect@6.31.35

然后使用带元数据的 step() 接口。在这个版本里,step.tool() 这个快捷方式只接受名称和函数,不接受第三个元数据参数。

示例里构造了两次读取尝试:第一次抛出"合成临时失败"的错误,第二次成功返回。第一次的错误被主动吞掉,这是测试夹具的刻意行为,不是通用的错误处理建议——它代表的是一条有边界的恢复路径,第一次失败、第二次成功。

这些 ID 是静态的,因为测试跑在隔离的夹具里。真实应用的身份标识需要合适的唯一性和作用域,不能把 fixture-op-1 复用到互不相关的操作上,还指望评估器自己推断出区别。

问规则你真正想问的问题

打开生成的追踪文件后,可以评估两份契约:一份要求最多 1 次尝试,一份要求最多 2 次。对这份源夹具来说,前者以 contract.retry.max-attempts 失败,后者通过。这个结果指向的是与已记录逻辑操作相关联的尝试次数,而不是 JSONL 的总行数。

当前实现会在一次运行内按显式的重试身份分组,优先使用不同的尝试 ID,也支持其他有文档记录的证据形式,包括经过校验的尝试编号。身份缺失或相互冲突,并不等于可以凭一个重复出现的名字就凭空发明一条重试关系。

更重要的工程决策发生在写规则之前:你的应用在哪里定义"逻辑操作"?一个适配器无法可靠地重建你从未记录过的业务边界。

重复投递是个好用的负向对照

配套测试把第二次尝试的终止记录原样复制,追加到源追踪里,然后重新评估同样的契约。这是一个刻意收窄的主张:一条完全相同的重复投递记录,不应该凭空多造出一次尝试。但也不能反推说,所有看起来重复的记录都可以丢掉。

如果同一个声明的身份带着不同的参数、状态或归属出现,那就是需要调查的冲突。直接用 new Map(events.map(e => [e.id, e])) 覆盖,可能把互相矛盾的证据抹掉,只留下最后到达的那一行。所以一套有用的测试集,应该同时包含精确重复和冲突复用,并把两者的预期结果分开。

别把尝试次数升格成效果次数

两次尝试不能证明写了两次,一次超时也不能证明一次都没写,一个成功的响应同样不必然证明接收方观察到了效果。对读取操作来说,这个区别也许只影响延迟分析;但对支付、通知、预订来说,它改变的是整个恢复协议。

元数据里记录了一个 idempotencyKey,只能证明这个键被记录过。要声称目标端对效果做了去重,你需要目标端的行为和范围合适的回执。AgentInspect 的追踪分析不是那个目标端。

这也是为什么重试记账、效果验证和授权应当作为三项独立检查:它们可能用到相关的标识符,但回答的是不同的问题。

如果导出追踪,读回导出表示后还要再跑一遍尝试计数检查。一棵结构合法的 span 树,可能保留了每一个工具名,却丢掉了操作元数据。配套的 OTLP 实验在这份夹具上保住了重试判定,前提是运行状态被单独评估;它同时暴露了恢复之后的一处运行状态不一致。通过一项不变量,不等于语义完全等价。

从一个操作、两次尝试、一次重复投递开始。这个小夹具往往比一条塞满看似合理计数器的庞大追踪更有信息量。

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
人类进化出胡须,是用来干嘛的?为什么白人胡子比黄种人多?

人类进化出胡须,是用来干嘛的?为什么白人胡子比黄种人多?

心中的麦田
2026-11-15 17:40:14
打破迷信!最吉利的数字不是6和8,真正顶级吉数藏着大智慧

打破迷信!最吉利的数字不是6和8,真正顶级吉数藏着大智慧

娱乐圈见解说
2026-11-17 08:20:03
2-1!熊猫杯冠军诞生,中国U19梦幻开局,用9分钟2球打懵韩国U19

2-1!熊猫杯冠军诞生,中国U19梦幻开局,用9分钟2球打懵韩国U19

汪星人哟
2026-11-17 21:36:05
申花组无敌战舰冲冠!引多名强援加盟,与巴西前国脚传闻,中超首冠就在明年?

申花组无敌战舰冲冠!引多名强援加盟,与巴西前国脚传闻,中超首冠就在明年?

蜡笔小新爱体育
2026-11-17 17:51:55
姑娘,出去玩也要注意下穿着,旁边大爷看了直摇头,好尴尬

姑娘,出去玩也要注意下穿着,旁边大爷看了直摇头,好尴尬

舞指飞扬
2026-11-13 07:42:15
陈小春开丰田北上广东,20多年的老车,外观却让人过目不忘

陈小春开丰田北上广东,20多年的老车,外观却让人过目不忘

总李谈车
2026-11-16 19:54:04
“寝室没一个面相正常的”,女生宿舍跳舞视频走红,精气神儿却输了:滤镜下的那张脸,和一群断了线的风筝

“寝室没一个面相正常的”,女生宿舍跳舞视频走红,精气神儿却输了:滤镜下的那张脸,和一群断了线的风筝

蝴蝶花雨话教育
2026-11-17 00:05:18
杨瀚森正负值+11!开拓者98-106森林狼,谁是输球罪魁?数据不说谎

杨瀚森正负值+11!开拓者98-106森林狼,谁是输球罪魁?数据不说谎

球场没跑道
2026-11-17 11:41:48
为啥某多多的商品很便宜?网友:做电商的都知道,其实货都是一样的

为啥某多多的商品很便宜?网友:做电商的都知道,其实货都是一样的

带你感受人间冷暖
2026-11-16 10:34:09
王小洪会见越共中央政治局委员、越南公安部部长梁三光

王小洪会见越共中央政治局委员、越南公安部部长梁三光

新华社
2026-11-17 19:55:01
你抛美债,我抛中债!外资纷纷减持中国债,大量资金流向美国?

你抛美债,我抛中债!外资纷纷减持中国债,大量资金流向美国?

明天见灌装冰块
2026-11-17 09:33:32
多国领导人已陆续抵达广东

多国领导人已陆续抵达广东

广东发布
2026-11-17 19:23:35
为国足豁得出去!拜合拉木冒受伤风险飞身冲顶破门 险被对手踢到头

为国足豁得出去!拜合拉木冒受伤风险飞身冲顶破门 险被对手踢到头

念洲
2026-11-17 21:46:20
特朗普期待访华:将与中俄元首会晤,也可能与金正恩委员长会面

特朗普期待访华:将与中俄元首会晤,也可能与金正恩委员长会面

每日经济新闻
2026-11-17 21:10:29
APEC期间特朗普与普京将在中国会见金正恩?外交部回应

APEC期间特朗普与普京将在中国会见金正恩?外交部回应

澎湃新闻
2026-11-17 16:23:54
大战逼近,却无人阻止

大战逼近,却无人阻止

最爱历史
2026-11-16 17:59:51
传腾讯内部空前危机感:AI也会被替代!

传腾讯内部空前危机感:AI也会被替代!

城事堂
2026-11-17 00:05:10
再见,曼城!2.2亿“超巨”将转投皇马!顶级射手“空降”加盟

再见,曼城!2.2亿“超巨”将转投皇马!顶级射手“空降”加盟

头狼追球
2026-11-17 16:53:03
"爱泼斯坦侵犯了我200多次",最新纪录片中多名模特讲述噩梦往事

"爱泼斯坦侵犯了我200多次",最新纪录片中多名模特讲述噩梦往事

叨唠
2026-11-16 21:19:24
名单没日本,高市早苗不来深圳APEC?别误会

名单没日本,高市早苗不来深圳APEC?别误会

爱下厨的阿酾
2026-11-17 06:16:19
2026-11-17 22:08:49
全栈遛狗员
全栈遛狗员
白天跟需求对线,晚上在小区遛狗。
204文章数 128关注度
往期回顾 全部

科技要闻

硅谷大佬组局,帮黄仁勋杀回来!

头条要闻

中国女子在希腊失踪半年 保险箱发现10万欧元现金

头条要闻

中国女子在希腊失踪半年 保险箱发现10万欧元现金

体育要闻

伪强队?拥4亿豪阵欧国联6连败+世界杯出局

娱乐要闻

陈晓楠对话厉娜和许飞引全网热议

财经要闻

10万人逼宫英伟达,黄仁勋要复职了?

汽车要闻

更豪华更好开 问界新M8细节升级见真章

态度原创

艺术
健康
房产
教育
亲子

艺术要闻

漫天香氛,秋风醉人~杭州的秋天从不让人失望!13个地方,秒出大片!

情绪真能让健康人"伤心至死"?

房产要闻

6.6亿!海口卖地!

教育要闻

济南市历下区燕山小学教育集团将出席2026第四届课博会,解码“做中学”视域下小学科学教育生态构建

亲子要闻

宝宝气人但是聪明的4个行为

无障碍浏览 进入关怀版