保利威文档中心

帮助中心

AI答疑助手SDK

更新时间:2025-11-27 23:11:32

概述

AI答疑助手SDK是基于polyv AI知识库答疑助手的js sdk,提供了可嵌入到网页中的答疑助手组件,用户可以通过集成该组件内嵌到自己的网页中,从而向polyv AI知识库中的构建的知识库提问问题,获取答案。

快速集成

js demo

    <script src="https://websdk.videocc.net/ai-chat-bot/latest/polyv-ai-chat-bot.umd.js"></script>
    <script>
    // AI聊天组件初始化
    PolyvAIChatBot.polyvAIChat.init({
        aiId: '1159',
        getToken: async (viewerId) => {
            const response = await fetch(`https://domain/token?viewerId=${viewerId}`); // 替换为实际的获取token的接口
            const data = await response.json();
            return data.data;
        },
        customText: {
            title: '保利威直播 - 引领直播行业',
            placeholder: '输入消息...',
            sendButtonText: '发送',
        },
        customUi: {
            themeColor: '#0067C8'
        }
    });
    </script>
  • 其中,获取token的接口需要客户自行实现,并以参数的方式传递给构建的对象。

以下是使用Python FastAPI 实现获取token的示例代码:

python实现获取token案例

from fastapi import FastAPI
app = FastAPI()
@app.get("/api/token")
async def get_chat_token(viewerId: str):

    """获取AI答疑助手Token的接口"""
    form_data = {
        "appId": "# 客户在保利威的appId",
        "timestamp": int(time.time() * 1000),
        "viewerId": viewerId
    }

    form_data["sign"] = create_api_sign("# 客户在保利威的secret_key", form_data)

    # 发送请求到保利威获取
    response = requests.post(
        "https://api.polyv.net/live/v3/common/token/get-ai-token",
        data=form_data
    )

    result = response.json()

    # 只返回token值
    if result.get("code") == 200:
        return {
            "code": 200,
            "message": "success",
            "data": result.get('data')
        }


if __name__ == "__main__":
    import uvicorn

    uvicorn.run(app, host="0.0.0.0", port=8002)
  • 其中,appId和secret_key需要客户在保利威申请,具体请联系保利威技术支持。
  • 方法create_api_sign 签名生成规则参考签名生成规则
  • 以上代码仅供参考,具体实现请根据实际情况进行调整。

参数说明

参数名 类型 说明 是否必填 默认值
aiId string AI答疑助手ID,从保利威后台->AI应用 ->AI答疑助手 获取对应的aiId
getToken function 获取token的方法,需自行实现
position string 挂件位置,支持 left、right right
width string 挂件宽度 400px
height string 挂件高度 600px
customText object 用户可自定义的文本内容
customText.title string 聊天窗口标题 保利威AI助手
customText.placeholder string 输入框placeholder 输入消息...
customText.sendButtonText string 发送按钮文案 发送
customUi object
customUi.themeColor string 主题色 #1890ff
customUi.widgetIcon string 挂件icon样式 默认图片
customUi.userAvatar string 用户头像 默认图片
customUi.assistantAvatar string AI助手头像 默认图片

一个完整的配置示例:

{
        aiId: '1159',
        getToken: async (viewerId) => {
            const response = await fetch(`https://domain/token?viewerId=${viewerId}`); // 替换为实际的获取token的接口
            const data = await response.json();
            return data.data;
        },
        position: 'right',
        width: '400px',
        height: '600px',
        customText: {
            title: '保利威AI视频 - 引领视频新时代',
            placeholder: '输入消息...',
            sendButtonText: '发送',
        },
        customUi: {
            themeColor: '#0067C8',
            widgetIcon: 'https://domain/widgetIcon.png',
            userAvatar: 'https://domain/userAvatar.png',
            assistantAvatar: 'https://domain/assistantAvatar.png',
        }
    }
联系客服,在线咨询