适用AI工具DevEco Code / Cursor前置博客第06篇预计阅读时间18分钟一、Intents Kit 与 Agent Framework 的分工第 06 篇讲了 Agent Framework 的重量级智能体编排本篇的 Intents Kit 是轻量级入口。两者关系一句话讲清Intents Kit声明应用有什么意图可以被系统触达——小艺理解用户意图后直接跳转你的页面并带上参数。改动小、见效快一天可以接入完成。Agent Framework注册能力函数给智能体编排调用返回结构化结果。适合复杂多步任务改造量大。建议路径先用 Intents Kit 拿到一句话唤醒的体验再按需升级 Agent Framework。二、意图接入全流程否是梳理应用可被唤醒的场景AI生成意图装饰器定义IntentDecorator 声明意图与参数实现 IntentHandler 处理跳转module.json5 注册意图模拟器调试台验证意图匹配匹配率达标?AI优化意图描述与示例语句真机验证 发布三、第一步定义意图Intents Kit 通过意图装饰器声明。以旅行应用查行程为例// intents/ItineraryIntents.etsimport{IntentDecorator,IntentParam}fromkit.IntentsKit;IntentDecorator({intentName:ViewItinerary,domain:travel,displayName:查看行程,description:查看用户未来几天的旅行行程安排,keywords:[行程,旅行安排,航班,酒店],exampleUtterances:[小艺小艺看看我的行程,我后天有什么安排,查一下杭州的行程],schema:[newIntentParam(days,number,未来几天默认3),newIntentParam(city,string,城市过滤可选)]})exportclassViewItineraryIntent{}AI 用法一把应用的功能清单给 AI让它筛选适合被语音唤醒的 Top 5 场景并说明理由。筛选标准高频、参数少、结果可即时呈现。低频复杂功能不该接意图——用户不会对着手机说一段十几个字的长句。AI 用法二exampleUtterances是匹配率的胜负手。让 AI 针对每个意图生成 30–50 条真实口语句不同说法、不同粒度、带参数与不带参数再人工删到 10–20 条最自然的。这活纯靠人写又慢又单调AI 十分钟出稿。四、第二步处理意图意图被命中后系统把用户引导到你的 Ability/页面参数随 want 传入// 在页面或 Ability 中解析意图参数import{Want}fromkit.AbilityKit;onNewWant(want:Want,launchParam:AbilityConstant.LaunchParam):void{if(want.uriintent://ViewItinerary){constdayswant.parameters?.daysasnumber??3;constcitywant.parameters?.cityasstring??;this.loadItinerary(days,city);// 直接带着参数进业务}}配合 Link 跳转意图travelapp://itinerary?days3还能覆盖卡片、通知等更多系统入口。五、第三步注册与验证module.json5注册意图声明文件后进入验证环节。AI 用法三自动化验证清单。DevEco 模拟器的智能体调试台可以逐条输入 exampleUtterances 验证匹配。把验证结果哪条命中、哪条不命中、误命中到什么喂回给 AI以下 15 条测试语句中 11 条命中、4 条不命中附列表。分析不命中原因改进 description / keywords / exampleUtterances。AI 通常能定位出两类问题关键词覆盖缺口用户说下周去哪玩没有行程词与意图边界模糊“查天气被误配到查行程”。边界问题靠收紧 description 的范围描述解决而不是堆关键词。六、实战数据与经验样例旅行应用接入 5 个意图的实测结论意图首轮匹配率优化后优化手段查看行程62%92%扩充示例语句至 20 条添加日程48%85%收紧 description 边界查当地天气55%90%keywords 补充口语化说法分享行程30%71%该场景语音意愿弱降级为 Link改签机票25%60%参数过多拆成两步引导两条核心经验意图描述是产品文案不是技术注释参数超过 3 个的意图要拆步——语音场景用户的耐心只有一句话。七、下一步至此应用被系统智能体触达的两条路径都已打通。下一篇进入 AI 使能篇Core Speech Kit在你的应用里实现端侧语音识别与合成。
适用AI工具DevEco Code / Cursor前置博客第06篇预计阅读时间18分钟一、Intents Kit 与 Agent Framework 的分工第 06 篇讲了 Agent Framework 的重量级智能体编排本篇的 Intents Kit 是轻量级入口。两者关系一句话讲清Intents Kit声明应用有什么意图可以被系统触达——小艺理解用户意图后直接跳转你的页面并带上参数。改动小、见效快一天可以接入完成。Agent Framework注册能力函数给智能体编排调用返回结构化结果。适合复杂多步任务改造量大。建议路径先用 Intents Kit 拿到一句话唤醒的体验再按需升级 Agent Framework。二、意图接入全流程否是梳理应用可被唤醒的场景AI生成意图装饰器定义IntentDecorator 声明意图与参数实现 IntentHandler 处理跳转module.json5 注册意图模拟器调试台验证意图匹配匹配率达标?AI优化意图描述与示例语句真机验证 发布三、第一步定义意图Intents Kit 通过意图装饰器声明。以旅行应用查行程为例// intents/ItineraryIntents.etsimport{IntentDecorator,IntentParam}fromkit.IntentsKit;IntentDecorator({intentName:ViewItinerary,domain:travel,displayName:查看行程,description:查看用户未来几天的旅行行程安排,keywords:[行程,旅行安排,航班,酒店],exampleUtterances:[小艺小艺看看我的行程,我后天有什么安排,查一下杭州的行程],schema:[newIntentParam(days,number,未来几天默认3),newIntentParam(city,string,城市过滤可选)]})exportclassViewItineraryIntent{}AI 用法一把应用的功能清单给 AI让它筛选适合被语音唤醒的 Top 5 场景并说明理由。筛选标准高频、参数少、结果可即时呈现。低频复杂功能不该接意图——用户不会对着手机说一段十几个字的长句。AI 用法二exampleUtterances是匹配率的胜负手。让 AI 针对每个意图生成 30–50 条真实口语句不同说法、不同粒度、带参数与不带参数再人工删到 10–20 条最自然的。这活纯靠人写又慢又单调AI 十分钟出稿。四、第二步处理意图意图被命中后系统把用户引导到你的 Ability/页面参数随 want 传入// 在页面或 Ability 中解析意图参数import{Want}fromkit.AbilityKit;onNewWant(want:Want,launchParam:AbilityConstant.LaunchParam):void{if(want.uriintent://ViewItinerary){constdayswant.parameters?.daysasnumber??3;constcitywant.parameters?.cityasstring??;this.loadItinerary(days,city);// 直接带着参数进业务}}配合 Link 跳转意图travelapp://itinerary?days3还能覆盖卡片、通知等更多系统入口。五、第三步注册与验证module.json5注册意图声明文件后进入验证环节。AI 用法三自动化验证清单。DevEco 模拟器的智能体调试台可以逐条输入 exampleUtterances 验证匹配。把验证结果哪条命中、哪条不命中、误命中到什么喂回给 AI以下 15 条测试语句中 11 条命中、4 条不命中附列表。分析不命中原因改进 description / keywords / exampleUtterances。AI 通常能定位出两类问题关键词覆盖缺口用户说下周去哪玩没有行程词与意图边界模糊“查天气被误配到查行程”。边界问题靠收紧 description 的范围描述解决而不是堆关键词。六、实战数据与经验样例旅行应用接入 5 个意图的实测结论意图首轮匹配率优化后优化手段查看行程62%92%扩充示例语句至 20 条添加日程48%85%收紧 description 边界查当地天气55%90%keywords 补充口语化说法分享行程30%71%该场景语音意愿弱降级为 Link改签机票25%60%参数过多拆成两步引导两条核心经验意图描述是产品文案不是技术注释参数超过 3 个的意图要拆步——语音场景用户的耐心只有一句话。七、下一步至此应用被系统智能体触达的两条路径都已打通。下一篇进入 AI 使能篇Core Speech Kit在你的应用里实现端侧语音识别与合成。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
