Bangun agen ChatBI dengan Dify NL2SQL untuk analitik bahasa alami - DMS

ChatBI, yang dibangun di atas Dify pada Data Management (DMS) dan natural language to SQL (NL2SQL), mendefinisikan ulang analitik data. ChatBI menggunakan alat AI untuk memahami pertanyaan pengguna dan memberikan tanggapan dalam bahasa alami. Selanjutnya, ChatBI menggunakan NL2SQL untuk mengonversi bahasa alami menjadi SQL. Dify mengeksekusi SQL tersebut dan menampilkan hasilnya dalam bentuk visualisasi. Solusi ini memperluas kemampuan analitik data ke seluruh organisasi Anda, mempercepat respons bisnis, serta membantu Anda memperoleh wawasan dari data dengan mudah.

Prasyarat

Anda telah berhasil menerapkan Dify.
Dify Anda pada DMS menjalankan versi V1.4.3 atau yang lebih baru. Untuk informasi selengkapnya, lihat Lihat versi Dify.

Langkah 1: Instal plugin AliyunDMS yang diperlukan oleh ChatBI

Masuk ke Konsol DMS V5.0.
Arahkan penunjuk ke ikon di pojok kiri atas, lalu pilih All Features > Data+AI > Dify.
Catatan
Jika Anda menggunakan konsol DMS dalam mode normal, pilih Data+AI > Dify pada bilah navigasi atas.
Klik nama ruang kerja target.
Pada panel navigasi sebelah kiri, pilih > Studio.
Di pojok kanan atas, klik Plugins, lalu klik Install plugin.
Pilih sumber instalasi dan instal plugin TONGYI serta AliyunDMS.
- Instal plugin TONGYI dari Marketplace.
- Instal plugin AliyunDMS dari DMS Plugins.
Tunggu hingga plugin selesai diinstal.
Instalasi berhasil jika plugin AliyunDMS dan TONGYI muncul dalam daftar plugin.

Langkah 2: Otorisasi plugin AliyunDMS

Klik plugin AliyunDMS, lalu klik API Key Authorization Configuration.
Tentukan apakah perlu mengonfigurasi DMS API Key berdasarkan edisi plugin yang Anda butuhkan.
Catatan
- Edisi Dasar: Tidak memerlukan kunci API.
- Edisi Perusahaan: Memerlukan kunci API DMS dalam format <AccessKeyID>:<AccessKeySecret>. ID AccessKey dan Rahasia AccessKey harus dikaitkan dengan Akun Alibaba Cloud Anda.
Klik Save.
Otorisasi berhasil jika muncul tulisan 1 Authorization pada halaman komponen.

Langkah 3: Konfigurasi kunci API untuk model Qwen

Pada halaman Studio, klik nama akun Anda, lalu pilih Settings.
Pada halaman Model Provider, klik Set di samping model TONGYI (Qwen) untuk mengonfigurasi API Key-nya.
Anda dapat memperoleh kunci API dari Alibaba Cloud Model Studio.
Klik Save.

Langkah 4: Terapkan templat ChatBI

Pada halaman Studio > All, klik Create From App Template.
Pada panel navigasi templat di sebelah kiri, klik DMS Data+AI.
Kategori ini berisi serangkaian templat yang disediakan oleh DMS.
Arahkan penunjuk ke kartu Create app from ChatBI Plug-and-Play (Integrated Edition V6), lalu klik Use this template.
Pada kotak dialog yang muncul, klik Create.
Pembuatan berhasil jika blok ChatBI Plug-and-Play muncul di halaman.

Langkah 5: Jalankan demo dan coba Agent ChatBI

Klik templat ChatBI Plug-and-Play.
Templat ChatBI mencakup set data demo bawaan.
Di pojok kanan atas, klik Preview untuk mencoba Agent ChatBI.
Ajukan pertanyaan kepada Agent untuk mengkueri data.

Langkah 6: Konfigurasi Agent ChatBI Anda sendiri

Klik , edit variabel db_connection_url, lalu ubah nilainya menjadi titik akhir internal atau publik dari database target.
Catatan
db_connection_url adalah variabel lingkungan global yang digunakan dalam alur kerja. Saat diatur ke demo_db, set data bawaan plugin akan dimuat secara otomatis.
Jenis database yang didukung dan format titik akhirnya adalah sebagai berikut:
- MySQL: mysql+pymysql://<user>:<password>@<host>:<port>/<database>.
- PostgreSQL: postgresql+psycopg2://<user>:<password>@<host>:<port>/<database>.
- SQL Server: mssql+pymssql://<user>:<password>@<host>:<port>/<database>.
- Oracle: oracle+oracledb://<user>:<password>@<host>:<port>/<service_name>.
- ClickHouse: clickhouse+native://<user>:<password>@<host>:<port>/<database>.
- MongoDB: mongodb://<user>:<password>@<host>:<port>/<database>.
Klik Save.
Bergantung pada metode koneksi database, tambahkan alamat IP egress atau alamat IP internal Dify ke daftar putih database.
- Jika Anda terhubung ke database melalui internet, tambahkan alamat IP egress publik Dify ke daftar putih database.
  Jalankan node Query DIFY Public Egress IP untuk memperoleh alamat IP spesifik.
