Transfer data dari Lark ke basis pengetahuan DTS RAGFlow - Data Transmission Service

Anda dapat mentransfer data dari Lark ke basis pengetahuan RAGFlow di Data Transmission Service (DTS). Tipe data yang didukung mencakup Lark Docs, Sheets, Bitable, dan Wiki.

Prasyarat

Anda telah membuat basis pengetahuan RAGFlow di DTS dan mengonfigurasi daftar putih IP.

Informasi latar belakang

Tipe data yang didukung

DTS RAGFlow mendukung data dari Lark Docs, Sheets, Bitable, dan Wiki.

Metode akses

Data Lark dapat diakses menggunakan token akses aplikasi (tenant_access_token) atau token akses pengguna (user_access_token).

Metode	Jenis izin	Kelebihan	Kekurangan
`tenant_access_token` (Direkomendasikan)	Identitas aplikasi	Mendukung transfer yang dapat dilanjutkan kembali. Hanya memerlukan konfigurasi satu kali untuk mentransfer satu folder atau Wiki.	Otorisasi lebih kompleks. Anda harus mengonfigurasi izin akses terpisah untuk Drive dan Wiki.
`user_access_token`	Identitas pengguna	Otorisasi lebih sederhana. Memberikan akses ke semua folder tanpa memerlukan izin terpisah untuk Drive dan Wiki.	Anda harus memperoleh kode otorisasi Lark baru setiap kali menjalankan program KBSync. Kode otorisasi Lark kedaluwarsa.

Sebelum memulai

Login ke Lark Open Platform, lalu buka Developer Console.
Buat aplikasi.

Anda dapat mengklik Create Enterprise-developed Application, mengonfigurasi informasi terkait seperti Name dan Application Description, lalu klik Create.
Klik kartu aplikasi untuk membuka halaman konfigurasinya.

Secara default, Anda berada di halaman Basic Information > Credentials and Basic Information.
Di halaman Credentials and Basic Information, pada bagian Application Credentials, catat App ID dan App Secret.

Prosedur

Catatan

Untuk petunjuk lengkap mengenai Lark, lihat dokumentasi resmi Lark (Help Center dan dokumen pengembangan).

Langkah 1: Konfigurasi izin akses

Token akses aplikasi

Login ke Lark Open Platform, lalu buka Developer Console.
Klik aplikasi yang telah Anda buat di bagian Sebelum memulai.
Tambahkan bot dan rilis aplikasi.
1. Di bilah navigasi kiri, pilih Application Capabilities > Add Application Capability.
2. Di tab Add by Capability, pada kartu bot, klik Add.
3. Di bagian atas halaman, klik Create Version.
  
  Catatan
  Atau, di bilah navigasi kiri, pilih App Publishing > Version Management and Publishing, lalu klik Create Version.
4. Di halaman Version Details, masukkan Application Version dan Update Description.
  
  Catatan
  Anda dapat menggunakan bot default untuk default mobile client capabilities dan default desktop client capabilities.
5. Klik Save.
6. Di kotak dialog yang muncul, klik Confirm Publish.
Konfigurasi izin API.
1. Di bilah navigasi kiri, pilih Development Configuration > Permission Management.
2. Klik Batch Import/Export Permissions.
3. Di tab Import, pada kotak teks JSON, konfigurasikan izin identitas pengguna berikut untuk aplikasi.
```
{
  "scopes": {
    "tenant": [
      "docs:document:export",
      "drive:drive",
      "wiki:wiki"
    ],
    "user": []
  }
}
```
4. Klik Next untuk mengonfirmasi izin baru.
5. Klik Activate Now.
Login ke klien Lark, buat grup baru, lalu tambahkan aplikasi yang telah Anda buat di bagian Persiapan sebagai group bot.
Konfigurasi izin akses untuk Drive dan Wiki.
Izin Drive
1. Buka folder target di Drive.
2. Di sisi kanan halaman, klik Share.
3. Untuk Invite collaborators, tambahkan grup yang telah Anda buat di Langkah 5.
  
  Izin Read default sudah cukup untuk tujuan ini.
4. Klik Send.
Izin Wiki
1. Buka halaman All Wikis.
2. Arahkan pointer ke basis pengetahuan target, lalu klik Knowledge Base Settings.
3. Klik tab Member Settings, lalu di area Roles and Permissions, pada tab Administrator, klik Add Administrator.
4. Di kotak dialog yang muncul, tambahkan grup yang telah Anda buat di Langkah 5, lalu klik Next.
5. Klik Send.

Token akses pengguna

