ナレッジベース

最終更新 2026/09/22

ナレッジベースは、散在している業務資料を、継続的にメンテナンスでき、Agent との会話で使用できるナレッジアセットとして整理します。

対象読者：データアナリスト、運用担当者、データ基盤担当者、ナレッジコンテンツの管理者、テクニカルサポート担当者。入口は「機能センター → ナレッジベース」です。

1. ナレッジベースで解決できること

ナレッジベースは、社内のナレッジや業務資料を一元管理し、元のファイルやオンラインドキュメントを、検索や閲覧に適したナレッジ目次と Wiki ページに整理します。製品のルール、業務の手法、プロジェクト資料、操作規範、サポートドキュメントの蓄積に適しています。

ナレッジベースを使うと、次の3つの価値が得られます。

• 一元的な蓄積：ファイル、Feishu ドキュメント、Web ページの資料を同じナレッジ空間に集約します。
• 構造化された利用：ソース資料をナレッジ目次と Wiki ページにコンパイルし、探す手間を減らします。
• 業務の会話をサポート：システムが Agent との会話で適切なナレッジベースを自動的に見つけて使用し、既存の業務資料に基づいて回答できるようにします。

1.1 ナレッジベースを使うタイミング

製品のルール、業務の集計基準、プロジェクトの背景、サポート資料を Agent に参照させたい場合は、ナレッジベースを使用します。特定のワークスペースの長期的な取り決めや背景を管理したい場合はスペースメモリを、安定した操作手順を再利用可能なプロセスとして整理したい場合はSkillを使用します。この3つは組み合わせて使用できます。

ナレッジベースは一時的な添付ファイルではありません。基本的な流れは、ナレッジベースの作成 → ソース資料の追加 → コンパイル規則の準備 → コンパイルして公開 → 会話での使用と継続的なメンテナンス、です。ソースが変わった場合は、再コンパイルしないと、更新内容が新しい公開済みナレッジに反映されません。

1.2 ナレッジベースのタイプの選択

タイプ	適用シナリオ	操作と権限
システムナレッジベース	プラットフォームにプリセットされたナレッジコンテンツを使用	ソースの変更やコンパイルは自分で行えません。一部のコンテンツは Agent との会話での使用のみ許可され、詳細を開くことはできません
会社ナレッジベース	チームで業務ナレッジを共同で使用・メンテナンス	会社リソース管理者が作成し、メンバーのロールでアクセスとメンテナンスを制御します。会社全体にデフォルトで表示されるわけではありません
個人ナレッジベース	個人でよく使う資料を蓄積し、検証してから必要に応じて会社に公開	個人で管理し、業務範囲を関連付けて会話で使用可能

通常のナレッジベースと読み取り専用スナップショット：通常の個人ナレッジベース・会社ナレッジベースでは、権限に応じてソースのメンテナンスやコンパイルを行えます。インポートしたコンパイル済みスナップショットは、そのまま閲覧や会話に使用するためのもので、ナレッジ本文の編集、ソースファイルやルールのメンテナンスはできず、再コンパイルもできません。この2つを混同しないでください。

2. ナレッジベースの作成と資料の追加

2.1 ナレッジベースの作成

1. 「機能センター → ナレッジベース」に移動し、「個人ナレッジベース」または「会社ナレッジベース」を選択します。会社ナレッジベースの作成には、会社リソースの管理権限が必要です。
2. ナレッジベース名を入力し、必要に応じて関連付け範囲、タグ、説明を追加します。
3. 保存すると詳細ページに移動します。「ソースファイル」で資料を追加します。

入力ルール：名前は必須で、30文字以内です。タグは最大2個まで追加でき、各タグは15文字以内です。説明は200文字以内です。プロジェクト、コミュニティスペース、データ開発スペースなどの関連付け範囲は任意で、業務シナリオの識別や資料の推薦に役立てるためのものです。アクセス権限は付与されません。

2.2 元の資料の追加

