# 草料二维码已支持 Agent Card：AI 能读取你的二维码内容

过去半年，我们在用户咨询和接入沟通中反复收到同一类反馈：很多企业在用二维码做设备、资产和产品的管理。随着企业开始把 AI 智能体（Agent）接入工单、盘点、售后或知识库，原来供人查看的二维码内容也需要被 Agent 读取。

但二维码页面主要供人查看，Agent 只能通过截图、逐段复制或模拟浏览器解析页面获取内容。这样的接入方式比较麻烦，也容易出现识别不完整或理解错误。

这些用户希望，企业自己的 Agent 能直接读取二维码内容，不再依赖截图和人工转录。针对这一需求，草料提供了 Agent Card，让二维码内容可以被 AI 读取。

## 一、物品数据要被机器读取，需要什么

物品数据要被 Agent 稳定读取，需要同时具备结构化数据，以及统一的发现和调用方式。

一是结构化的数据。页面上的“3 号灭火器”，人一眼就懂是设备名称；对机器来说，这只是一串没有语义标注的字符，只能模糊推测，容易出现幻觉。机器需要的是每个字段都标明属性的数据：哪个是名称、哪个是型号、哪个是当前状态。

二是统一的发现和调用方式。目前各平台的物品数据格式和接口都是各自定义的，同一类信息在不同系统里有不同的字段名和组织方式，Agent 每接入一家平台都要单独适配一次，读取成本很高。A2A 和 MCP 为智能体发现服务、调用工具和读取数据提供了开放协议机制。服务方可以公开机器可读的说明，让 Agent 按协议发现服务并调用对应接口。

## 二、草料二维码已支持 Agent 直接读取

草料二维码基于 A2A、MCP 等开放协议，提供面向智能体的只读数据接口，并通过 .well-known 路径公开服务说明，与 GB/Z 185—2026《人工智能 智能体互联》的智能体描述与发现方法保持结构一致。支持相应协议并能调用公开端点的智能体，可以读取二维码对应的公开结构化数据。

这套能力由两个部分实现：负责服务发现的 Agent Card，以及承载物品数据的 ObjectCard。

Agent Card 是一张提供给智能体的“机器名片”：一份部署在域名标准位置（.well-known）的机器可读元数据文档，向 Agent 说明这个服务由谁提供、能提供哪些数据、按什么规则调用。Agent 拿到草料二维码链接后读这份名片，就知道接口在哪、怎么调，不需要人工配置。

发现服务之后，Agent 查询到的是 ObjectCard，一份面向“物”的结构化档案，包含物品身份、当前状态、公开履历和人工操作入口。每个字段都标明属性，Agent 可以直接解析，不再从网页里猜。

ObjectCard 采用了“码物分离”的设计：二维码只是档案的访问入口，不等于物本身。码因损毁、重印被更换，物的身份和历史档案不受影响。

整套能力是一层基础设施，不是一个独立的 AI 助手。

## 三、Agent 读取二维码后，可以做什么

Agent 读取公开结构化物品档案后，可以用于单个物品问答、批量分析和业务流程衔接。

围绕一件物品提问。现场人员把二维码链接交给企业 Agent，直接询问：这台设备是什么型号、现在是什么状态、最近有哪些公开的维护记录、出现问题应该进入哪个页面处理。Agent 先识别具体对象，再结合企业知识库回答，不再依赖口头转述。

批量读取与分析。把一组设备、产品或资产的二维码链接交给 Agent，由它汇总公开的巡检维护信息、生成检查清单、核对固定资产档案。二维码提供具体对象的身份和数字履历，Agent 负责理解问题、整理数据和完成分析。

作为业务流程的上下文。当企业自己的 Agent 已经接入工单、资产、售后或知识库系统时，读到的物品档案可以作为后续流程的输入：生成巡检任务、提交分析结果、发起维修或售后流程。这些业务动作由企业的 Agent 在已有权限体系内完成，不由草料的只读工具执行。

## 四、怎么接入

可以根据现有 Agent 支持的协议选择对应入口：通过 Agent Card 完成服务发现，或通过 MCP 端点调用只读工具。具体调用方式以各端点返回的声明为准。

各接入点均公开可查、可直接测试：

