I. Obtain the Agent Plugin

You can download the Agent plugin from the Sanplex official website → Marketplace.

Sanplex Marketplace URL: 【在此插入Sanplex官网应用商店地址】

Sanplex provides Agent capabilities that may already be included in your deployment. If your instance already has the Agent entry and features described in【在此插入7.11.1 禅道智能体链接】, you do not need to install this plugin.

II. Install the Agent Plugin

In Sanplex, go to Admin → Extension Management → Local Install, select the downloaded Agent plugin package, and follow the installation steps.

图1

图2

Select Overwrite, then refresh the page.

图3

图4

图5

After installation, you can view it under Installed.

图6

After both the Agent plugin and ZAI service are configured successfully, you will see the Agent entry in the lower-right corner of the Sanplex page.

If it does not appear after configuration, force-refresh the browser.

图7

Note: This plugin updates front-end dependent JS files. Since it is not a standard version upgrade, you may need to clear browser cache for changes to take effect.

III. Configure the ZAI Service

ZAI is an enterprise intelligent service platform powered by the Dathor Intelligent Engine. The Sanplex Agent plugin relies on ZAI to provide core AI capabilities. For ZAI installation, see: 【在此插入8.2 ZAI服务安装链接】

After ZAI is installed and deployed, follow the ZAI documentation to create a Sanplex application integration, and obtain the following information:

• ZAI Server Address: Sanplex uses this address to call the ZAI API for Agent features. It can be a host IP or domain, for example localhost.
• ZAI Server Port: Sanplex uses this port to call the ZAI API. If unknown, leave it empty; the default is 8000.
• Integration ID: The ID assigned when Sanplex is integrated as an application, for example sanplex.
• App Secret: Used securely when Sanplex calls ZAI APIs. Keep it safe, for example qAs0y85cebIOWBPsBDaHmwkv8WNfgDSw.
• Admin Secret: Used securely when Sanplex calls ZAI management APIs. Keep it safe, for example z1Jh0GrchSCE5CBCRvJhsx1JPZKj2kPR.

Once you have the information above, open Admin → Agent Configuration → ZAI, click Edit, fill in the form, and Save.

图8

Notes:

• Ensure the ZAI server supports the same protocol used by Sanplex. For example, if Sanplex is accessed via HTTPS, configure ZAI (typically via reverse proxy and certificates) to also support HTTPS access.
• To prevent the browser Content Security Policy (CSP) from blocking access to the ZAI server, configure Sanplex CSP rules by editing config/my.php and adding:

$config->CSPs = array("form-action 'self';connect-src 'self' http://localhost:8000"); 

IV. Sanplex Data Vectorization

Data vectorization converts data generated in Sanplex (such as requirements, bugs, documents, etc.) into vectors, so it can be referenced in Agent conversations and improve answer accuracy.

To enable Sanplex data vectorization, click Data Vectorization in the left menu of the ZAI page. The first time, you must enable it manually by clicking Enable Data Vectorization. This feature requires the Admin Secret to be configured in ZAI settings (see “Configure the ZAI Service” above).

图9

After enabling, you need to run a synchronization once. Click Start Sync to enter synchronization status. The page will display the sync progress for each object type.

图10

After synchronization completes, you can reference Sanplex data in Agent conversations. For details, see:【在此插入8.3AI插件功能使用链接】