作者 | k老师

最近我在开发一个HarmonyOS的学习服务产品，在选型调研中发现：当学习服务以智能体的形态出现，用户与它的交互就不必局限于打开某个页面、点击某个功能，而是可以直接表达需求，让智能体调用相应能力完成任务。因此，我开发的“鸿蒙课”智能体希望围绕开发者学习场景构建，整合课程查询、AI 伴学和复习安排等能力，并接入小艺智能体能力，让学习服务能够进入更自然的对话场景。例如，用户可以在小艺中提出“搜索 ArkUI 课程”或“查看复习任务”，“鸿蒙课”智能体便可以根据当前账号的真实学习数据返回结果。

围绕这一目标，我在 HarmonyOS 7 环境中实践了标准意图与应用 Skill 的接入，已在 Mate X5 的 HarmonyOS 7 环境中验证这两项中文调用，查询结果与应用内记录对应。应用内生成并确认保存的新课程，也能在后续小艺查询中找到。另外我进一步探索 A2A 在多轮伴学中的应用，希望打通从理解学习需求、调用专业能力到返回真实业务结果的完整链路。

图1： “鸿蒙课”智能体课程列表与 AI 伴学功能（机型：Mate X5）

“鸿蒙课”智能体：采用标准意图、Skill完成学习任务

“鸿蒙课”智能体将接入分为两部分。第一部分使用 JumpFunctionPage 标准意图与 InsightIntentExecutor 前台执行器，承接结构化页面目标。第二部分以应用 Skill 描述学习能力，连接课程查询、继续学习、资料入口和复习任务，并为后续 A2A 多轮伴学保留业务基础。以真实课程和复习查询为例，分享能力描述、身份恢复、业务执行与结果回传的衔接方式，同时给出标准意图和端云协同的实现思路。

首先，功能一步达为用户表达意图后进入应用功能提供系统入口。在“鸿蒙课”智能体中，我采用 JumpFunctionPage 标准意图，将 pageId=learning 约定为学习根页面，避免外部调用直接拼装任意路由，实现接收结构化指令连接学习页。（此能力可参考功能一步达）

图2：标准意图与应用导航的处理设计示意

为了实现智能体的前台执行器校验目标，页面负责实际导航，LearningIntentExecutor 继承 InsightIntentExecutor，在onExecuteInUIAbilityForegroundMode 中接收意图名称和参数。执行器核对JumpFunctionPage 与 pageId，再把有效请求交给业务桥，最终复用原有学习 Tab（接口参考InsightIntentExecutor）。这个分工让系统调用与应用内操作共享业务规则。学习页仍由原有页面管理，执行器只处理意图契约和执行结果，不负责重建学习数据，也不把收到指令直接等同于已经打开页面。

冷启动和应用回到前台时，窗口、首页挂载与身份恢复具有先后顺序。鸿蒙课通过有期限的待执行请求衔接这些状态，待页面具备操作条件后，再消费目标并回到学习根页。对于需要页面变化的动作，采用实际可见回执确认结果。这样既能保留原有对话和学习记录，也能让调用方知道目标页面是否真正显示。生命周期处理与回执约定，是系统入口接入已有应用时需要共同考虑的部分。

查询课程功能中，用户在小艺中输入“用鸿蒙课搜索arkui课程”（无需强制用户输入准确英文大写），应用 Skill 调用课程查询能力。鸿蒙课恢复当前身份，按标题和简介匹配本机在学课程与账号课程，去重后回传课程标题、简介及标识。

图3：中文课程查询与小艺返回的三门真实课程

本次查询返回三门 ArkUI 课程，包括经 AI 伴学预览并确认保存的“ArkUI 线性布局入门：Column 与 Row”。下方课程库中的三个标题与返回结果对应，新课程显示为 6 章。

图4：应用内相同账号的课程记录、与查询结果核对

用户输入“查看复习任务”，鸿蒙课读取当前账号的真实队列，小艺返回三项任务及课程标题。下方应用队列显示相同记录。实现真实复习查询，把学习安排带回对话。