- 国标对齐声明：[https://a2a.objqr.com/.well-known/aip-agent.json](https://a2a.objqr.com/.well-known/aip-agent.json)
- Agent Card（平台服务名片）：[https://a2a.objqr.com/.well-known/agent-card.json](https://a2a.objqr.com/.well-known/agent-card.json)
- 二维码域名发现（用户码分发在这些域名下）：
  - [https://qr71.cn/.well-known/agent-card.json](https://qr71.cn/.well-known/agent-card.json)
  - [https://qr61.cn/.well-known/agent-card.json](https://qr61.cn/.well-known/agent-card.json)
- MCP 只读服务端点：[https://mcp.objqr.com/mcp](https://mcp.objqr.com/mcp)

## 五、Agent 能读取哪些数据

Agent 读到的范围与普通用户扫码看到的一致，只是转换成了结构化形式。当前上线的 5 个 MCP 工具均为只读。

已开放：公开级数据的只读访问。即二维码页面中已设置为对扫码者公开展示的内容：

- 物品基础档案，如设备名称、型号
- 公开的当前状态
- 公开展示的表单记录，如巡检、维保记录

不开放的内容：仅账号内可见的记录、企业内部经营数据、需要登录或额外权限才能查看的数据、内部统计报表，以及修改二维码内容、提交表单、审批流转等写入操作。ObjectCard 中的人工操作入口只是页面链接，点开后仍走原有的身份验证流程，不构成对智能体的授权。

开发中：授权级只读访问。对于需要读取企业内部业务数据或其他非公开内容的场景，我们正在推进基于 OAuth 的授权方式：由客户主动授权后，Agent 可以在明确的授权范围内读取部分内部数据，并支持随时撤销授权。

## 六、关于数据接口的标准化

Agent 读取二维码数据，只是问题的一角。AI 在获取各类业务信息时，普遍面临同样的情况：各平台接口各自定义、互不统一，读取效率和准确率都受影响。不少用户在使用中也向我们提到过这类困扰。

这类问题不是某一家平台能单独解决的，需要行业层面的统一约定。欧盟正在通过[电池法规](https://eur-lex.europa.eu/legal-content/EN/TXT/?qid=1694013980794&uri=CELEX%3A32023R1542)和[《可持续产品生态设计法规》（ESPR）](https://eur-lex.europa.eu/eli/reg/2024/1781/oj/eng)分品类推进产品数字护照。按照欧盟电池法规，自 2027 年 2 月 18 日起，轻型交通工具电池、容量超过 2 kWh 的工业电池和电动汽车电池需要配备电池护照；ESPR 则建立了更广泛的产品数字护照制度框架。国内相关标准也在建设中。

我们把用户遇到的情况做了整理，在 2026 年 7 月以标准立项建议《产品数字护照（DPP）数据访问与查询接口要求》的形式，提交给了全国产品数字护照标准化工作组，希望能尽一份力。

## 附：名词解释

- AI 智能体（Agent）：能自主查询资料、调用工具、执行流程以完成任务的 AI 程序，区别于只做问答的对话式 AI
- A2A（Agent2Agent）协议：智能体之间互相发现、对话与协作的开放协议，2025 年由 Google 发起，现由 Linux 基金会托管
- Agent Card：A2A 协议定义的机器可读“能力名片”：一份放在域名标准位置的元数据文档，描述服务方的身份、能力与调用方式
- ObjectCard：草料二维码面向“物”设计的结构化数字名片，描述物品身份、二维码身份及二者的绑定关系，并涵盖当前状态、公开履历和操作入口
- 码物分离：草料二维码 ObjectCard 的设计原则：二维码是物品数字档案的访问载体，物的身份独立于二维码存在，更换二维码不影响档案延续
- .well-known：域名下的约定路径（如 域名/.well-known/agent-card.json），机器可读的声明文件统一放在这里，程序无需人工告知即可自动发现
- MCP（Model Context Protocol）：智能体调用工具、读取数据的通用接口协议，由 Anthropic 于 2024 年底提出，目前应用广泛
- GB/Z 185—2026：《人工智能 智能体互联》，中国 2026 年 5 月发布的国家标准化指导性技术文件，涵盖智能体描述、发现、交互、工具调用等 7 个部分
- DPP（产品数字护照）：为每件产品建立的全生命周期数字档案，含来源、构成、维修、回收等信息；欧盟 ESPR 法规已将其列为要求，中国国家标准体系建设中

如果你在接入过程中遇到问题，或者有想让 Agent 完成的场景，欢迎在评论区留言。