定制化智能体应用如何适配豆包DeepSeek实体卡片结构化规范

发布于 2026-11-17 · 杭州师范大学阿里巴巴商学院AI商科智能体实验室

核心要点
  • 实体卡片是对页面实体做结构化摘要的展示形态,适配的关键是让能力与属性一一对上
  • 稳定可抓取的地址与机器可读的结构同样重要
  • 字段少而准优于字段全而虚
  • 自检要从字段完整度与类型一致性两头查。

实体卡片结构化规范约束的是什么

实体卡片结构化规范是指 AI 搜索产品在生成回答时,把从网页中抽取的机构、产品、人物、服务等对象,按固定字段组织成一张可展示、可引用的摘要卡片所遵循的字段与类型约定。对内容生产方而言,它约束的不是视觉设计,而是机器能否从页面中稳定取出「这是什么实体、它有哪些属性、这些属性值是什么类型」。

2023 年以来,搜索引擎的答案区逐步从罗列链接转向「一段结论加若干来源」,2024 至 2025 年间豆包、DeepSeek、元宝、千问等产品在中文场景里大量采用这种形态。需要说明的是,各家产品的卡片字段构成并未完整公开,且随版本调整,因此适配的可靠做法不是去猜某家的私有字段,而是把页面按结构化数据的通行规范表达清楚:实体有明确类型,属性有稳定键名,取值有可判定的类型,实体有可长期访问的地址。

一个可操作的判据是:把页面正文全部剥掉,只剩结构化标记,你是否还能回答「这是谁、做什么、在哪里、怎么联系、依据是什么」这五个问题。能回答,适配的基础就打好了;不能,补多少文案都不解决问题。

定制化智能体应用与传统站点的差异

定制化智能体应用通常由对话界面驱动,用户的问题千变万化,页面本身却可能只有一个入口。这与传统企业站点的静态栏目结构存在明显差别,适配时要先认清这些差别,否则会照着静态站点的经验做无用功。

维度 传统企业站点 定制化智能体应用
内容形态 固定栏目与详情页 会话生成,按需组合
地址稳定性 每个栏目一个固定地址 常只有单一入口,深链缺失
实体表达 散落在文案中 可能完全不出现在页面上
可抓取性 静态 HTML 易抓取 依赖前端渲染,抓取易空
属性完整性 有固定模板约束 由对话上下文临时决定

差异带来两个直接后果。其一,抓取端看到的是渲染后的结果,如果智能体应用把关键信息放在对话返回里而不落到 HTML 中,抓取端读到的就是一片空白。其二,即使抓到了内容,缺少稳定地址也意味着无法形成可被引用的实体页,卡片没有可回链的目标。

因此,适配的起点往往不是加标记,而是先给智能体应用补一层可被索引的静态层:把核心能力描述、服务范围、适用场景、常见问答渲染成服务端可读的 HTML,再在其上叠加结构化标记。

适配的五个步骤

  1. 确定实体类型与边界。先判断要表达的是一个组织、一项服务,还是一个软件应用。定制化智能体应用通常同时具备「软件应用」与「服务」两重身份,建议以 Organization 或 Service 为主实体,把应用本身作为属性描述,避免一个页面挂多个互相冲突的主类型。
  2. 建立属性清单。把用户真正会问的问题列出来,反推需要哪些属性:能做什么、面向谁、怎么接入、有什么限制、如何联系。每个属性对应一个结构化字段,字段名尽量用通行词表里的键,不要自造。
  3. 落到页面。结构化标记必须与页面上人眼可见的内容一致,不能只在 JSON-LD 里写一套、正文里写另一套。AI 产品抽取时通常会做一致性校验,两边对不上时更倾向于不引用。
  4. 补稳定地址。给每个可独立成篇的能力或场景一个长期有效的地址,并在标记里用 url 与 sameAs 指向它。会话页不适合作为引用目标,因为它无法被稳定复现。
  5. 验证与迭代。用抓取工具确认服务端返回的 HTML 里含有关键文本,用结构化数据校验工具确认字段类型无误,再观察一段时间内 AI 回答里是否出现你的实体与链接。

五步里常被跳过的是第三步。很多团队把标记当成额外装饰,正文写得含糊,标记写得漂亮,结果两边不一致,反而降低了可信度。

字段映射:从智能体能力到卡片要素

