本指南将帮助您在果办OfficeAce中集成小艺智能助手。集成后,无论您使用的是手机还是平板,都能通过小艺APP,以语音或手动输入的方式,轻松体验跨终端的任务执行。
- 使用场景:当您在移动场景下需要通过语音快速操作果办OfficeAce时,例如开车时语音安排日程、开会间隙用手机生成报告,小艺集成让您无需打字即可完成办公任务。
- 运作机制:小艺集成的消息流转路径为:用户通过小艺APP发送语音/文字消息 → 小艺开放平台将消息推送至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回小艺并展示给用户。
前提条件
已具备HarmonyOS NEXT、HarmonyOS 5.0及以上版本的手机或平板。
步骤一:创建小艺智能体
本步骤内容仅供参考,实际请以小艺开放平台文档为准。
- 创建或选择智能体。
登录
小艺开放平台,选择已有智能体。如果没有智能体,请单击“新建智能体”创建新智能体。
图1 新建智能体
- 配置智能体基本信息。
在创建智能体界面中,滚动鼠标,在界面右侧区域依次配置智能体基本信息,参数说明如表1所示,配置完成后单击“确认创建”。
以配置智能体开发模式为例,配置区域如
图2所示。
图2 配置智能体开发模式
表1 参数说明 | 参数 | 说明 | 是否必填 | 示例 |
| 开发模式 | 选择智能体的开发模式。 此处选择OpenClaw模式。OpenClaw模式是一种开放灵活的智能体接入与构建方式,开发者可通过该模式接入OpenClaw工具 ,快速创建个性化智能体。该模式适用于个性化助手、自动化服务、场景化应用等多样化需求。 | 是 | OpenClaw模式 |
| 智能体名称 | 智能体的标识名称。 | 是 | xiaoyi-clawee |
| 一句话描述 | 简要描述智能体功能。 | 是 | AI办公助手 |
| 支持的设备和系统 | 选择智能体支持的设备类型和系统版本。 | 是 | 手机-HarmonyOS、手机-HarmonyOS Next |
- 选择编排模式并获取凭证。
- 进入智能体界面后,选择编排模式为“OpenClaw”模式。根据当前是否已有可用凭证,后续操作有所不同。
- 未创建过凭证:单击“点击新建凭证”,如图3所示。
图3 新建凭证
- 已创建过凭证但未及时保存密钥:可单击“小艺开放平台凭证”重新创建,如图3所示。
图4 重新创建凭证
- 在弹出的“新建凭证”对话框中,输入Key名称,例如“01”,服务平台选择“Web端(JS API)”,创建完成后单击“保存”,保存后界面如图5所示,单击
复制Key和安全密钥,并记录保存,保存后单击“关闭窗口”。
凭证创建成功后,密钥仅在弹窗内临时展示。请务必及时复制Key(即Access Key,简称AK)和安全密钥(即Secret Key,简称SK)并妥善保存,关闭弹窗后无法再次查看。
- Secret Key属于敏感凭证,请勿泄露。
- 如果凭证可能已泄露,请立即在小艺开放平台重新创建凭证,重新创建后原凭证将立即失效,已使用原凭证的服务需同步更新。
图5 新建凭证
- 获取Agent ID并配置小艺智能体开场白。
复制并记录agentId,并配置智能体的开场白,例如“我是您的办公助手,帮您轻松应对各种办公场景。”,如
图6中的①②所示。
图6 配置开场白
- 配置测试白名单。
- 在左侧导航,选择“测试白名单”,单击界面右上方的“新建用户组”,在弹出的弹框中输入用户组名例如“01”,输入完成后单击“保存”,保存后如图7所示。
图7 创建用户组
- 在用户组所属的操作列,单击“管理用户”,在弹出的弹框中单击“邀请用户”,输入用户手机号码或邮箱,如图8所示,输入完成后单击“确定”,并根据界面提示完成后续弹框信息的确认。
图8 邀请白名单用户
- 上架智能体。
勾选用户组,单击界面右上方的“上架”,在弹出的对话框中单击“发布真机测试”,如
图9的①②③所示。
图9 上架智能体
步骤二:在果办OfficeAce集成小艺
- 登录果办OfficeAce。
- 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
- 在通讯软件列表中选择“小艺”。
- 填写应用凭证,具体如下,填写完成后单击“测试连接”,连接成功后单击“保存配置”。
如果测试连接失败,请检查:①Agent ID、AK、SK是否填写正确且无多余空格;②小艺智能体是否已成功上架;③凭证的服务平台是否选择了“Web端(JS API)”。
- Agent ID:请填写步骤4中获取的agentId。
- Access Key (AK):请填写步骤3中获取的Key。
- Secret Key (SK):请填写步骤3中获取的安全密钥。
步骤三:开始使用
- 在用户终端(例如手机)打开小艺APP,在小艺APP的对话列表中,找到步骤一创建的智能体,如图10所示。
图10 查找智能体
- 单击智能体,通过聊天窗直接和果办OfficeAce对话,支持语音和手动输入。如图11所示,果办OfficeAce中显示来自小艺的会话信息,表示对接成功。
如需指定某个智能体处理任务,可以直接输入@+智能体名称,指定智能体进行对话。
图11 在小艺中和果办OfficeAce对话
常用指令
果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表2所示。
表2 特殊前缀指令 | 命令 | 说明 |
| /new | 新建未命名会话。 |
| /new 标题 | 新建名为标题的会话。 |
| /where | 返回当前所在的会话。 |
| /threads | 显示所有会话编号和会话主题。 |
| /use 会话编号 | 切换到编号对应的会话。 |