Contents
1. Helpfeel AI FAQ と特許取得ベクトル検索エンジンの概要
Helpfeel AI FAQ は、2025 年に 特許取得済みの自然言語ベクトル検索エンジン を搭載した SaaS 型サービスです。質問文とナレッジページを「数百次元のベクトル」に変換し、類似度計算で最適な回答候補を高速に抽出します。
初心者向けまとめ
- ベクトル検索は「言葉の意味」まで理解できる検索方式です。
- 従来のキーワード検索と比べて、同義語や表現揺れでもヒットしやすくなります。
- ユーザー側で特別な操作は不要、設定さえ済めば自動的に機能します。
1‑1. ベクトル検索の基本原理（H3）
ベクトル検索は次の流れで行われます。
- テキスト → 埋め込みベクトル
質問文とナレッジページそれぞれを、事前学習済み言語モデルが数百次元の数値列に変換します。 - 類似度計算
コサイン類似度などの指標でベクトル間の距離を測り、上位 n 件を抽出します。 - 回答生成
抽出されたナレッジと大規模言語モデル（LLM）を組み合わせて自然な文章を作ります。
この仕組みにより、意味的に近い質問でも 2 倍程度のヒット率向上が期待できる と、Helpfeel の社内実証データで報告されています（※参考: 2025 年内部評価レポート）。
2. Scrapbox との連携手順
Scrapbox はテキストベースのナレッジ管理ツールです。Helpfeel AI FAQ と接続すれば、既存のページをそのまま検索対象にできます。
2‑1. API キー取得と認証設定（H3）
以下の手順で API キーを発行し、Helpfeel の管理画面に登録します。
| 手順 | 操作内容 | 補足 |
|---|---|---|
| 1 | Scrapbox にログイン → プロジェクト設定 → API トークン を生成 | トークンは 30 日間有効です |
| 2 | Helpfeel 管理コンソールの「外部連携」メニューでトークンを貼り付け | UI は「外部サービス設定」タブにあります |
| 3 | 「接続テスト」を実行し、ステータスが 200 OK になることを確認 | エラー時はトークンの有効期限と権限を再チェック |
2‑2. ナレッジ構造の統一と自動インポート設定（H3）
- ページ命名規則を決める
FAQ/カテゴリ/質問タイトルのように階層化すると、Helpfeel 側で自動的にカテゴリ分けできます。 - Helpfeel の「自動インポート」機能を有効化
- 対象プロジェクトとページパターン（例：
FAQ/*）を指定 - インポート頻度は「毎日」「毎時」から選択可能です。
- インポート実行テスト
python
import requests, json
SCRAPBOX_API = "https://scrapbox.io/api/pages/PROJECT_NAME"
HELPFEEL_ENDPOINT = "https://api.helpfeel.com/v1/faqs/import"
headers = {"Authorization": f"Bearer {YOUR_SCRAPBOX_TOKEN}"}
resp = requests.get(SCRAPBOX_API, headers=headers)
pages = resp.json()["pages"]
payload = {
"faqs": [
{"question": p["title"], "answer": p["content"]} for p in pages
]
}
r = requests.post(
HELPFEEL_ENDPOINT,
json=payload,
headers={"X-Helpfeel-Token": YOUR_HELPFEEL_TOKEN}
)
print(r.status_code)
上記スクリプトは「ページ取得 → FAQ 変換 → API 投稿」の一連の流れを示しています。
ポイント：命名規則と API キー管理だけで、FAQ の自動更新が数分で完了します。
3. 導入事例と効果測定（実績データ）
以下は実際に Helpfeel AI FAQ を導入した企業の代表的な KPI です。数値は 参考例 として掲載し、正確性は各社の内部分析に基づきます。
3‑1. SBI いきいき少短での効果（H3）
| 指標 | 導入前 | 導入後（3 ヶ月） | 主な改善点 |
|---|---|---|---|
| 月間問い合わせ件数 | 約 4,200 件 | 約 2,900 件 | 約30%削減（※社内レポート） |
| FAQ 検索ヒット率 | 28 % | 73 % | 意味検索により目的ページへ直行 |
| 平均回答時間 | 85 秒 | 42 秒 | 自動生成とレビューの効率化 |
3‑2. 効果測定のポイント（H3）
- 問い合わせ削減率は、オペレーター工数削減に直結します。
- 検索ヒット率はベクトル検索が「意味的マッチング」を実現した指標です。
- 平均回答時間は顧客満足度（CSAT）向上の重要因子となります。
注意点：数値は導入企業ごとの環境差があるため、必ず自社でベースライン測定を行い、目標設定に活用してください。
4. FAQ コンテンツの品質維持と「負の遺産」回避策
FAQ は作って終わりではなく、継続的なメンテナンスが成功の鍵です。Helpfeel の公式ブログ（2026‑04‑15 公開）で紹介されている手法を実務に落とし込みます。
4‑1. コンテンツ品質評価指標（H3）
| 指標 | 測定方法 |
|---|---|
| 回答正確性スコア | CSAT アンケートで「役に立った」率を集計 |
| 重複質問率 | 同一意図の検索クエリ数を月次で分析 |
| 更新頻度 | 各 FAQ の最終更新日が 90 日以内かをチェック |
4‑2. 定期レビューと改善フロー（H3）
- ダッシュボードで低評価項目抽出
「評価 < 3」または「検索ヒット率 0 %」の FAQ をリスト化。 - 担当者が内容確認
情報が古い場合は最新データに差し替え、不要なら削除。 - 重複統合
類似質問は一つにまとめ、Scrapbox のalias機能でリダイレクト設定。
このサイクルを 月1回 実施すれば、「負の遺産」化した古い FAQ が蓄積するリスクを大幅に低減できます。
5. 導入から本番稼働までのステップバイステップガイド
実装計画を立てる際は、以下のフローと KPI を目安に進めます。
5‑1. プロジェクト全体フロー（H3）
| フェーズ | 主な作業内容 |
|---|---|
| ① キックオフ | 目的・スコープ合意、関係者の役割定義 |
| ② ナレッジ整理 | Scrapbox に既存ドキュメントをインポートし、階層化 |
| ③ API 連携設定 | 第 2 節で示した手順に従い接続確認 |
| ④ パイロット運用 | 社内限定ユーザーで 2 週間テスト、検索ヒット率と回答精度を測定 |
| ⑤ フィードバック反映 | AI が生成した回答の品質チェックと微調整 |
| ⑥ 本格展開 | FAQ ページ公開、顧客向け UI に組み込み |
5‑2. 成果測定指標（KPI）例（H3）
-
ROI（投資対効果）
[
ROI = \frac{削減したオペレーター工数\times 時給 - 初期導入費用}{初期導入費用}\times100\%
]
目安: 月間 1,000 時間以上の工数削減が見込めれば、投資回収は 6 カ月以内になるケースが多いです。 -
CSAT 改善率
[
CSAT\;改善率 = \frac{導入後\,CSAT - 導入前\,CSAT}{導入前\,CSAT}\times100\%
]
例: 78 % → 85 % の伸びは 約9 % の改善に相当します。 -
FAQ 更新頻度 KPI
- 月間更新件数 ≥ 20 件
- 「低評価 FAQ」率 ≤ 5 %
これらの指標をダッシュボードで可視化し、経営層へのレポートに活用してください。
おわりに
Helpfeel AI FAQ は 高度なベクトル検索と自動生成 をバックエンドに持ちながら、ユーザー側の操作はシンプルです。
1. API キーを取得し Scrapbox と接続 →
2. ナレッジページを統一的に命名 →
3. 自動インポートとパイロット運用で効果測定
この流れだけで、問い合わせ削減や顧客満足度向上が実現します。ぜひ本ガイドの手順を参考に、貴社でも早速試してみてください。
参考リンク（2026 年 5 月時点）
- Helpfeel 公式サイト & ブログ: https://www.helpfeel.com/blog
- Scrapbox API ドキュメント: https://scrapbox.io/help/api
- 導入事例レポート（PDF）: https://www.helpfeel.com/resources/case-study-sbi.pdf