社内FAQ chatbotの作り方
Slack×Claude API実践ガイド

# ナレッジベースのディレクトリ構成

knowledge/
├── 総務/
│   ├── 経費精算.md
│   ├── 有給申請.md
│   ├── 出張申請.md
│   └── 備品購入.md
├── IT/
│   ├── PC初期設定.md
│   ├── VPN接続方法.md
│   ├── Slack使い方.md
│   └── パスワード変更.md
├── 人事/
│   ├── 評価制度.md
│   ├── 福利厚生.md
│   └── 入社手続き.md
└── 営業/
    ├── 見積もり手順.md
    ├── 契約フロー.md
    └── CRM操作方法.md

# knowledge/総務/経費精算.md の例

# 経費精算の方法

## 申請手順
1. freee経費精算にログイン
2. 「経費申請」→「新規作成」
3. 領収書の写真をアップロード
4. 勘定科目を選択（迷ったら「消耗品費」）
5. 上長に承認申請

## 締め日
- 毎月25日締め、翌月10日払い
- 25日を過ぎた分は翌々月になります

## よくある質問
Q. 領収書をなくした場合は？
A. 出金伝票で代用可能。上長の承認が必要。

Q. クレジットカード明細でもOK？
A. 3,000円以下ならOK。それ以上は領収書必須。

// knowledge.js — ナレッジ検索

const fs = require('fs');
const path = require('path');

const KNOWLEDGE_DIR = './knowledge';

/**
 * ナレッジベースからキーワードマッチで関連文書を検索
 */
function searchKnowledge(query) {
  const results = [];
  const files = getAllMarkdownFiles(KNOWLEDGE_DIR);

  for (const filePath of files) {
    const content = fs.readFileSync(filePath, 'utf-8');
    const fileName = path.basename(filePath, '.md');

    // シンプルなキーワードマッチ（本番ではベクトル検索推奨）
    const queryWords = query
      .toLowerCase()
      .split(/\s+/)
      .filter(w => w.length > 1);

    let score = 0;
    for (const word of queryWords) {
      const regex = new RegExp(word, 'gi');
      const matches = content.match(regex);
      if (matches) score += matches.length;
    }

    if (score > 0) {
      results.push({
        fileName,
        filePath: filePath.replace(KNOWLEDGE_DIR + '/', ''),
        content,
        score,
      });
    }
  }

  // スコア順にソートして上位3件
  results.sort((a, b) => b.score - a.score);
  return results.slice(0, 3);
}

function getAllMarkdownFiles(dir) {
  let files = [];
  const items = fs.readdirSync(dir);
  for (const item of items) {
    const fullPath = path.join(dir, item);
    if (fs.statSync(fullPath).isDirectory()) {
      files = files.concat(getAllMarkdownFiles(fullPath));
    } else if (item.endsWith('.md')) {
      files.push(fullPath);
    }
  }
  return files;
}

module.exports = { searchKnowledge };

// ai-answer.js — Claude APIで回答生成

const Anthropic = require('@anthropic-ai/sdk');
const { searchKnowledge } = require('./knowledge');

const anthropic = new Anthropic();

const SYSTEM_PROMPT = `あなたは社内FAQ AIアシスタントです。
社員からの質問に、提供されたナレッジベースの情報をもとに回答します。

ルール:
- ナレッジベースに情報がある場合はそれに基づいて回答
- 情報がない場合は「この件についてはナレッジベースに
  情報がありません。担当部署にお問い合わせください」と回答
- 回答の末尾に出典（参照したドキュメント名）を記載
- 推測や憶測で回答しない
- 簡潔に、でも必要な情報は漏らさず
- Slackのマークダウン形式で返す（*太字*、箇条書き等）`;

