Data Transmission Service:Hubungkan Feishu ke basis pengetahuan DTS RAGFlow

Tipe data yang didukung

DTS RAGFlow mendukung transfer dokumen cloud, spreadsheet, tabel multidimensi, dan wiki dari Feishu.

Metode akses

Anda dapat menggunakan token akses aplikasi (tenant_access_token) atau token akses pengguna (user_access_token) untuk mengakses data di Feishu.

Langkah 1: Konfigurasi izin akses

Langkah 2: Dapatkan token folder dan ID wiki

1. Masuk ke klien Feishu.

2. Dapatkan token folder yang berisi dokumen cloud Feishu Anda.

   1. Buka folder target.

   2. Dari bilah alamat di bagian atas halaman, salin URL folder tersebut.

   3. Dapatkan token dari URL (informasi setelah folder/).

      Catatan

      Token tidak mencakup simbol ? atau teks apa pun setelahnya.

3. Dapatkan ID wiki.

   1. Buka halaman All Wikis.

   2. Arahkan kursor ke wiki target dan klik Knowledge Base Settings.

   3. Dari bilah alamat di bagian atas halaman, salin URL wiki target.

   4. Ambil ID basis pengetahuan dari URL (informasi setelah settings/).

      Catatan

      ID wiki hanya terdiri dari angka dan tidak mencakup simbol # atau teks apa pun setelahnya.

Langkah 3: Jalankan program KBSync

1. Dapatkan file KBSync.

   Catatan

   Anda dapat bergabung dengan grup DingTalk (ID: 79690034672) dan menghubungi dukungan teknis untuk mendapatkan file KBSync.

2. Siapkan lingkungan runtime untuk program KBSync.

   Catatan

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

3. Siapkan file konfigurasi bernama config.

   1. Buat file Linux bernama config.

   2. Salin konten berikut ke dalam 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

   3. Ganti nilai placeholder dalam file config dengan nilai Anda.

      Penting

      • Jika suatu parameter tidak diperlukan, biarkan nilainya kosong.

      • Jika parameter feishuCloudSpaceDirToken dan feishuWikiSpaceId keduanya ditentukan, hanya dokumen cloud Feishu dan folder induknya yang ditransmisikan (hanya parameter feishuCloudSpaceDirToken yang berlaku).

      • Parameter blackList memiliki prioritas lebih tinggi daripada parameter whiteList.

      Parameter	Wajib	Deskripsi	Cara mendapatkan
      whiteList	Tidak	Jalur yang disertakan (daftar putih) atau dikecualikan (daftar hitam). Jalur dapat berupa jalur folder di Feishu Cloud Drive atau jalur dokumen dalam wiki. Catatan Ekspresi reguler didukung. Pisahkan beberapa jalur dengan spasi.	Dapatkan jalur dari klien Feishu.
      blackList	Tidak
      sinkType	Ya	Jenis sink.	Atur nilainya ke RagFlow.
      sourceType	Ya	Jenis sumber.	Atur nilainya ke Feishu.
      ragflowUrl	Ya	Alamat API server RAGFlow.	Lihat Dapatkan alamat API server.
      ragflowApiKey	Ya	Kunci API untuk basis pengetahuan RAGFlow.	Dapatkan kunci API untuk basis pengetahuan RAGFlow.
      ragflowDatasetId	Ya	ID basis pengetahuan RAGFlow.	Lihat Dapatkan ID basis pengetahuan.
      larkAppId	Ya	App ID aplikasi Feishu Anda.	Lihat Langkah 4 di bagian Persiapan.
      feishuAppSecret	Ya	App Secret aplikasi Feishu Anda.
      feishuUserAccessCode	Tidak Catatan Anda hanya perlu pass parameter ini saat mengakses data di Feishu menggunakan user_access_token.	Kode otorisasi dari Feishu.	Dapatkan kode otorisasi.
      feishuCloudSpaceDirToken	Tidak Catatan Berikan nilai hanya untuk salah satu dari dua parameter ini.	Token folder yang berisi dokumen cloud Feishu.	Lihat Langkah 2: Dapatkan token folder dan ID wiki.
      feishuWikiSpaceId		ID wiki Feishu.

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

5. Di lingkungan Linux, jalankan perintah ./KBSync --config config untuk menjalankan program KBSync.

   Jika outputnya mirip seperti berikut, program KBSync telah berhasil dijalankan.

   ./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

Dapatkan alamat API server

1. Masuk ke halaman RAGFlow.

2. Di panel navigasi sebelah kiri, klik API.

3. Dapatkan alamat API server.

Dapatkan kunci API

1. Masuk ke halaman RAGFlow.

2. Di panel navigasi sebelah kiri, klik API.

3. Di sebelah kanan RAGFlow API, klik API KEY.

4. Pada kotak dialog API KEY, klik Create New Key.

5. Klik untuk menyalin token.

Dapatkan ID basis pengetahuan

1. Masuk ke halaman RAGFlow.

2. Pada halaman Knowledge Base, klik basis pengetahuan target.

3. Di URL halaman saat ini, salin ID basis pengetahuan.

   Catatan

   ID basis pengetahuan adalah nilai setelah id=.