Merged
fix(registry): keep A2A extension fields on agent cards #347
庄昭雄Add on Oct 18
fix(registry): keep A2A extension fields on agent cards #347
Merged
Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for 庄昭雄's contribution.)atomgit-bot
Oct 18 Comments:
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的扩展字段均未被丢弃。


Incorrect?
atomgit-bot
Oct 18 Comments:
Oct 18 Comments:
Oct 18 Set YiyangShao,xinyu-jiuwen as approver
atomgit-bot
Oct 18 Comments:
Oct 18 Comments:
Oct 18 Added label: sig/sig-agent-protocol
openJiuwen-bot
Oct 18 Comments:
Oct 18 Comments:
欢迎来到 openJiuwen 社区
Hey @grandocean , 感谢你对社区的贡献.
机器人使用手册
有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。
联系指引
有疑问可以联系 SIG: sig-agent-protocol ,
维护者是: @YiyangShao, @xinyu-jiuwen ,
审核者是: @gcw_hx9prznZ, @mingo007 .


Oct 18 Modify description of pull request
Oct 18 Added label: openJiuwen-cla/yes
openJiuwen-bot
Oct 18 Comments:
Oct 18 Comments:
Oct 18 Modify description of pull request
openJiuwen-bot
Oct 18 Comments:
Oct 18 Comments:
The pipeline(pipeline number:347) is running. Please wait a moment...


Oct 18 Added label: ci-running
Oct 18 Removed label: ci-running
openJiuwen-bot
Oct 18 Comments:
Oct 18 Comments:
Oct 18 Added label: ci-successful
maoqiming
29 days ago Comments:
29 days ago Comments:
/lgtm
/approve


29 days ago Added label: approvedlgtm-mingo007
openJiuwen-bot
29 days ago Comments:
29 days ago Comments:
29 days ago Merged pull request
29 days ago Removed label: ci-successful
Paired: GitHub #143 ↔ GitCode !347
问题
AgentRegistry/a2x_registry/register/models.py里AgentCard顶层开了extra="allow",但三个嵌套模型AgentSkill/AgentProvider/AgentCapabilities没有。解析远端或 API 注册的 A2A Agent Card 时,Pydantic 会静默丢弃协议扩展字段:随后
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_dumpmodel_dumpcapabilities.extensionsskills[0].extensionprovider.extrapytest AgentRegistry/tests/registered -q→ 5 passedmodels.py(保留新用例)→ 1 failed;恢复 → 1 passedsentence_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__.pymTLS)、#346(client cli.py)零重叠。