CSVから記事をインポートする
CSVファイルをアップロードして、質問と回答(Q&A)形式の記事をまとめて作成します。オフラインで用意したFAQやスプレッドシートの移行に向いています。
このページで分かること
- インポートの前提(ナレッジベースの種類・権限)
- 画面からの操作手順
- CSVの列の意味と書式
- 件数・文字数などの制限
- インポート後の記事の状態
インポートの前提
- ナレッジベースの種類が記事(Article)であること。ドキュメントタイプのナレッジベースではインポートできません。
- 対象のナレッジベースで記事を管理できる権限があること(手動で記事を作成できるユーザーと同じです)。
- 1行につきタイトル(質問)と本文(回答)を用意すること。3列目以降は任意です。
画面からインポートする
- 記事を追加したい記事タイプのナレッジベースを開きます。
- 記事一覧付近のインポートから CSV(
.csv)を選択してアップロードします。 - 完了メッセージの行数を確認し、記事一覧で内容を確認します。
ポイント
インポートされた記事は公開(Published)状態になります。下書きの段階はなく、検索・AI機能でもすぐ利用できます。
CSVの形式
列は位置で決まる(ヘッダー名は無視)
1行目はヘッダー行として扱われ、記事にはなりません。2行目以降が1記事ずつ作成されます。
| 列 | 必須 | 記事の項目 | 補足 |
|---|---|---|---|
| 1列目 | 必須 | タイトル(質問) | 空欄不可 |
| 2列目 | 必須 | 本文(回答) | 空欄不可。HTML可 |
| 3列目 | 任意 | キーワード | セル内で改行すると複数キーワード |
| 4列目以降 | — | (無視) | 取り込まれません |
記載例
question,answer,keyphrase
"返品ポリシーを教えてください","ご注文から30日以内であれば返品できます。","返品
返金"
"パスワードを忘れました","ログイン画面の「パスワードを忘れた方」から再設定できます。","パスワード"
question などのヘッダー文字列は人間用のラベルです。列の順番だけがシステムに効きます。
キーワード(3列目)の書き方
- 不要な行は空欄にできます。
- 複数キーワードは同じセル内で改行します。カンマやスペースでは分割されません。
ファイルと文字数の制限
| 項目 | 上限 |
|---|---|
| データ行数(ヘッダー除く) | 1,000行 |
| ファイルサイズ | 200 MB |
| タイトル | 255文字 |
| 本文(HTMLを除いた表示テキスト) | 5,000文字 |
| 文字コード | UTF-8、Shift JIS、CP932(UTF-16は不可) |
インポート後の動き
- 1行 → 1記事(バージョン1)が新規作成されます。
- ステータスは公開です。手動作成で省略した場合の「下書き」とは異なります。
- 検索インデックスへの反映もインポート処理に含まれます。
- 重複チェックはありません。同じCSVを2回読み込むと、同内容の記事が2セットできます。
- 完了画面では行数のみ表示され、記事IDは返りません。一覧から確認してください。
よくあるエラー
| メッセージ・症状 | 対処 |
|---|---|
| ナレッジベースが記事タイプではない | 記事タイプのナレッジベースを選び直す |
| 列が足りない | タイトル列・本文列の2列以上を用意する |
| 特定行のデータ不足 | その行の1・2列目を埋める |
| タイトル/本文が長すぎる | 制限文字数以内に短くする |
| 行数が多すぎる | 1,000行以下に分割して複数回インポート |
| 文字コードエラー | UTF-8またはShift JISで再保存 |
関連
- 検索の仕組み — インポート直後の検索・Ask への反映