すべてのプロダクト
Search

このプロダクト

    Data Transmission Service:Lark を DTS RAGFlow ナレッジベースに接続する

    ドキュメントセンター

    Data Transmission Service:Lark を DTS RAGFlow ナレッジベースに接続する

    最終更新日:Jul 18, 2026

    Data Transmission Service (DTS) の RAGFlow ナレッジベースに、Lark からデータを転送できます。サポートされるデータの型には、Lark Docs、Sheets、Bitable、Wiki が含まれます。

    前提条件

    DTS で RAGFlow ナレッジベースを作成済み であり、IP ホワイトリストを構成済み である必要があります。

    背景情報

    サポートされるデータの型

    DTS RAGFlow は、Lark Docs、Sheets、Bitable、Wiki からのデータをサポートします。

    アクセス方法

    Lark のデータには、アプリケーションアクセストークン (tenant_access_token) またはユーザーアクセストークン (user_access_token) のいずれかを使用してアクセスできます。

    メソッド

    権限の種類

    メリット

    デメリット

    tenant_access_token（推奨）

    アプリケーション ID

    • 再開可能な転送をサポートします。

    • 単一のフォルダまたは Wiki を転送する場合、一度だけ構成すれば十分です。

    認可がより複雑です。ドライブと Wiki に対して別々にアクセス権限を構成する必要があります。

    user_access_token

    ユーザー ID

    認可がシンプルです。ドライブと Wiki に対して別々の権限を設定することなく、すべてのフォルダにアクセスできます。

    • KBSync プログラムを実行するたびに、新しい Lark 認証コードを取得する必要があります。

    • Lark 認証コードには有効期限があります。

    事前準備

    1. Lark Open Platform にログインし、Developer Console に移動します。

    2. アプリを作成します。

      Create Enterprise-developed Application をクリックし、名前 や Application Description などの関連情報を構成してから、作成 をクリックします。

    3. アプリカードをクリックして、その構成ページを開きます。

      デフォルトでは、基本情報 > Credentials and Basic Information ページが表示されます。

    4. Credentials and Basic Information ページの Application Credentials セクションで、App ID および App Secret を記録します。

    操作手順

    説明

    Lark の詳細な手順については、公式 Lark ドキュメント（ヘルプセンター および 開発ドキュメント）をご参照ください。

    ステップ 1：アクセス権限の構成

    アプリケーションアクセストークン

    1. Lark Open Platform にログインし、Developer Console に移動します。

    2. 事前準備 セクションで作成したアプリをクリックします。

    3. ボットを追加してアプリをリリースします。

      1. 左側のナビゲーションバーで、Application Capabilities > Add Application Capability を選択します。

      2. Add by Capability タブで、bot のカードにある 追加 をクリックします。

      3. ページ上部の Create Version をクリックします。

        説明

        または、左側のナビゲーションバーで App Publishing > Version Management and Publishing を選択し、Create Version をクリックします。

      4. バージョンの詳細 ページで、Application Version および Update Description を入力します。

        説明

        default mobile client capabilities および default desktop client capabilities には、デフォルトの bot を使用できます。

      5. 保存 をクリックします。

      6. 表示されたダイアログボックスで、Confirm Publish をクリックします。

    4. API 権限を構成します。

      1. 左側のナビゲーションバーで、Development Configuration > 権限管理 を選択します。

      2. Batch Import/Export Permissions をクリックします。

      3. [輸入] タブの [JSON] テキストボックスで、アプリケーションの以下のユーザー ID の権限を設定します。

        {
  "scopes": {
    "tenant": [
      "docs:document:export",
      "drive:drive",
      "wiki:wiki"
    ],
    "user": []
  }
}

      4. [新しい権限を確認して次へ] をクリックしてください。

      5. 今すぐ有効化 をクリックします。

    5. Lark クライアントにログインし、新しいグループを作成して、事前準備セクションで作成したアプリケーション を グループボット として追加します。

    6. ドライブおよび Wiki のアクセス権限を構成します。

      ドライブの権限

      1. ドライブで対象のフォルダに移動します。

      2. ページ右側の 共有 をクリックします。

      3. Invite collaborators で、ステップ 5 で作成したグループを追加します。

        この目的には、デフォルトの Read 権限で十分です。

      4. 送信 をクリックします。

      Wiki の権限

      1. All Wikis ページに移動します。

      2. 対象のナレッジベースにポインターを合わせて、Knowledge Base Settings をクリックします。

      3. Member Settings タブをクリックし、Roles and Permissions エリアの Administrator タブで、Add Administrator をクリックします。

      4. 表示されたダイアログボックスで、ステップ 5 で作成したグループを追加し、次へ をクリックします。

      5. 送信 をクリックします。

    ユーザーアクセストークン

    1. Lark Open Platform にログインし、Developer Console に移動します。

    2. 事前準備 セクションで作成したアプリをクリックします。

    3. API 権限を構成します。

      1. 左側のナビゲーションバーで、Development Configuration > Permission Management を選択します。

      2. Batch Import/Export Permissions をクリックします。

      3. 次の JSON を貼り付けて、作成したアプリ に必要なユーザー ID 権限を付与します。

        {
  "scopes": {
    "tenant": [],
    "user": [
      "offline_access",
      "docs:document:export",
      "drive:drive",
      "wiki:wiki"
    ]
  }
}

      4. Next, Confirm New Permissions をクリックします。

      5. 今すぐ有効化 をクリックします。

    4. リダイレクト URL を構成します。

      1. 左側のナビゲーションバーで、Development Configuration > セキュリティ設定 を選択します。

      2. Redirect URL テキストボックスに、https://www.aliyun.com を入力します。

      3. テキストボックスの右側にある 追加 をクリックします。

      4. Refresh user_access_token スイッチをオンにします。

        説明

        このスイッチが表示されない場合は、この機能はデフォルトで有効になっています。

    5. 認証コードを取得します。

      1. Lark 認証ページの URL を構築します。

        説明

        URL 内の YOUR_FEISHU_CLIENT_ID は、事前準備 で記録した App ID に置き換える必要があります。

        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. ブラウザで認証ページを開きます。

      3. 権限付与 をクリックします。

      4. リダイレクト URL から認証コード (code) を取得します。

        説明

        認証コードには、code=、&、および & 記号以降の情報は含まれません。

    ステップ 2：Lark フォルダトークンおよび Wiki ID の取得

    1. Lark クライアントにログインします。

    2. Lark Docs フォルダのフォルダトークンを取得します。

      1. 対象のフォルダに移動します。

      2. ブラウザのアドレスバーから、フォルダの URL をコピーします。

      3. URL からトークン（folder/ 以降の情報）を取得します。

        説明

        トークンには、? およびそれ以降の情報は含まれません。

    3. Wiki の ID を取得します。

      1. All Wikis ページに移動します。

      2. 対象のナレッジベースにポインターを合わせて、Knowledge Base Settings をクリックします。

      3. ブラウザのアドレスバーから、対象 Wiki の URL をコピーします。

      4. URL からナレッジベース ID（settings/ 以降の文字列）を取得します。

        説明

        ナレッジベース ID は数値のみで構成されており、# 記号およびそれ以降の情報は含まれません。

    ステップ 3：KBSync プログラムの実行

    1. KBSync ファイルを取得します。

      説明

      DingTalk グループ（ID：79690034672）に参加し、テクニカルサポートに連絡して KBSync ファイルを取得できます。

    2. KBSync プログラムの実行環境を準備します。

      説明

      KBSync プログラムには、Lark Open Platform および RAGFlow にアクセス可能な Linux 環境が必要です。

    3. config ファイルを準備します。

      1. config という名前の Linux システムファイルを作成します。

      2. 次のコードを 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. config ファイル内のパラメーターを置き換えます。

        重要

        • 構成不要なパラメーターは、値を空のままにしてください。

        • feishuCloudSpaceDirToken パラメーターと feishuWikiSpaceId パラメーターの両方に値を指定した場合、feishuCloudSpaceDirToken パラメーターのみが有効となるため、Lark Docs およびその親フォルダのみが転送されます。

        • blackList パラメーターは、whiteList パラメーターよりも優先度が高くなります。

        パラメーター

        必須

        説明

        取得方法

        whiteList

        いいえ

        転送対象のファイルパス（ホワイトリスト）および除外対象のファイルパス（ブラックリスト）。これらのパスには、Lark Docs のフォルダパスおよびナレッジベース内のドキュメントパスが含まれます。

        説明

        正規表現がサポートされています。複数のパスをスペースで区切ってください。

        Lark クライアントからパスを取得します。

        blackList

        いいえ

        sinkType

        はい

        送信先のタイプ。

        このパラメーターを RagFlow に設定します。

        sourceType

        はい

        ソースのタイプ。

        このパラメーターを Feishu に設定します。

        ragflowUrl

        はい

        RAGFlow のアドレス（API サーバー）。

        RAGFlow ナレッジベースの API サーバーアドレスを取得する。

        ragflowApiKey

        はい

        RAGFlow ナレッジベースの API キー。

        RAGFlow ナレッジベースの API キーを取得する。

        ragflowDatasetId

        はい

        RAGFlow ナレッジベースの ID。

        RAGFlow ナレッジベースの ID を取得する。

        feishuAppId

        はい

        Lark のアプリケーション ID（App ID）。

        App ID および App Secret を取得する。

        feishuAppSecret

        はい

        Lark のアプリケーションシークレット（App Secret）。

        feishuUserAccessCode

        いいえ

        説明

        このパラメーターは、user_access_token メソッドを使用して Lark データにアクセスする場合にのみ必要です。

        Lark の認証コード。

        認証コードを取得する。

        feishuCloudSpaceDirToken

        いいえ

        説明

        これらのパラメーターのいずれか一方にのみ値を渡してください。

        Lark Docs を含むフォルダのトークン。

        Lark Docs フォルダのトークンおよびナレッジベースの ID を取得する。

        feishuWikiSpaceId

        Lark ナレッジベースの ID。

    4. Linux 環境内で、KBSync ファイルと config 設定ファイルを同じディレクトリに配置します。

    5. Linux 環境で、./KBSync --config config コマンドを実行して、KBSync プログラムを起動します。

      次の出力が表示された場合、KBSync が正常に実行されています。

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

    付録

    RAGFlow API サーバーアドレスの取得

    1. RAGFlow ページにログインします。

    2. 左側のナビゲーションウィンドウで、API をクリックします。

    3. API サーバー を取得します。

    RAGFlow API キーの取得

    1. RAGFlow ページにログインします。

    2. 左側のナビゲーションウィンドウで、API をクリックします。

    3. RAGFlow API の右側にある API KEY をクリックします。

    4. API KEY ダイアログボックスで、Create New Key をクリックします。

    5. image をクリックしてキーをコピーし、安全な場所に保存します。

    RAGFlow ナレッジベース ID の取得

    1. RAGFlow ページにログインします。

    2. ナレッジベース ページで、対象のナレッジベースをクリックします。

    3. ブラウザのアドレスバーの URL から、ナレッジベース ID をコピーします。

      説明

      ナレッジベース ID は、id= 以降の文字列です。