服务端集成

项目原理

AppServer的作用

集成方基于AUI Kits框架快速搭语AI智能体服务时，场景SDK需要对接阿里云的AI Agent等产品能力。AppServer将这上述产品的能力进行封装，提供一套标准化的HTTP接口供场景SDK使用，降低了集成方的开发成本。

项目框架

基于主流的Java8+Springboot2搭建框架。

项目部署

前提条件

• 已完成控制台相关操作，具体详情请查看AI实时互动快速入门。

• 环境中已安装Java8。

通过源码部署

本示例主要通过源码构建并部署AppServer。

项目参数配置

1. 下载AppServe源码。

2. 打开源码Server\Java\src\main\resources目录下的application.yml文件，配置相关参数。

   参数配置信息	说明
   biz: openapi: access: key: "*******" secret: "*******"	调用阿里云相关服务API时，您需要使用AccessKey完成身份验证。AccessKey包括AccessKey ID和AccessKey Secret。具体如下： AccessKey ID：用于标识用户。 AccessKey Secret：用于验证用户的密钥。AccessKey Secret必须保密。 更多信息，请参见创建AccessKey。
   # 连麦应用信息 live_mic: app_id: "*******" app_key: "*******"	实时音视频应用ID和AppKey。您可以前往实时音视频应用管理进行查看。 说明 该配置仅需在基于ARTC SDK集成方案下进行配置。
   #ai智能体配置 ai_aent: # Ai语音智能体id voice_chat_ai_agent_id: "*******" # 3d数字人智能体id avatar_ai_chat_3d_agent_id: "*******" # 视频理解智能体id vision_chat_ai_agent_id: "******" region: "cn-shanghai"	智能媒体服务控制台创建的智能体实例Id： voice_chat_ai_agent_id：创建智能体时，绑定实时工作流为语音通话的智能体Id。 avatar_ai_chat_3d_agent_id：创建智能体时，绑定实时工作流为3D数字人通话的智能体Id。 vision_chat_ai_agent_id：创建智能体时，绑定实时工作流为视觉理解通话的智能体Id。 region请根据控制台所选地区进行更改。

Region Id

项目打包和运行

打包

1. 使用IDEA自带的Maven打包，jar在target目录下。

2. 在Server\Java路径下使用以下命令执行打包操作。

   mvn package -DskipTests

3. 将target目录下的jar包发送到服务器。

   scp xxx.jar root@ip:/root

运行

在jar包所在目录下打开终端。

1. 终端运行，日志打印到终端。

   java -jar ***.jar

2. 后台运行，将日志打印输出到nohup.out文件。

   nohup java -jar ***.jar &