iframe 集成方式是最簡單的一種,您只需要在您的 HTML 文件中(或 Vue/React 組件中)添加一個 iframe 元素,并設置其 src 屬性為 AI 助手的 URL。
<iframesrc="https://develop.hengshi.org/copilot"width="100%"height="100%">
</iframe>
url query string 參數說明?
我們提供了一些可選的 URL 參數,您可以根據需要進行調整。
數據來源?
您可以通過以下方式指定與 AI 助手對話時的數據來源:
- 與圖表所在數據源對話
?appId={應用 ID}&chartId={圖表 ID}
- 與數據包數據模型對話
?dataAppId={數據包 ID}&datasetId={數據集 ID}
- 與多個數據源進行對話
?dataSources=[{"dataAppId":{數據包 ID1},"datasetId":{數據集 ID1}},{"dataAppId":{數據包 ID2},"datasetId":{數據集 ID2}}]
注意參數需要做 url encode。
主題顏色?
您可以通過以下方式指定 AI 助手對話內圖表的主題顏色:
?chartTheme={儀表盤主題 ID}
儀表盤主題 ID 可以在您的應用創作區儀表盤編輯時,在主題下拉菜單中找到,如下圖所示:
只顯示指定對話?
我們還提供了?conversationId
?和?chatUid
?參數,且允許以逗號分割傳遞多個值,用于指定只顯示指定對話。這兩個參數可以單獨使用,也可以組合使用。
?conversationId={對話ID1,對話ID2}&chatUid={uid1,uid2}
登錄認證?
若您需要在其他系統中集成時,可能需要進行登錄認證,可以通過 jwt 參數傳遞登錄信息:
?activeAuth=jwt-param&jwtParam={JWT 參數}