Login ke Lark Open Platform, lalu buka Developer Console.
Klik aplikasi yang telah Anda buat di bagian Sebelum memulai.
Konfigurasi izin API.
1. Di bilah navigasi kiri, pilih Development Configuration > Permission Management.
2. Klik Batch Import/Export Permissions.
3. Tempel JSON berikut untuk memberikan izin identitas pengguna yang diperlukan kepada aplikasi yang telah Anda buat.
```
{
  "scopes": {
    "tenant": [],
    "user": [
      "offline_access",
      "docs:document:export",
      "drive:drive",
      "wiki:wiki"
    ]
  }
}
```
4. Klik Next, Confirm New Permissions.
5. Klik Activate Now.
Konfigurasi URL redirect.
1. Di bilah navigasi kiri, pilih Development Configuration > Security Settings.
2. Di kotak teks Redirect URL, masukkan https://www.aliyun.com.
3. Klik Add di sebelah kanan kotak teks.
4. Nyalakan sakelar Refresh user_access_token.
  
  Catatan
  Jika sakelar ini tidak terlihat, fitur tersebut diaktifkan secara default.
Peroleh kode otorisasi.
1. Buat URL untuk halaman otorisasi Lark.
  
  Catatan
  Anda harus mengganti YOUR_FEISHU_CLIENT_ID dalam URL dengan App ID yang dicatat di Persiapan.
```
https://accounts.feishu.cn/open-apis/authen/v1/authorize?client_id=YOUR_FEISHU_CLIENT_ID&redirect_uri=https://www.aliyun.com&scope=drive:drive offline_access docs:document:export wiki:wiki
```
2. Buka halaman otorisasi di browser.
3. Klik Authorize.
4. Peroleh kode otorisasi (code) dari URL redirect.
  
  Catatan
  Kode otorisasi tidak mencakup code=, &, atau informasi setelah simbol &.

Langkah 2: Dapatkan token folder Lark dan ID Wiki

Login ke klien Lark.
Peroleh token folder untuk folder Lark Docs.
1. Buka folder target.
2. Dari bilah alamat browser Anda, salin URL folder tersebut.
3. Peroleh token dari URL (informasi setelah folder/).
  
  Catatan
  Token tidak mencakup ? atau informasi apa pun setelahnya.
Peroleh ID Wiki.
1. Buka halaman All Wikis.
2. Arahkan pointer ke basis pengetahuan target, lalu klik Knowledge Base Settings.
3. Dari bilah alamat browser Anda, salin URL Wiki target.
4. Peroleh ID basis pengetahuan dari URL (string setelah settings/).
  
  Catatan
  ID basis pengetahuan hanya berupa angka dan tidak mencakup simbol # atau informasi apa pun setelahnya.

Langkah 3: Jalankan program KBSync

Peroleh file KBSync.

Catatan
Anda dapat bergabung dengan grup DingTalk (ID: 79690034672) dan menghubungi dukungan teknis untuk memperoleh file KBSync.
Persiapkan lingkungan runtime untuk program KBSync.

Catatan
Program KBSync memerlukan lingkungan Linux yang memiliki akses ke Lark Open Platform dan RAGFlow.

Persiapkan file config.

Buat file sistem Linux bernama config.

Salin kode berikut ke file config.

whiteList=
blackList=
sinkType=RagFlow
sourceType=FeiShu
ragflowUrl=http://XX.XX.XX.XX
ragflowApiKey=Bearer RAGFlow-BmND******MDI0Mm
ragflowDatasetId=928d061******2ac120006
feishuAppId=cli_a8a******d00d
feishuAppSecret=pMp73Si******UDrWXBSOa
feishuUserAccessCode=bGzpx6******B9KFCdzdCDHG
feishuCloudSpaceDirToken=ESJm*******CRdn002cii3bnAc
feishuWikiSpaceId=7504968******8674

Ganti parameter dalam file config.

Penting

Untuk parameter yang tidak perlu dikonfigurasi, biarkan nilainya kosong.
Jika Anda memberikan nilai untuk kedua parameter feishuCloudSpaceDirToken dan feishuWikiSpaceId, hanya Lark Docs dan folder induknya yang ditransfer karena hanya parameter feishuCloudSpaceDirToken yang berlaku.
Parameter blackList memiliki prioritas lebih tinggi daripada parameter whiteList.

