You need to enable JavaScript to run this app.
DataAgent (OnPremise)

DataAgent (OnPremise)

Copy page
Download PDF
OA Applications Integrations
Intelligent Analysis Agent Third-Party Integration Guide
Copy page
Download PDF
Intelligent Analysis Agent Third-Party Integration Guide

This document introduces the third-party integration guide for the intelligent analysis agent. You will learn how to integrate the agent into web and mobile platforms via API.

Caution

Before using the APIs described in this document, you must complete the preliminary steps of integrating JWT-Token and applying for a Token. Please review the invocation method first. For details, see Invocation Method.

Third-party integration interfaces

Web integration

The effect based on JWT-Token + iframe is shown below:

General agent

Professional agent

Image

Image

Request parameters

Parameter

Type

Required

Example value

Description

domain

string

Yes

https://console.volcengine.com/bi/datawind/data-agent/analytics-agent-open

Domain name

  • SaaS environment domain: https://console.volcengine.com/bi/datawind/data-agent/analytics-agent-open
  • Private deployment domain: Actual deployed environment domain address ${domain}/bi

APPID

number

Yes

1

Project id. See the explanation for how to obtain it.

jwtToken

string

Yes

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoib3BlbmFwaSIsInVzZXJuYW1lIjoiYWRtaW4iLCJ1c2VyX3BheWxvYWQiOnt9LCJleHAiOjE3NDM1NjY0OTEsImNsaWVudF9pZCI6ImYzMDE5ZGMzZmZmNTE1MzhkMjM5Nzc0ZmI3ZjI4Mzg4In0.gHN39Aq3XQkiZpCJmcvBLaH1eM******

User jwtToken. For retrieval method, see Invocation Method.

AGENT_ID

number

Yes

1

Agent id. See the explanation for how to obtain it.

tip

See the agent web page link for how to obtain APPID and AGENT_ID.
Image

Request example

<iframe
    src={`${domain}/#/agent?agentId=${AGENT_ID}&appId=${APPID}&inline=true&jwtToken=${jwtToken}`}
/>

Mobile integration

The mobile view can be used for mobile H5, sidebar or floating window activation, or when space is limited. The mobile view and PC view sessions are fully consistent; only the display differs. The agent page is responsive. When accessed from a mobile device, it automatically switches to the mobile view.
Integration method: When accessing with a mobile device, the view automatically switches to the mobile view. You can also use parameters to force the switch to the mobile view. Add &forceMobile=true&inline=true after the url's queryString.

Request parameters

As described above in Web integration - request parameters

Request example

<iframe 
    src={`${domain}/#/agent?agentId=${agentId}&appId=${APPID}&jwtToken=${jwtToken}&inline=true&forceMobile=true`}
/>
Last updated: 2026.06.02 14:53:14