「ソースファイル」で、資料の形式に応じてファイルのアップロードまたは URL の追加を選択します。

• ファイルをアップロード：Markdown、TXT、CSV、PDF、Word、Excel、PPT と一般的な画像形式に対応しています。1ファイルあたり50MB以下で、一度に複数のファイルを選択できます。
• ZIP ディレクトリのアップロード：複数の資料をディレクトリごと ZIP にまとめてアップロードし、ディレクトリソースとして管理できます。1つの ZIP は50MB以下です。これも元の資料のため、コンパイルしないと利用可能なナレッジにはなりません。
• URL を追加：Feishu または Lark のクラウドドキュメント、ナレッジベースのリンク、およびその他のアクセス可能な Web ページに対応しています。表示名を入力できます。その他の Web ページでは、解析の説明を追加することもできます。

URL を追加する前に「接続テスト」を実行できます。Feishu のソースを使うには、環境で Lark-CLI の統合が完了しており、対応するドキュメントへのアクセス権が付与されている必要があります。ツールをインストールしただけではアクセス権は得られません。Feishu のナレッジベースのリンクは、ソースの機能に応じて子ドキュメントや子ページが解析されますが、この場合も対応するアクセス権が必要です。

アップロードが完了したら、まずソースのリストとステータスを確認します。同じ名前でアップロードしても既存のソースを直接上書きすることはできません。元のソースがまだコンパイルされていない場合でも、該当するソースの行で置換操作を使い、影響を確認してから確定してください。

2.3 コンパイル済みスナップショットのインポート

コンパイル済みのナレッジパッケージがある場合は、ナレッジベースのリストで「スナップショットをインポート」を選択できます。会社リソースの管理権限を持つユーザーは「会社スナップショットをインポート」も選択できます。名前などの情報を入力し、50MB以下の ZIP をアップロードして送信したら、インポートの完了を待ちます。

スナップショットパッケージには、ナレッジ目次ファイル index.md と、wiki/ 配下の Markdown ページが少なくとも1つ含まれている必要があります。通常の元の資料の圧縮ファイルを、コンパイル済みスナップショットとしてインポートしないでください。インポートに成功すると読み取り専用のナレッジベースになり、再コンパイルしなくてもそのまま閲覧や会話で使用できます。インポートがまだ完了していない場合や結果がはっきりしない場合は、まずタスクのステータスを確認し、重複して送信しないでください。

3. ルールの生成またはインポートとコンパイル

コンパイル規則は、現在のナレッジベースの資料をシステムがどのように整理するかを定めます。通常のナレッジベースでは、まず有効なルールを用意してから、ソースをナレッジ目次と Wiki ページにコンパイルする必要があります。読み取り専用スナップショットには、以下の操作は適用されません。

3.1 コンパイル規則の準備

システムで生成：「ソースファイル」で自動コンパイルをクリックします。まだルールがない場合は、まずモデルを選択して生成を開始します。タスクはバックグラウンドに移すことができます。完了したら「コンパイル規則」で内容を確認し、整理の方法が業務のニーズに合っているかを確かめます。

既存のルールをインポート：「コンパイル規則」で「ルールをインポート」を選択し、256KB以下の Markdown（.md）ファイルをアップロードします。アップロードでは処理待ちの原稿として保存し、プログラムによる検証を行うだけです。AI は呼び出されず、正式ルールもすぐには置き換わりません。

1. 検証結果を確認し、必要に応じて本文を編集します。「AI 検証」や「AI 修復」を選択することもできます。この2つはモデルを呼び出し、Token を消費します。
2. プログラムによる検証に合格し、実行中のタスクがなくなったら、「プレビューして適用」に進み、全文、正式ルールとの差分、および提案事項を確認します。AI 検証は適用の必須条件ではありません。
3. 確認したら「正式ルールの置換を確定」を選択します。ウィンドウを閉じても、保存済みの原稿とバックグラウンドタスクは保持されます。ただし、ルールを適用しても自動ではコンパイルされず、既存の Wiki は再コンパイルしないと新しいルールが反映されません。

