我的应用:AI家医助手状态:审核中 · 已提交2天
查看进度
查看进度
凭证 AppKeysk-4t-****7f2a(沙箱)
调用额度:1,000次/日
调用额度:1,000次/日
沙箱环境MCP端点已连通 ✓
本月联调请求:3,204
本月联调请求:3,204
合规检查健康数据类目 → 需脱敏声明
去补充
去补充
开放平台 / 运营平台 / 用户后台 / MCP·A2A规范 —— 六类实际产出物的样子
岗位:平台产品经理(MJ000170) 4T数字生活空间二期 备战版 · 2026-10-13开放平台 / 运营平台 / 用户后台 —— 每套 = 一份PRD文档 + 一套原型图
| 章节 | 内容要点 |
|---|---|
| 文档信息 | 版本号 V1.0 / 作者 / 评审人(研发负责人、运营负责人、合规)/ 评审记录 |
| 背景与目标 | 为什么建(一期272万用户无生态入口)· 成功指标(首批入驻服务商数、Skill上架数、调用量) |
| 名词定义 | Skill / 服务商 / MCP会话 / 调用凭证 AppKey / 数据不出盒 … |
| 角色与权限 | 开发者 / 平台审核员 / 运营 / 合规 / 市民 —— 谁能干什么 |
| 业务流程图 | 入驻→联调→审核→上架→调用→结算 全链路 |
| 功能清单 | 模块 × 功能 × 优先级(P0上线必带 / P1三个月内 / P2规划中) |
| 页面原型说明 | 每个页面的布局、字段、状态、异常提示(配Figma/墨刀链接) |
| 非功能需求 | 安全合规(等保/数据不出盒)、性能(网关QPS)、审计日志 |
| 里程碑 | 需求冻结日 / 提测日 / 上线日 —— 对齐项目验收节点 |
同法再出两张:运营平台(审核队列+看板)、用户后台(记忆/授权管理)。工具用 Figma 或墨刀,PRD 里贴截图+跳转链接。
你主导制定 —— 全生态的「插座国标」,一份对外发布的 PDF/在线文档
| 章节目录(示意) | 管什么 |
|---|---|
| 1. 术语与角色 | Skill、Agent、会话、凭证的定义 —— 避免各说各话 |
| 2. 接入总流程 | 注册 → 创建应用 → 沙箱联调 → 审核 → 上架 五步 |
| 3. 认证与鉴权 | AppKey + 签名算法、Token有效期、权限Scope申请 |
| 4. Skill 清单(Manifest)规范 | 每个Skill必须声明:能力、端点、所需数据、计费事件 |
| 5. MCP 协议接入 | 工具/数据怎么挂进来:tool列表、调用格式、超时重试 |
| 6. A2A 协作规范 | Agent间发现与任务委托的消息格式、责任边界 |
| 7. 数据安全与脱敏 | 健康/未成年人数据分级、脱敏字段表、留存期限 |
| 8. 计费事件上报 | 什么算一次调用、怎么报计量事件(对账依据) |
| 9. 审核与变更 | 上架审核项清单、版本升级怎么报备、下架流程 |
| 10. SLA 与违规 | 可用性承诺、违规下架红线(如私自留存市民数据) |
{
"skill": {
"name": "ai-family-doctor", // 全局唯一ID
"version": "1.2.0",
"category": "health", // 类目决定合规审查级别
"endpoints": { "mcp": "https://api.a.com/mcp" },
"auth": { "type": "appkey+sign", "scopes": ["health.basic"] },
"data": { // 数据声明:审核按此核查
"collects": ["weight", "blood_pressure"],
"storage": "home-box-only", // 必须声明:数据不出盒
"retention_days": "user-controlled"
},
"billing_events": ["call.success"], // 计量口径,分账依据
"sla": { "p99_ms": "2000", "availability": "99.5%" }
}
}
为什么这份文档值钱:它同时是技术接口、合规底线、计费口径三合一 —— 平台的话语权就在这份文档里。
JD原文「确保平台建设节点按时上线」—— 你要交的是一张 Everyone 都认的排期表
| 里程碑 | 交付物 | 验收标准(写进排期表的) |
|---|---|---|
| M1 授权体系 | 授权系统上线 | 任何Skill调市民数据前必须过授权页;审计日志100%留痕 |
| M2 开放平台MVP | 门户+网关+沙箱 | 外部开发者自助完成注册→联调 全程 ≤ 3个工作日 |
| M3 首批内测 | 5家服务商接入 | 至少1个真实Skill在市民盒子/APP跑通全流程 |
| M4 市场公测 | Skill市场开放 | 上架≥10个Skill,审核SOP跑顺,运营可自助配置活动 |
⚠ 节点以项目合同为准,此图是示意排法;核心逻辑:合规先行 → 通路 → 生态 → 钱。
让「没有你,平台也转得动」—— 这类交付物最容易被低估,却是老板眼里的靠谱
给服务商一张「五步接入图」+ 一份检查清单,陪跑第一批
布道师动作:首批5家一对一陪跑 · 每周公开答疑 · 跑通案例写成文档 —— 让第二批不用你也能接进来。
「免费4T」背后的钱怎么流 —— 平台抽成与结算的规则由你出方案
| 计费模式 | 适用场景 | 谁付钱 |
|---|---|---|
| 政府包干 | 政务办事类Skill(基本公共服务) | 财政,市民免费 |
| 按次计费 | 专家问诊、报告解读等低频高价值 | 市民单次付 |
| 订阅制 | 健康管理、教育陪伴类持续服务 | 市民月付 |
| 免费+增值 | 拉新型Skill,基础免费高级收费 | 混合 |
⚠ 抽成比例、结算周期须与财务及集团合规共定 —— 你出产品方案,不是拍板价格。