AgentCard 写了十个能力却总被分发错功能描述、输入类型和依赖项怎么验HarmonyOS 7 面向 Agent 开放系统能力和 A2A 接入。AgentCard 相当于智能体的能力名片平台会同步智能体名称、版本、输入输出类型和功能列表也允许编辑功能名称、描述与依赖项。问题是功能写得越多不一定越容易被正确分发描述互相重叠反而会让路由边界变模糊。证据边界本文把华为官方资料、可执行的应用侧模型和待补的 API 26 设备证据分开记录。当前本机 SDK 为 API 24且没有连接 HarmonyOS 7 真机文中的 TypeScript 断言用于验证状态与边界不冒充 API 26 编译、云端联调或真机结果。接入时应以目标版本官方文档、控制台配置和真实错误码为准。先看一个错误写法“帮用户处理生活中的各种问题”几乎没有可验证边界。它没有说明输入是文字还是图片也没有说明要依赖账号、文件或端插件。案例一图片整理 Agent功能描述应说明“接收图片或图片列表按用户给定主题生成分类建议”而不是写“智能整理”。如果没有图片输入不应被分发到这个能力。案例二日程查询 Agent查询与创建要拆成两个功能前者只读后者有写入副作用并依赖账号授权。混在一个模糊描述里确认策略也无法统一。用一张能力契约表做离线检查type Capability { name: string; inputs: string[]; sideEffect: boolean; dependency?: string }; function valid(c: Capability): boolean { if (c.name.trim().length 4 || c.inputs.length 0) return false; if (c.sideEffect !c.dependency) return false; return true; } if (valid({ name: 创建日程, inputs: [text], sideEffect: true })) throw new Error(写操作缺少依赖声明);描述不是宣传语能力名称用于区分任务描述用于解释触发边界依赖项用于说明运行前提。宣传语可以写在详情页但不应该替代 AgentCard 中的可执行契约。每次改插件或工作流后还要检查自动同步字段是否把旧能力保留下来。上架前的五个问题1. 两个功能能否用输入与输出清楚区分2. 写操作是否标出依赖和确认要求3. 不支持的文件类型是否会被误接收4. 删除插件后 AgentCard 是否仍残留旧能力5. 测试白名单上的真实表达能否稳定路由官方资料1. 小艺开放平台开发界面与 AgentCard 配置2. HarmonyOS 7 新能力一览