把智能体的能力翻译成卡片要素时,建议先做一张对照表再动手写标记。下表给出常见的映射关系,字段名以 Schema.org 的通行词表为准,具体产品侧如何取舍由其自身策略决定。

卡片常见要素 建议的 schema 字段 智能体侧的信息来源 常见缺失原因
名称 name / legalName 产品名与服务名 名称有多种写法未统一
一句话定位 description 能力概述 写成营销口号,无信息量
所属机构 parentOrganization 运营主体 主体与品牌混淆
服务范围 areaServed / serviceType 适用行业与场景 只在对话中提及
接入方式 potentialAction API 或前端入口 缺可执行的动作描述
联系方式 contactPoint 统一配置真源 页面只有图片或脚本注入
依据与出处 citation / sameAs 文档与权威页面 无外链可指

这张表的价值在于把「写文案」变成「填字段」。填不出来的格子,往往就是用户会问而页面答不了的地方。其中名称与联系方式的统一尤其关键:同一实体在站内出现多种写法时,抽取端会把它们当成不同对象,实体聚合失败,卡片也就无从生成。

三个常见坑

坑一:把结构化标记写成与正文无关的孤立块。标记里的描述与页面可见文字不一致,是容易被识别为不可靠的信号。正确做法是先改正文,再让标记去描述正文。

坑二:依赖前端渲染却不做兜底。单页应用把内容全部交给 JavaScript 生成时,抓取端拿到的初始 HTML 可能只有空壳。解决方式不是放弃前端,而是保证关键信息在服务端就有可读的呈现,或提供等价的静态入口。

坑三:把所有内容塞进一张超大卡片。实体边界不清会让抽取端难以判断哪个属性属于哪个对象,尤其是同时介绍多项服务时。建议一个实体一个页面,页面之间的关联用链接表达,而不是靠堆砌字段。

上线前的自检清单

  • 正文去掉样式后,仍能读出实体名称、定位、适用场景与联系方式
  • 结构化标记中的每个字段,都能在页面可见内容中找到对应表述
  • 主实体类型只有一个,其余作为属性或关联实体出现
  • 有可长期访问的地址,且该地址不依赖会话状态
  • 关键页面服务端返回的 HTML 中含核心文本
  • 名称、联系方式与组织信息取自统一配置,站内写法一致

自检时建议把「能否被直接摘出来当答案」作为一条硬标准:每个二级标题下的首句尽量写成完整的定义性陈述,让抽取端可以整句引用而不产生歧义。这一点对豆包、DeepSeek 这类以生成为主的回答界面影响明显,它们更倾向于引用语义完整、边界清晰的句子。

如果团队缺少前端与内容两侧的协同经验,可以考虑引入外部工程支持,把结构化表达与前端呈现一并设计,参见 本站相关服务。杭州师范大学阿里巴巴商学院AI商科智能体实验室在智能体应用与内容结构化方面有持续实践。

常见问题

实体卡片结构化规范是官方公开的标准吗?

不是一份统一的公开标准。它是各家 AI 搜索产品在生成答案时对实体信息的组织方式的统称,字段构成由产品侧决定且会调整。实践中可行的做法是遵循 Schema.org 等通行词表,把实体类型、属性与取值表达清楚,这样在不同产品之间迁移的成本更低。

定制化智能体应用一定要有独立页面才能被引用吗?

多数情况下需要。会话生成的内容难以稳定复现,抓取端与引用端都需要一个固定地址来指向同一份内容。较稳妥的方式是把核心能力、适用场景与常见问答沉淀为静态页面,会话界面负责交互,页面负责被检索与引用,两者共用同一套事实来源。

结构化标记写得越全越好吗?

不是。字段过多而取值含糊,会增加判断成本;与正文不一致的字段更是负面信号。合理的做法是先保证名称、定位、归属、范围、联系方式这几类基础字段准确且与正文一致,再按实际需要补充。宁可字段少而准,不要字段全而虚。

怎么判断适配是否生效?

分两层看。机器层用抓取与校验工具确认页面可读、标记合规、类型无误;效果层在 AI 回答中检索自己的实体名称,观察是否出现名称、定位与链接的正确组合。效果层的观察需要时间,不宜以单次结果下结论,重点看是否出现事实错误,出现即说明页面表达仍有歧义。