3.2 コンパイル方式の選択

方式	適用ケース	処理方法
増分コンパイル	少数のソースを追加、置換、または削除した場合	コンパイル待ち、失敗、または変更された内容を処理し、既存のナレッジの結果をもとに関連するページを追加、更新、または整理
全量コンパイル	資料の構成が大きく変わった場合、またはナレッジベース全体を整理し直したい場合	利用可能なすべてのソースを処理し直し、新しい Wiki の結果を公開

開始後は、ステータスと実行の進捗を確認できます。タスクをバックグラウンドに移すこともできます。コンパイルを重複して開始しないでください。コンパイル、ルールの生成、公開の確認の間は、一部の資料の変更操作が一時的に使用できなくなります。

3.3 結果と使用量の確認

コンパイル後は、「ナレッジ目次」で全体の構成を確認し、「Wiki ページ」で具体的な内容を閲覧・検索します。対応する権限がある場合は、「ソースファイル」でソースのステータスを、「コンパイル規則」で整理のルールを、「コンパイル使用量」でルールの生成とコンパイルの Token 消費量を確認できます。

タスクの終了は、すべての資料の完了を意味するとは限りません：一部公開済みや、一部のソースが未完了と表示された場合は、エラー詳細、公開済みのページ、旧版を再利用したページ、今回未完了の内容を確認してから、該当するソースを処理します。更新に失敗した場合でも、前回公開に成功した内容は引き続き使用でき、更新待ちの内容は保持されます。コンパイルをキャンセルしても、未完了の結果が新しいナレッジとして公開されることはありません。

4. Agent、スペース、会話での使用

Agent で設定：特定の Agent に決まった業務資料を優先して使わせたい場合は、その Agent の機能設定で、使用権限のあるナレッジベースを選択できます。具体的な設定の入口はAgentを参照してください。

ワークスペースで設定：スペースの会話で共通の資料の入口を使いたい場合は、権限のあるメンバーがスペース機能設定でナレッジベースを設定できます。共有スペースの共通ナレッジベースは、システムタイプと会社タイプに限られます。この設定はナレッジベースの権限付与の代わりにはならず、メンバーが使用する際にはそれぞれの権限チェックを通過する必要があります。スペース機能設定については新しいスペースを参照してください。

会話で質問：質問を直接入力し、業務のテーマ、ナレッジベース名、または資料の範囲をできるだけ明記します。システムは質問に応じて、使用権限のある関連ナレッジベースを自動的に見つけるため、毎回事前にチェックを入れる必要はありません。会話の中でナレッジベースを手動で選択することもでき、現在は1つの会話につき最大10個まで手動で選択できます。選択と質問の操作は会話を参照してください。

手動選択は優先的な検索を意味し、排他的な境界ではありません：選択した資料が質問に関連する場合は優先的に使用されますが、権限が付与されていて現在の質問に関連するその他の情報が除外されるわけではありません。指定した資料のみに基づいて回答させたい場合は、質問の中でその旨を明確に指示し、不足している情報を説明するよう求めてください。

信頼できる利用の原則：回答にナレッジベースの内容を使う場合、重要な結論は実際に読み取ったページ本文によって直接裏付けられている必要があります。目次、タイトル、タグ、展開されていないページの要約はナビゲーションにのみ使用し、資料に記載のない部分は情報の欠落として明示する必要があります。一部の保護されたナレッジは、規定に従って会話で使用することのみ許可されており、全文を閲覧・エクスポートできることを意味するものではありません。

5. 共同作業の権限と会社への公開

5.1 職責に応じた権限の割り当て

会社ナレッジベースでは、「共有」でメンバーを追加し、ロールを割り当てます。通常のコンパイル可能なナレッジベースの主な権限は次のとおりです。