- Jika Anda terhubung ke database melalui VPC, tambahkan blok CIDR IPv4 dari VPC tempat Dify berada ke daftar putih database.
Setelah menambahkan alamat IP, klik Preview dan ajukan pertanyaan kepada Agent mengenai data dalam database target Anda.

Fitur plugin edisi perusahaan dan edisi dasar AliyunDMS

Plugin	Deskripsi	Edisi Perusahaan	Edisi Dasar
DMS NL2SQL (Edisi Dasar)	Algoritma NL2SQL bawaan (Edisi Agile). Algoritma bahasa alami ke SQL yang gesit menyediakan keluaran streaming real-time dari hasil SQL.	√	√
DMS NL2SQL (Edisi Perusahaan)	Algoritma NL2SQL bawaan (Edisi Perusahaan) dengan fitur-fitur berikut: Antarmuka konfigurasi basis pengetahuan yang sederhana dan intuitif. Algoritma bahasa alami ke SQL tingkat lanjut untuk transformasi kueri yang akurat. Tidak perlu mengonfigurasi akun dan kata sandi database.	√	×
DMS SQL Executor (Edisi Dasar)	Memerlukan akun dan kata sandi database untuk terhubung ke database dan mengeksekusi SQL. Mendukung koneksi ke database MySQL, PostgreSQL, SQL Server, Oracle, ClickHouse, dan MongoDB.	√	√
DMS SQL Executor (Edisi Perusahaan)	Menggunakan mekanisme autentikasi tanpa kata sandi. Tidak perlu mengonfigurasi akun dan kata sandi database dalam alur kerja, sehingga secara efektif mencegah kebocoran akun dan kata sandi. Mendukung koneksi ke lebih dari 30 sumber data utama. Kemampuan manajemen dan kontrol tingkat perusahaan yang kuat: Pengelolaan izin akses sumber daya yang terperinci. Jejak audit operasi yang lengkap. Pemeriksaan kepatuhan SQL yang ketat.	√	×
DMS Data Visualization	Mengonversi hasil eksekusi SQL menjadi grafik ECharts. Mendukung grafik kolom, grafik garis, grafik pai, dan tabel.	√	√

Gunakan plugin edisi perusahaan AliyunDMS

Untuk menggunakan plugin edisi perusahaan AliyunDMS, pilih templat ChatBI Plug-and-Play (Enterprise Edition V6) dalam Langkah 4: Terapkan templat ChatBI untuk membuat aplikasi.

Catatan

Sebelum menggunakan templat edisi perusahaan ChatBI, pastikan bahwa DMS API KEY yang digunakan untuk mengotorisasi plugin AliyunDMS dimiliki oleh Akun Alibaba Cloud yang Anda gunakan untuk masuk ke DMS.

Konfigurasi plugin edisi perusahaan

DMS NL2SQL

Sebelum mengonfigurasi plugin ini, tambahkan instansiasi basis data target ke DMS dan aktifkan hosting keamanan untuk instans tersebut.

Deskripsi parameter:

Question: Masukkan bahasa alami yang ingin Anda konversikan menjadi SQL.
DMS-Registered Database: Pilih jenis dan nama database yang di-hosting di DMS.
DMS API KEY: Kunci API DMS yang diperlukan untuk memanggil plugin. Jika Anda memasukkan kunci di sini, kunci tersebut akan menggantikan kunci yang ditentukan saat otorisasi plugin.
Domain Knowledge: Masukkan pengetahuan spesifik domain untuk skenario bisnis Anda guna meningkatkan akurasi NL2SQL.
Model: Pilih Large Language Model (LLM) untuk menghasilkan SQL. Secara default, digunakan DMS-AI/XiYan-SQL-32B. Jika Anda memilih model adaptif, algoritma NL2SQL akan secara otomatis memilih model yang sesuai berdasarkan kompleksitas pertanyaan.
Custom Model: ID model yang diterapkan secara privat.
Reasoning Effort: Kedalaman inferensi algoritma NL2SQL. Semakin besar kedalamannya, semakin lama waktu yang dibutuhkan untuk menghasilkan SQL. Opsi: Standard (Recommended), High, dan Expert. Secara default, Standard (Recommended) digunakan untuk keseimbangan performa.

DMS SQL Executor

Deskripsi parameter:

SQL: Pernyataan SQL yang akan dieksekusi.
DMS-Registered Database: Pilih jenis dan nama database yang di-hosting di DMS.
DMS API KEY: Kunci API DMS yang diperlukan untuk memanggil plugin. Jika Anda memasukkan kunci di sini, kunci tersebut akan menggantikan kunci yang ditentukan saat otorisasi plugin.
Region ID of Dify: Pilih wilayah tempat instans Dify Anda berada.
Output Format: Pilih Markdown atau JSON. Secara default, digunakan Markdown.
Timeout (second): Periode waktu habis untuk eksekusi SQL.