保利威文档中心

幫助中心

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