适用场景

当前 AI 助聊功能主要针对娱乐社交场景优化，底层模型设定为陌生人社交环境下的对话推荐。如需其他业务场景（如办公提效、客服应答等），可 提交工单 联系网易云信技术支持工程师额外调整实现。

效果展示

AI 助聊提供多种风格的聊天建议，您可根据场景配置不同风格的回复内容。

风格展示一

风格展示二

准备工作

在开始接入 AI 助聊功能前，请确保您已完成以下准备工作：

1. 在 网易云信控制台 创建应用，开通即时通讯 IM 服务，获取 App Key，用于服务端身份验证。
2. 获取 IM 账号体系相关信息。通过 注册 IM 账号，获取账号 ID (account_id) 和用户身份验证令牌 (accessToken)。
3. 完成 导入 IM UIKit 组件。

接入流程

AI 助聊功能需要客户端和服务端配合实现：

1. 服务端：负责生成和返回内容，提供 AI 助聊 API 接口。
2. 客户端：负责发起 HTTPS 请求并展示 AI 生成的聊天建议。

第一步：服务端配置

您可以选择使用网易云信提供的 AI 助聊服务，或自行实现服务端逻辑。若使用网易云信服务，请参考 网易云信 AI 助聊 API。网易云信 AI 助聊服务端接口返回数据格式如下。

JSON{
    "code": 200,
    "msg": "success",
    "data": {
        "items": [
            {
                "style": "hot",
                "style_name": "升温热聊",
                "answer": "哇哦，必须漂亮啊，穿啥都好看！"
            },
            {
                "style": "warm",
                "style_name": "贴心暖男",
                "answer": "哇，超级漂亮，很适合你！"
            }
        ]
    }
}

具体实现代码，请参考 IM UIKit 开源项目中的 MainActivity.java 文件。

第二步：配置客户端请求

1. 在您的应用配置文件 AppConfig.java 中配置请求地址：

   Java// 配置 AI 助聊服务地址
   AIHelperHost_ONLINE = "https://***.****.im/";
   AIHelperUrl = "/ai/chat_assistant/v1/chat_assist";
   

   字段	说明	示例值
   AIHelperHost_ONLINE	AI 助聊服务端地址	https://***.****.im/
   AIHelperUrl	接口路径	/ai/chat_assistant/v1/chat_assist

2. 配置请求 Header 并初始化 OkHttp。需初始化的配置包括账号信息、网易云信 AppKey 以及权限校验。具体代码示例请参考类 IMKitNetRequester。

   Javapublic void setup(String url, String appKey, String accountId, String signature) {
   if (TextUtils.isEmpty(url)) {
       return;
   }
   this.appKey = appKey;
   headerMap.put("appKey", appKey);
   headerMap.put("accountId", accountId);
   headerMap.put("accessToken", signature);
   headerMap.put("Content-Type", "application/json;charset=utf-8");
   
   // 初始化 OkHttp 客户端
   OkHttpClient httpClient =
       new OkHttpClient.Builder()
           .connectTimeout(10L, TimeUnit.SECONDS)
           .readTimeout(5L, TimeUnit.SECONDS)
           .writeTimeout(5L, TimeUnit.SECONDS)
           .build();
   
   // 初始化 Retrofit
   retrofit =
       new Retrofit.Builder()
           .baseUrl(url)
           .client(httpClient)
           .addConverterFactory(GsonConverterFactory.create())
           .build();
   
   // 创建 API 接口实例
   aiChatHelperAPI = retrofit.create(AIChatHelperAPI.class);
   }
   

第三步：客户端接入

1. 参考 IM UIKit 开源工程中的 MainActivity.java 文件，通过 HTTPS 请求获取助聊信息并设置给 AI 助聊页面。

2. 配置 AI 助聊回调，onAIHelperClick 在 AI 助聊展示或者单击刷新的时候进行回调。

   参数	类型	说明
   context	Context	会话页面上下文信息
   view	AIHelperView	AI 助聊 View，您可通过 AIHelperView 提供的对外方法进行操作
   action	String	操作行为，用来区分 AIHelperView 上不同的单击事件。
   msgList	List	当前聊天页面的消息列表。默认当前拉取到的 100 条消息

   JavaChatUIConfig uiConfig = new ChatUIConfig();
   uiConfig.chatInputMenu = new IChatInputMenu() {
   @Override
   public boolean onAIHelperClick(
       Context context, View view, String action, List<IMMessageInfo> msgList) {
       if (TextUtils.equals(action, ActionConstants.ACTION_AI_HELPER_REFRESH)
           && view instanceof AIHelperView) {
       // 刷新或重试时加载 AI 助聊内容
       // 业务逻辑处理参考下文
       loadAIHelper((AIHelperView) view, msgList);
       } else if (TextUtils.equals(action, ActionConstants.ACTION_AI_HELPER_SHOW)
           && view instanceof AIHelperView) {
       // AIHelperView 由不可见变为可见的时候触发，此时不会主动展示 loading 动画
       // 您可以根据自己的业务来判断是否要展示
       AIHelperView helperView = ((AIHelperView) view);
       helperView.showLoading();
       // 业务逻辑处理参考下文
       loadAIHelper((AIHelperView) view, msgList);
       }
       return true;
   }
   };
   

3. 实现 AI 助聊内容加载与设置，参数说明请参考 AIHelperItem：

   参数	类型	说明
   content	String	每一条助聊展示的内容
   tag	String	每一条助聊展示的标签
   tagTextColor	int	助聊标签的文本颜色（资源 ID）
   tagBgDrawable	int	助聊标签的背景颜色（资源 ID）

   Javaprivate void loadAIHelper(AIHelperView helperView, List<IMMessageInfo> msgList) {
   if (helperView == null) {
       return;
   }
   // 根据当前聊天信息获取 AI 助聊内容
   // 将内容转换为 List<AIHelperView.AIHelperItem>格式
   List<AIHelperView.AIHelperItem> itemList = new ArrayList();
   // 这里添加获取 AI 助聊内容的逻辑
   
   if (itemList.isEmpty()) {
       // 内容为空时显示错误信息
       helperView.showError("");
   } else {
       // 设置 AI 助聊展示内容
       helperView.setHelperContent(itemList);
   }
   }
   

4. 设置配置信息到 UIKit 组件中。

   JavaChatKitClient.setChatUIConfig(uiConfig);