ロール	主な権限
所有者（Owner）	設定、ナレッジコンテンツ、ソース、ルール、コンパイル、メンバーを管理できます。ナレッジベースの削除や所有権の移転も可能です
管理者（Admin）	設定、ナレッジコンテンツ、ソース、ルール、コンパイル、メンバーを管理できます。このロールだけではナレッジベースの削除や所有権の移転はできません
共同編集者	ナレッジコンテンツとソースの閲覧とメンテナンスができます。メンバーやルールの管理、コンパイルの開始はできません
閲覧者	ナレッジ目次と Wiki ページを閲覧し、会話で使用できます。ソースファイルやルールの閲覧、内容の変更はできません
Agent Only	Agent との会話でのみナレッジベースを使用できます。詳細を開いたり、内容を管理したりすることはできません

会社リソース管理者は別レイヤーの権限です：会社リソースの管理権限を持つ管理者は、自社の会社ナレッジベースを管理でき、削除や移転も行えます。上の表のナレッジベース内の Admin の制限は受けません。スペースの Owner や管理者であることは、会社リソースの管理権限を持つことと同じではなく、ナレッジベースの管理権限も自動的には得られません。

読み取り専用スナップショットの内容、ソース、ルール、コンパイル操作は引き続き編集できません。対応する権限がある場合は名前などの設定をメンテナンスでき、会社スナップショットではメンバーの管理や所有権の移転も可能です。個人ナレッジベースには現在、会社ナレッジベースのような「共有」や所有権の移転の入口はありません。

会社ナレッジベースを引き継ぐ必要がある場合は、移転の権限を持つ担当者が新しい所有者を選択して確定します。普段は最小権限の原則に従ってロールを割り当て、アクセスが不要になったメンバーは速やかに削除します。特定のタブやボタンが表示されない場合は、まずロール、ナレッジベースのタイプ、タスクのステータスを確認してください。

5.2 個人ナレッジベースを会社に公開

通常の個人ナレッジベースは、コンパイルが完了すると会社に提出でき、チームが権限に応じて使用できるようになります。インポートした読み取り専用スナップショットは、この公開フローに対応していません。

1. 個人ナレッジベースのカードで「会社へ提出」を選択します。
2. 会社ナレッジベース名と申請理由を入力します。名前は30文字以内、理由は80文字以内です。
3. 提出後は承認を待ちます。承認された後も、会社コピーの公開を完了する必要があります。「公開中」「公開済み」「公開失敗」などのステータスに注意し、承認されたことをそのまま公開完了とみなさないでください。
4. 公開に成功したら、会社ナレッジベースを開いて内容とアクセス権限を確認してから、チームでの共同作業に使用します。

公開では、承認時にコピーされた最新の内容が基準となり、独立した会社ナレッジベースが作成されます。個人ナレッジベースがそのまま会社ナレッジベースに変わるわけではなく、その後に個人ナレッジベースを変更しても、会社コピーには自動では同期されません。元の個人ナレッジベースの所有者が会社コピーの所有者に自動的になるとも限らず、会社コピーは引き続き会社リソースの管理とメンバー権限のルールに従って管理されます。

6. 資料の更新、バージョンの復元、よくある質問

6.1 ソースの更新と影響の確認

1. 「ソースファイル」で更新する具体的なソースの行を見つけ、「ファイルを置換」または「ZIP を置換」を選択します。通常のファイルの置換は、形式を元のソースと同じにする必要があります。通常のファイルを ZIP で置き換えることはできません。
2. 新しいファイルを選択し、「影響をプレビュー」をクリックして、追加、変更、削除、変更なしのファイルと、未公開の差分を確認します。
3. 問題がなければ現在の下書きに書き込み、増分コンパイルまたは全量コンパイルを実行して、公開結果を確認します。