Parameter	Wajib	Deskripsi	Cara memperoleh
`whiteList`	Tidak	Jalur file yang akan ditransfer (daftar putih) dan file yang dikecualikan (daftar hitam). Jalur ini mencakup jalur folder di Lark Docs dan jalur dokumen di basis pengetahuan. Catatan Ekspresi reguler didukung. Pisahkan beberapa jalur dengan spasi.	Peroleh jalur dari klien Lark.
`blackList`	Tidak		Peroleh jalur dari klien Lark.
`sinkType`	Ya	Jenis tujuan.	Atur parameter ini ke `RagFlow`.
`sourceType`	Ya	Jenis sumber.	Atur parameter ini ke `Feishu`.
`ragflowUrl`	Ya	Alamat RAGFlow (API server).	Peroleh alamat API server basis pengetahuan RAGFlow.
`ragflowApiKey`	Ya	Kunci API untuk basis pengetahuan RAGFlow.	Peroleh kunci API basis pengetahuan RAGFlow.
`ragflowDatasetId`	Ya	ID basis pengetahuan RAGFlow.	Peroleh ID basis pengetahuan RAGFlow.
`feishuAppId`	Ya	ID aplikasi di Lark (App ID).	Peroleh App ID dan App Secret.
`feishuAppSecret`	Ya	Rahasia aplikasi di Lark (App Secret).	Peroleh App ID dan App Secret.
`feishuUserAccessCode`	Tidak Catatan Parameter ini hanya diperlukan saat Anda mengakses data Lark menggunakan metode user_access_token.	Kode otorisasi untuk Lark.	Peroleh kode otorisasi.
`feishuCloudSpaceDirToken`	Tidak Catatan Berikan nilai hanya untuk salah satu parameter ini.	Token untuk folder yang berisi Lark Docs.	Peroleh token folder Lark Docs dan ID basis pengetahuan.
`feishuWikiSpaceId`		ID basis pengetahuan Lark.	Peroleh token folder Lark Docs dan ID basis pengetahuan.

Letakkan file KBSync dan file konfigurasi config di direktori yang sama dalam lingkungan Linux.

Di lingkungan Linux Anda, jalankan perintah ./KBSync --config config untuk memulai program KBSync.

Output berikut menunjukkan bahwa KBSync berjalan dengan benar.

./KBSync --config config

INFO config whiteList=, blackList=
INFO config ragflowUrl=http://XX.XX.XX.XX/, ragflowApiKey=Bearer RAGFlow-BmND******MDI0Mm
INFO config ragflowDatasetId=928d061******2ac120006
INFO config feishuAppId=cli_a8a******d00d, feishuAppSecret=pMp73Si******UDrWXBSOa
INFO Response from https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal: 200, headers: {'Server': 'Tengine', 'Content-Type': 'application/json', 'Content-Length': '102', 'Connection': 'keep-alive', 'Date': 'Tue, 08 Jul 2025 02:49:01 GMT', 'Request-Id': '25bf****-d386-4a86-****-f440f070****', 'Tt_st****': '1', 'X-Lgw-Dst-Svc': 'jbpiSR****OiA0J3d****-Oz0xugYAH9otZIFg4x****', 'X-Request-Id': '25bf****-d386-4a86-b9f4-f440f070****', 'X-Tt-Logid': '202507081049012933B870245850D****', 'server-timing': 'inner; dur=73, cdn-cache;desc=MISS,edge;dur=0,origin;dur=129', 'x-tt-trace-host': '****', 'x-tt-trace-tag': '****', 'x-tt-trace-id': '00-****', 'X-Timestamp': '175194****.952', 'Via': 'cache8.cn6540[129,0]', 'Timing-Allow-Origin': '*', 'EagleId': '6ae3651c1751942941849****'}, body: b'{"code":0,"expire":4340,"msg":"ok","tenant_access_token":"t-g10478a*******CSC3YVY"}'
INFO set feishu tenant access token expires in: 4340

Lampiran

Peroleh alamat API server RAGFlow

Login ke halaman RAGFlow.
Di panel navigasi kiri, klik API.
Peroleh API server.

Peroleh kunci API RAGFlow

Login ke halaman RAGFlow.
Di panel navigasi kiri, klik API.
Di sebelah kanan RAGFlow API, klik API KEY.
Di kotak dialog API KEY, klik Create New Key.
Klik untuk menyalin kunci, lalu simpan di lokasi yang aman.

Peroleh ID basis pengetahuan RAGFlow

Login ke halaman RAGFlow.
Di halaman Knowledge Base, klik basis pengetahuan target.
Di URL pada bilah alamat browser Anda, salin ID basis pengetahuan.

Catatan
ID basis pengetahuan adalah string karakter setelah id=.