小艺集成

前提条件

已具备HarmonyOS NEXT、HarmonyOS 5.0及以上版本的手机、平板。

步骤一：创建小艺智能体

本步骤需在小艺开放平台完成。

1. 创建或选择智能体。
   登录小艺开放平台，选择已有智能体。如果没有智能体，请单击“新建智能体”创建新智能体。

   图1 新建智能体
   

2. 配置智能体基本信息。

   在创建智能体界面中，滚动鼠标，在界面右侧区域依次配置智能体基本信息，参数说明如表1所示，配置完成后单击“确认创建”。

   以配置智能体开发模式为例，配置区域如图2所示。

   图2 配置智能体开发模式
   

   表1 参数说明

   参数	说明	是否必填	示例
   开发模式	选择智能体的开发模式。 此处选择OpenClaw模式。OpenClaw 模式是一种开放灵活的智能体接入与构建方式，开发者可通过该模式接入OpenClaw工具 ，快速创建个性化智能体。该模式适用于个性化助手、自动化服务、场景化应用等多样化需求。	是	OpenClaw模式
   智能体名称	智能体的标识名称。	是	xiaoyi-clawee
   一句话描述	简要描述智能体功能。	是	AI办公助手
   支持的设备和系统	选择智能体支持的设备类型和系统版本。	是	手机-HarmonyOS、手机-HarmonyOS Next

3. 选择编排模式并获取凭证。
   1. 进入智能体界面后，选择编排模式为“OpenClaw”模式，单击“点击新建凭证”，如图3所示。
      图3 新建凭证
      
      

      凭证创建成功后，密钥仅在弹窗内临时展示，如果您已完成凭证创建，但未及时保存密钥，可单击“小艺开放平台凭证”重新创建，如图3所示。

      图4 重新创建凭证
      
   2. 在弹出的“新建凭证”对话框中，输入Key名称，例如“01”，服务平台选择“Web端（JS API）”，创建完成后单击“保存”，保存后界面如图5所示，单击复制Key和安全密钥，并记录保存，保存后单击“关闭窗口”。
      

      凭证创建成功后，密钥仅在弹窗内临时展示。请务必及时复制Key（即Access Key，简称AK）和安全密钥（即Secret Key，简称SK）并妥善保存，关闭弹窗后无法再次查看。Secret Key属于敏感凭证，请勿泄露。如果凭证可能已泄露，请立即在小艺开放平台重新创建凭证，重新创建后原凭证将立即失效，已使用原凭证的服务需同步更新。

      图5 新建凭证
      

4. 获取Agent ID并配置小艺智能体开场白。
   复制并记录agentId，并配置智能体的开场白，例如“我是您的办公助手，帮您轻松应对各种办公场景。”，如图6中的①②所示。

   图6 配置开场白
   

5. 配置测试白名单。
   1. 在左侧导航，选择“测试白名单”，单击界面右上方的“新建用户组”，在弹出的弹框中输入用户组名例如“01”，输入完成后单击“保存”，保存后如图7所示。
      图7 创建用户组
      
   2. 在用户组所属的操作列，单击“管理用户”，在弹出的弹框中单击“邀请用户”，输入用户手机号码或邮箱，如图8所示，输入完成后单击“确定”，并根据界面提示完成后续弹框信息的确认。
      图8 邀请白名单用户
      

6. 上架智能体。
   勾选用户组，单击界面右上方的“上架”，在弹出的对话框中单击“发布真机测试”，如图9的①②③所示。

   图9 上架智能体
   

步骤二：在OfficeAce集成小艺

1. 登录OfficeAce。
2. 在左侧导航栏中选择“渠道”，在渠道列表中选择“小艺”。
3. 填写应用凭证，具体如下，填写完成后单击“测试连接”，连接成功后单击“保存配置”。
   

   如果测试连接失败，请检查：①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 查找智能体
   

2. 单击智能体，通过聊天窗直接和OfficeAce对话，支持语音和手动输入。如图11所示，OfficeAce中显示来自小艺的会话信息，表示对接成功。
   

   如需指定某个智能体处理任务，可以直接输入@+智能体名称，指定智能体进行对话。

   图11 在小艺中和OfficeAce对话
   

常用指令

OfficeAce支持通过特殊前缀指令控制会话，常用指令如下表2所示。

常见问题

• 为什么在小艺APP中没找到对话列表？

  此功能仅支持HarmonyOS NEXT或HarmonyOS 5.0及以上版本，请检查设备系统版本。如果当前为HarmonyOS 4及更早版本，不支持该功能，建议更换设备或升级系统。

• 为什么在小艺APP的对话列表中没有找到创建的智能体？

  小艺APP服务未完全加载。请尝试彻底关闭并重启小艺APP，重新进入后查看。