Merged
fix(registry): keep A2A extension fields on agent cards #347
fix(registry): keep A2A extension fields on agent cards #347
Merged
庄昭雄Add on Oct 18
庄昭雄
庄昭雄
Oct 18

Paired: GitHub #143 ↔ GitCode !347

问题

AgentRegistry/a2x_registry/register/models.py 里 AgentCard 顶层开了 extra="allow",但三个嵌套模型 AgentSkill / AgentProvider / AgentCapabilities 没有。解析远端或 API 注册的 A2A Agent Card 时,Pydantic 会静默丢弃协议扩展字段:

capabilities.extensions
skills[*].extension
provider 的扩展字段

随后 RegistryService._entry_to_output() 用 card.model_dump(exclude_none=True) 写 service.json,注册中心记录不再保真;GET /services 也拿不到这些字段。同仓 C++ SDK 的 types.h 明确有 AgentCapabilities.extensions / AgentSkill.extension,证明它们是协议字段而不是私有扩展。

真实链路:register A2A / 启动时 fetch_agent_card → AgentCard(**data) → RegistryEntry.agent_card → _entry_to_output → service.json / GET /services。

改动

models.py(+6):三个嵌套模型各加 model_config = ConfigDict(extra="allow");新增 AgentRegistry/tests/registered/test_agent_card_extensions.py(带 capabilities.extensions、skills[0].extension、provider.extra 的 card,断言 model_dump 后原样保留)。

验证

纯 Python/Pydantic(无外部服务):

字段 改前 model_dump 改后 model_dump
capabilities.extensions 丢失(只剩三个 bool) 原样保留
skills[0].extension 丢失 原样保留
provider.extra 丢失 原样保留
  • pytest AgentRegistry/tests/registered -q → 5 passed
  • 只回退 models.py(保留新用例)→ 1 failed;恢复 → 1 passed
  • 未起 Registry/API、未抓真实 Agent Card(模型级复现);registry 全量有 4 条缺 sentence_transformers 的可选依赖失败(C 类,未计入)

查重

issue 76(60 closed / 16 open)+ PR 346(213 merged / 114 closed / 19 open),extension / 扩展 / capabilities / agent card 无同缺陷。本 PR 只改 register/models.py 与新增测试,与 #273(cpp-sdk libcurl/HTTP server)、#274(A4P 文档/pyproject/tests)、#276(backend __main__.py mTLS)、#346(client cli.py)零重叠。

likedislike
Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for 庄昭雄's contribution.)
atomgit-bot
atomgit-bot
Oct 18 Comments:

变更摘要

本次变更聚焦于注册表中 A2A 代理卡片的模型解析与输出,解决扩展字段在解析过程中被丢弃的问题。在 AgentRegistry/a2x_registry/register/models.py 中,为 AgentSkill、AgentProvider、AgentCapabilities 三个模型新增 model_config = ConfigDict(extra="allow"),使模型能够保留 A2A 协议规范之外的扩展字段,并在 model_dump 输出时继续保留;同时新增 AgentRegistry/tests/registered/test_agent_card_extensions.py 测试,验证 capabilities、skills、provider 上的扩展字段能够通过 AgentCard.model_validate 解析并存活于序列化结果中。

主要改动

  • AgentSkill 支持扩展字段: 新增 model_config = ConfigDict(extra="allow"),使技能上的协议扩展字段在解析与输出时被保留。
  • AgentProvider 支持扩展字段: 新增 model_config = ConfigDict(extra="allow"),使提供者上的额外字段在解析与输出时被保留。
  • AgentCapabilities 支持扩展字段: 新增 model_config = ConfigDict(extra="allow"),使能力声明中的扩展(如 extensions)在解析与输出时被保留。
  • 新增扩展字段留存测试: 新增 test_agent_card_extensions.py,通过 AgentCard.model_validate 与 model_dump(exclude_none=True) 断言 capabilities、skills、provider 的扩展字段均未被丢弃。
likedislike
Incorrect?
atomgit-bot
atomgit-bot
Oct 18 Comments:

代码审查

✅ 未发现问题

likedislike
Incorrect?
OopenJiuwen-botCollaborators
Oct 18 Set YiyangShao,xinyu-jiuwen as approver
atomgit-bot
atomgit-bot
Oct 18 Comments:

AtomGit AI 助手使用指南

在 PR 评论中使用命令即可触发。支持在普通评论和代码行评论中使用。

功能 命令 说明
代码审查 /ai review 检查代码质量、潜在问题、安全风险
PR 摘要 /ai summary 生成 PR 变更内容的结构化摘要
代码解释 /ai explain 解释代码变更的逻辑和意图
自由提问 @atomgit-bot <问题> 询问关于本 PR 的任何问题
帮助 /ai help 显示此帮助信息

免责声明

AI 助手可能存在误判,请结合自身判断。可以对评论点 👍 或 👎 帮助我们改进。

likedislike
Incorrect?
OopenJiuwen-botCollaborators
Oct 18 Added label: sig/sig-agent-protocol
openJiuwen-botCollaborators
Oct 18 Comments:

欢迎来到 openJiuwen 社区

Hey @grandocean , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。

联系指引

有疑问可以联系 SIG: sig-agent-protocol ,
维护者是: @YiyangShao, @xinyu-jiuwen ,
审核者是: @gcw_hx9prznZ, @mingo007 .

likedislike
庄昭雄庄昭雄
Oct 18 Modify description of pull request
OopenJiuwen-botCollaborators
Oct 18 Added label: openJiuwen-cla/yes
openJiuwen-botCollaborators
Oct 18 Comments:

CLA 签署成功

grandocean, 感谢您的代码贡献。 所有的代码贡献者都已完成了 CLA 签署。 👍

likedislike
Oopenjiuwen-syncCollaborators
Oct 18 Modify description of pull request
openJiuwen-botCollaborators
Oct 18 Comments:

The pipeline(pipeline number:347) is running. Please wait a moment...

likedislike
OopenJiuwen-botCollaborators
Oct 18 Added label: ci-running
OopenJiuwen-botCollaborators
Oct 18 Removed label: ci-running
openJiuwen-botCollaborators
Oct 18 Comments:
任务名称 结果 日志操作
静态检查 ✅SUCCESS 点此跳转
防投毒检查 ✅SUCCESS 点此跳转
开源合规检查 ✅SUCCESS 点此跳转
禁用词扫描 ✅SUCCESS 点此跳转
likedislike
OopenJiuwen-botCollaborators
Oct 18 Added label: ci-successful
zhengwCollaborators
29 days ago Comments:

方案没有问题,通过。

likedislike
maoqiming
maoqimingCollaborators
29 days ago Comments:

/lgtm
/approve

likedislike
OopenJiuwen-botCollaborators
29 days ago Added label: approvedlgtm-mingo007
openJiuwen-botCollaborators
29 days ago Comments:

Review Code Feedback

  • The label lgtm-mingo007, approved was added to this pull request. It means that mingo007 reviewed the code changes. 👋
Tips
  • If this pull request is not merged while all conditions are met, comment /check-pr to try again. 😄
likedislike
OopenJiuwen-botCollaborators
29 days ago Merged pull request
OopenJiuwen-botCollaborators
29 days ago Removed label: ci-successful