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