保利威文档中心

幫助中心

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',
        }
    }
联系客服,在线咨询