PDFや資料ファイルを取り込む

Webページに載せていないマニュアル、規約、サービス資料などは、ファイルとしてナレッジへ登録できます。複数ファイルを一つのナレッジにまとめることもできます。URLで公開している資料は、URLから取得して定期的に最新の内容へ更新できます。

更新日:2026年10月4日

1. ファイルナレッジを作成する

  1. ナレッジを開き、ファイルをアップロードを選びます。
  2. ファイルタブで、PDF、Markdown、TXT、DOCXから登録するファイルを選びます。
  3. ナレッジ名を確認します。最初に選んだファイル名が候補になりますが、内容が分かる名前へ変更できます。
  4. 取り込みを開始を選び、アップロードが終わるまで画面を閉じずに待ちます。
ファイルを選択するナレッジ追加画面
対応形式のファイルを選び、ナレッジ名を確認して取り込みを開始します。

2. URLからファイルを取得する

Webサイトやファイルサーバーに置いている資料は、ファイルのURLを登録すると、Kotaelが取得して取り込みます。設定した頻度でファイルを確認し、内容が変わったファイルだけ取り込み直します。

  1. ナレッジを開き、ファイルをアップロードを選びます。
  2. ファイルタブの取り込み方法でURLから取得を選びます。
  3. ファイルのURLに、PDF、Markdown、TXT、DOCXを直接ダウンロードできるURLを入力し、追加を選びます。1つのナレッジに最大10件まで登録できます。追加したURLは、その場でファイル名・形式・サイズを確認します。
  4. 詳細設定で同期頻度を手動のみ・毎日・毎週から選びます。認証が必要なURLは認証を設定します。
  5. 取り込みを開始を選びます。すべてのURLを確認できると、最初の取り込みが始まります。

認証は、Basic認証、Bearerトークン、カスタムヘッダー(例:X-API-Key)、クエリパラメーター(例:api_key)から選べます。認証情報は暗号化して保存され、画面には下4桁だけが表示されます。認証を設定する場合は、すべてのURLを同じ接続先(https://で始まる同じホスト)にしてください。認証情報は、その接続先にだけ送られます。APIキーなどの秘密情報は、URLに含めず認証で設定してください。

ナレッジ詳細では、取得元・同期頻度・最終同期・次回同期・認証を確認できます。同期頻度が手動のみの場合は、今すぐ同期でその場で取り込めます(5分に1回まで)。URLの追加と削除はファイル管理から、認証の変更は認証情報を再設定から行います。

取得できなかった場合も、前回までに取り込んだ内容はそのまま回答に使われます。ファイルの内容が変わると、そのファイルから作られたチャンクは新しい内容に置き換わります。チャンクを直接編集していた場合は、元の資料も更新してください。

3. ファイルを分ける位置を指定する

ファイルの内容は通常、見出しや段落などをもとに、回答で使いやすい単位(チャンク)へ自動で分割されます。FAQごとに分けたい場合などは、アップロード画面の詳細設定 → チャンクの区切り行(任意)へ、40文字以内の文字列を入力します。

たとえば---を指定すると、その文字列だけが書かれた行で分割します。行の前後の空白は無視します。文中の---では分割しません。区切り行がない場合は通常の方法で分割し、長すぎる内容はさらに自動で分割します。

対象はTXT・Markdown・DOCXです。PDFには区切り行が適用されません。5MB以下のTXT・Markdownは取り込み前に分割結果の目安を確認でき、DOCXや大きいファイルは取り込み後にチャンクで確認します。

既存ナレッジのファイルを追加でも設定できます。区切り行は今回追加するファイルにのみ適用され、登録済みのほかのファイルは変わりません。

4. 他サービスのエクスポートファイルから取り込む

Notion、NotePM、DocBase、Kibela、esa.ioで書き出したZIPファイルを、そのままナレッジへ取り込めます。

  1. ナレッジ画面で、ファイルをアップロードのメニューからインポートを選びます。
  2. インポート元サービスを選び、そのサービスで書き出したZIPファイルを選びます。上記以外のサービスでも、Markdownファイルを含むZIPであればその他(Markdown ZIP)で取り込めます。
  3. インポートを開始を選びます。ZIP内のページごとにナレッジが作成されます。

ページのタイトルは、記事の見出しやファイル名から自動で決まります。取り込み状況は取り込み履歴で確認できます。

5. API連携で自動的に同期する

NotePM、DocBase、Kibela、esa.ioでは、アクセストークンを登録すると、Kotaelが定期的に差分を取り込み、ナレッジを自動で最新の状態に保ちます。

  1. ナレッジ画面で、ファイルをアップロードのメニューからインポートを選びます。
  2. インポート元サービスを選び、取り込み方法でAPI連携を選びます。
  3. チーム名(サービスによってはチームドメイン)とアクセストークンを入力し、同期頻度を手動のみ・毎日・毎週から選びます。
  4. 接続して同期を開始を選びます。接続を確認できると設定が保存され、最初の同期が始まります。

ナレッジ詳細では、接続先・最終同期・次回同期を確認できます。同期頻度が手動のみの場合は、今すぐ同期でその場で取り込めます。連携先のサービスで削除されたページは、次の同期でナレッジからも削除されます。

アクセストークンは暗号化して保存され、画面には下4桁だけが表示されます。トークンを変更したいときはトークンを再設定を使ってください。

6. 取り込み完了を確認する

アップロード後は、文字の抽出、回答に使う単位への分割、検索準備が行われます。ナレッジ詳細の取り込み履歴を開き、状態が完了になるまで待ちます。

ファイル一覧には、アップロード日時、再取り込み日時、取り込み待ち・失敗の状態、準備されたチャンク数が表示されます。ファイル名または本文の一部で検索して、目的の内容が含まれているか確認できます。

7. 一部失敗したファイルを確認する

複数ファイルやインポートZIPの取り込みで一部だけ処理できなかった場合、履歴は一部失敗になります。取り込みできたファイルやページはそのまま利用できます。

履歴を開き、失敗したすべてのファイル名またはページ名と理由を確認してください。対応形式、ファイルサイズ、パスワード保護、文字抽出の可否を見直し、問題のある項目だけを修正して追加または再取り込みします。

8. ファイルを追加・差し替えする

既存のファイルナレッジを開き、ファイルを追加からファイルを追加できます。同じ名前のファイルを選ぶと上書きと表示され、既存ファイルを置き換えて再取り込みします。

内容を更新するときは、同じファイル名で差し替えると管理しやすくなります。別名で追加する場合は、古い版が残って回答内容が競合しないよう注意してください。

9. 取り込まれた内容を確認する

ファイル一覧のチャンクを選ぶと、そのファイルから回答用に分けられた内容を確認できます。権限があるユーザーは、各チャンクの本文を編集または削除できます。

まずはこのナレッジで回答するで質問を試し、意図した箇所が出典として使われるかを確認してください。