文档

服务端集成

更新时间:

本文档旨在为您在开发应用程序服务端时提供参考。

项目原理

AppServer的作用

image

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

说明

AppServer属于客户自行部署、维护的范畴。

项目框架

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

项目部署

前提条件

通过源码部署

本示例主要通过源码构建并部署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。

     #ai智能体配置
      ai_aent:
        # Ai语音智能体id
        voice_chat_ai_agent_id: "*******"
        # 3d数字人智能体id
        avatar_ai_chat_3d_agent_id: "*******"
        region: "cn-shanghai"

    智能媒体服务控制台创建的智能体实例Id:

    • voice_chat_ai_agent_id:创建智能体时,绑定实时工作流为语音通话的智能体Id。

    • avatar_ai_chat_3d_agent_id:创建智能体时,绑定实时工作流为3D数字人通话的智能体Id。

    region请根据控制台所选地区进行更改。

项目打包和运行

打包

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

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

    mvn package -DskipTests
  3. target目录下的jar包发送到服务器。

    scp xxx.jar root@ip:/root

运行

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

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

    java -jar ***.jar
  2. 后台运行,将日志打印输出到nohup.out文件。

    nohup java -jar ***.jar &