ZIP の置換では現在のファイルツリーが丸ごと置き換わります：新しいパッケージに含まれていないファイルは削除されます。まだ公開していない手動で追加したファイルも対象です。ソースの変更や復元は現在の下書きにのみ影響し、公開済みのナレッジがすぐに変わることはありません。ソースの削除も、コンパイルして公開しないと新しいナレッジの結果に反映されません。

URL ソースに編集の入口が表示されている場合は、リンク、表示名、および該当する解析の説明を変更できます。コンパイル済みまたはコンパイル中のソースには、この入口は表示されません。オンライン資料とアクセス権限を定期的に確認し、資料が変わったら再コンパイルしてください。「元の Web ページが更新された」ことを「ナレッジベースが新しい内容を公開した」ことと混同しないでください。操作ガイドのプレビューが期限切れになった場合は、ソースを更新してから再度プレビューします。送信結果がはっきりしない場合は、まずステータスを確認し、むやみに再試行しないでください。

6.2 バージョンの確認と復元方法の選択

通常の個人ナレッジベース・会社ナレッジベースでは、「バージョン履歴」で公開に成功したバージョンを確認し、ソースの変化を比較できます。最初のコンパイルに成功すると最初のバージョンが作成されます。システムナレッジベースと読み取り専用スナップショットには、このバージョン操作はありません。過去のソースの閲覧と復元も引き続きロールの権限で制御されます。未公開の途中の下書きは、完全な履歴バックアップではありません。

特定のソースのみを復元：「最新の公開済みバージョンを復元」を使うか、成功したバージョンから復元可能なファイルソースやディレクトリソースを選択できます。まず影響を確認してから、現在の下書きとしての復元を確定します。復元後に自動ではコンパイルされません。現在のソースが引き続き存在し、タイプに互換性がある必要があります。URL ソースは、このソース単位の復元に対応していません。

ナレッジベース全体をロールバック：ソースのメンテナンスとコンパイルの権限がある場合は、バージョン履歴で「このバージョンに戻す」を選択し、影響を確認して確定します。ロールバックでは、対象バージョンの Wiki、コンパイル規則、ソース一式を使って新しいバージョンとして公開します。以降の履歴が削除されるわけではありません。

ナレッジベース全体をロールバックすると、対象バージョンに含まれるソースの現在の内容と未公開の変更は上書きされます。対象バージョンに含まれず、過去にコンパイルに成功したソースは削除済みとしてマークされます。一度もコンパイルに成功していない追加ソースは保持されます。実行前にこれらの影響を確認し、タスクの完了を待ってください。管理者による確認が必要と表示された場合は、ロールバックを重複して実行しないでください。

6.3 よくある質問

特定のナレッジベースが見つからない、または使用できないのはなぜですか？まず、アカウントにアクセス権があるか、ナレッジベースに利用可能な公開済みの内容があるかを確認し、次に Agent やスペースの設定を確認してください。業務範囲の関連付け、ワークスペースへの参加、ナレッジベースのリンクの受け取りは、いずれも権限の付与と同じではありません。

資料をアップロードまたは変更したのに、回答が古い内容のままなのはなぜですか？ソースの下書きや正式ルールを更新しただけになっていないか、コンパイルが正常に公開されたかを確認してください。更新失敗、一部公開済み、旧版を再利用したページがある場合は、タスクが終了したかどうかだけでなく、ソースの原因と公開結果を確認する必要があります。

ソースファイル、ルール、コンパイルのボタンがないのはなぜですか？メンバーのロールと、システムナレッジベースや読み取り専用スナップショットではないかを確認してください。権限があるのに操作が一時的に使用できない場合は、コンパイル、ルールの生成、承認・公開、確認待ちのステータスを確認してください。

コンパイルに失敗した場合はどうすればよいですか？エラー詳細を確認し、まずソースを読み取れるか、権限付与が有効か、ルールが検証に合格しているかを調べてから、失敗したソースを処理して再コンパイルします。「コンパイル使用量」でモデルの消費量を確認してください。結果が確認待ちの場合は、管理者に連絡して確認してから操作してください。