服务端集成

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

项目原理

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 IDAccessKey Secret。具体如下:

    • AccessKey ID:用于标识用户。

    • AccessKey Secret:用于验证用户的密钥。AccessKey Secret必须保密。

    更多信息,请参见创建AccessKey

    说明

    如果使用RAM用户的AK、SK, 需要AliyunICEFullAccess权限。

    # 实时音视频应用信息
      live_mic:
        app_id: "*******"
        app_key: "*******"

    实时音视频应用IDAppKey。您可以在智能体详情页面,通过单击RTC AppID,查看应用ID以及AppKey。

    说明

    涉及音视频通话的场景必须配置实时音视频的应用IDAppKey,消息对话场景无需配置。

    获取音视频ARTC应用的AppIdAppKey步骤如下:

    1. 前往智能媒体控制台,单击您创建好的智能体,进入智能体详情页面。

      image

    2. 单击RTC AppID,前往视频直播控制台,获取AppIdAppKey。

      image

项目打包和运行

打包

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

  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 &