图5：查看复习任务的中文指令与实际返回

查询结果与学习操作分别处理：查询队列不会自动标记完成。用户点击“记录本次复习”后，应用提交请求，按实际结果更新安排；“打开学习”用于进入课程内容。

图6：应用内复习队列、课程记录与复习操作入口

“鸿蒙课”智能体希望用清晰的 Skill 契约连接已有学习能力，因此通过 SKILL.md 说明适用场景、参数和结果含义，由 StudySkill.ets 调用现有业务，并通过 completeArkTSScriptInApp 回传结构化结果。描述文件帮助小艺选择能力，业务服务继续负责当前身份与资源归属校验。（开发参考 应用 Skill 开发指南）

图7：学习需求与业务结果之间的调用关系示意

资料理解与课程草稿需要明确的内容范围，因此，鸿蒙课设计让 Skill 连接 AI 伴学资料入口，保留用户选择与确认，由用户选择文件、链接或已有课程，填写问题后发送。资料发送、课程加入及复习完成均由用户明确操作，按各自业务规则记录。

图8：资料关联操作界面展示关联课程与待发送问题

学习永不停：以 A2A 扩展多轮伴学与端云协同

课程学习通常会伴随连续追问，因此鸿蒙课设计以 A2A 扩展多轮伴学与端云协同的功能。用户了解一个概念后，可能继续要一个例子，再结合当前资料形成课程草稿。我们希望逐步连接“找到课程、理解资料、形成预览、确认加入、按需复习”的过程。多轮协作的价值，是让下一步继续使用上一轮已经确认的课程与资料，用户仍可查看并决定实际写入的内容。鸿蒙课将 A2A 作为后续演进方向，让小艺与学习功能能够围绕同一会话传递上下文和任务结果。

图9：A2A 多轮伴学与端云协同的演进方案示意

在鸿蒙课的 AI 伴学功能中，我希望用户可以关联已有课程，发送“请根据关联课程生成入门课程”。应用生成课程草稿后，用户可以查看正文，修改标题和简介，再决定是否加入课程库。

图10：生成后的课程草稿预览，标题与简介可继续修改，用户确认后保存加入课程库

经过确认保存的课程，随后出现在学习页的 AI 课程库。新增“ArkUI 线性布局入门：Column 与 Row”，包含 6 个章节，也已出现在前文的小艺课程查询结果中。

图11：已保存的新课程记录6个章节

预览示例与入库记录分别展示同一功能的真实操作；查看草稿与正式保存分开处理，用户保留修改和决定加入的权利。

小艺负责承接需求与组织能力调用，鸿蒙课智能体负责账号、课程和学习操作，现有模型服务承担资料理解与生成。云 A2A 适配围绕已有伴学任务建立会话映射。端侧方案面向本机课程、阅读位置与页面交互，待平台注册和系统联调后接入。

云端方案采用 JSON-RPC 的 message/stream 入口，通过 SSE 表达任务阶段与最终结果。会话映射用于延续有效问答上下文，任务标识用于处理重试、结果复用及取消，避免网络连接变化导致重复生成。

通过标准意图与应用 Skill，鸿蒙课已经能够围绕课程查询和复习任务，与小艺的对话交互建立连接；查询结果来自当前账号的真实学习记录，课程生成后的预览、确认保存以及复习记录等操作，也保留了必要的用户确认环节。在此基础上，希望通过 A2A 进一步探索鸿蒙课与小艺智能体之间的多轮协作，让课程查找、资料理解、内容生成和复习安排不再是彼此割裂的单次操作，而能围绕同一学习目标逐步衔接。需要说明的是，本文展示的课程与复习查询已有实际验证，A2A 多轮伴学仍属于后续演进方向。

对开发者而言，HarmonyOS 提供的意图、Skill 等能力，为智能体连接系统交互入口与专业业务服务，已经为我们提供了实践路径。开发中，需要我们把这些技术能力转化为可靠、连贯且可控的任务协作，去真正践行智能体体验。也欢迎大家使用“鸿蒙课”智能体，多给我提建议。