async function generateAnswer(question) {
  // ナレッジベースを検索
  const docs = searchKnowledge(question);

  if (docs.length === 0) {
    return {
      answer: 'この件についてはナレッジベースに情報が'
        + 'ありません。\n担当部署にお問い合わせください。',
      sources: [],
    };
  }

  // 関連ドキュメントをコンテキストとして構築
  const context = docs
    .map(d => '--- ' + d.filePath + ' ---\n' + d.content)
    .join('\n\n');

  const response = await anthropic.messages.create({
    model: 'claude-sonnet-4-20250514',
    max_tokens: 500,
    system: SYSTEM_PROMPT,
    messages: [{
      role: 'user',
      content: '【社内ナレッジ】\n' + context
        + '\n\n【質問】\n' + question,
    }],
  });

  return {
    answer: response.content[0].text,
    sources: docs.map(d => d.filePath),
  };
}

module.exports = { generateAnswer };

// server.js — Slack FAQ Bot

const express = require('express');
const crypto = require('crypto');
const { generateAnswer } = require('./ai-answer');
require('dotenv').config();

const app = express();

// Slack署名検証
function verifySlackSignature(req, res, buf) {
  const timestamp = req.headers['x-slack-request-timestamp'];
  const signature = req.headers['x-slack-signature'];

  const sigBase = 'v0:' + timestamp + ':' + buf.toString();
  const mySignature = 'v0=' + crypto
    .createHmac('sha256', process.env.SLACK_SIGNING_SECRET)
    .update(sigBase)
    .digest('hex');

  if (mySignature !== signature) {
    throw new Error('Invalid Slack signature');
  }
}

app.use(express.json({ verify: verifySlackSignature }));

// Slackイベントエンドポイント
app.post('/slack/events', async (req, res) => {
  // URL検証（初回のみ）
  if (req.body.type === 'url_verification') {
    return res.json({ challenge: req.body.challenge });
  }

  // イベント処理
  const event = req.body.event;
  if (!event || event.type !== 'app_mention') {
    return res.status(200).send('ok');
  }

  // 即座に200を返す（3秒ルール）
  res.status(200).send('ok');

  // メンション部分を除去して質問を抽出
  const question = event.text
    .replace(/<@[A-Z0-9]+>/g, '')
    .trim();

  if (!question) {
    await postToSlack(
      event.channel,
      '質問をどうぞ！例: 「経費精算のやり方は？」',
      event.ts
    );
    return;
  }

  // 「考え中...」のリアクション
  await addReaction(event.channel, event.ts, 'hourglass');

  try {
    // AI回答を生成
    const { answer, sources } = await generateAnswer(question);

    // 出典情報を追加
    let response = answer;
    if (sources.length > 0) {
      response += '\n\n'
        + '_📄 参照: ' + sources.join(', ') + '_';
    }

    // Slackに回答を投稿（スレッド返信）
    await postToSlack(event.channel, response, event.ts);
  } catch (error) {
    console.error('Error:', error);
    await postToSlack(
      event.channel,
      'エラーが発生しました。管理者に連絡してください。',
      event.ts
    );
  }

  // リアクション削除
  await removeReaction(event.channel, event.ts, 'hourglass');
  await addReaction(event.channel, event.ts, 'white_check_mark');
});

// Slackメッセージ送信
async function postToSlack(channel, text, threadTs) {
  await fetch('https://slack.com/api/chat.postMessage', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization':
        'Bearer ' + process.env.SLACK_BOT_TOKEN,
    },
    body: JSON.stringify({
      channel,
      text,
      thread_ts: threadTs,  // スレッド返信
    }),
  });
}

// リアクション追加/削除
async function addReaction(channel, ts, emoji) {
  await fetch('https://slack.com/api/reactions.add', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization':
        'Bearer ' + process.env.SLACK_BOT_TOKEN,
    },
    body: JSON.stringify({
      channel, timestamp: ts, name: emoji
    }),
  });
}

async function removeReaction(channel, ts, emoji) {
  await fetch('https://slack.com/api/reactions.remove', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization':
        'Bearer ' + process.env.SLACK_BOT_TOKEN,
    },
    body: JSON.stringify({
      channel, timestamp: ts, name: emoji
    }),
  });
}

app.listen(3000, () => {
  console.log('FAQ Bot running on port 3000');
});