客服小薪 セッションログ Skill
客服小薪のセッションログをクエリ・エクスポートし、人手によるレビューテーブルまたはナレッジヒット明細テーブルに処理します。3つのフローは独立して、または連結して実行できます:クエリエクスポート(データソース)→ 人手レビューテーブル / ナレッジヒット明細テーブル(エクスポートされたセッションログに基づく)。
トリガーシナリオ
- 「XからYまでの客服小薪セッションログをクエリ/エクスポート」
- 「XからYまでの客服小薪人手レビューテーブルを生成」(自動的に先にセッションログをクエリエクスポート)
- 「XからYまでの客服小薪ナレッジヒット明細を生成」(自動的に先にセッションログをクエリエクスポート)
日付形式は YYYY-MM-DD。--end はその日終日を含みます。
前提依存関係
python3+pandas+openpyxl+pymysql。不足時はpip3 install pandas openpyxl pymysql(国内ミラーを優先)。- 環境変数
DMS_HOST/DMS_PORT(デフォルト 3306)/DMS_DB/DMS_ACCESS_ID/DMS_ACCESS_SECRET(~/.zshenvに設定し、新しいターミナルを開いて有効化)。 - DMS は内部ネットワークアドレスであり、会社のVPN接続が必要です。
実行フロー
3つのスクリプトはデフォルトで実行ディレクトリ(cwd)に出力します。{SKILL_DIR} = ~/.codex/skills/customer-service-records/scripts。
1. セッションログのクエリエクスポート
python3 {SKILL_DIR}/dms_query.py --start 2026-07-03 --end 2026-07-04
# 1日分と同等:--date 2026-07-03
- DMS に接続し、固定SQLを実行してxlsxにエクスポート
- 出力:
客服小薪-セッションログ_<開始>~<終了>.xlsx - SQLは内蔵固定テンプレートであり、
--start/--end/--dateによる時間範囲の変更のみ許可され、SELECT/JOIN/CASEなどの他の部分は変更不可 - 自動バッチ処理:DMSセキュリティアクセスプロキシは単一クエリの結果セットを3000行に制限します。スクリプトは最初にCOUNTで総行数をカウントし、閾値(2900行)を超える場合は自動的に日単位で複数バッチに分割してクエリし、マージ後に行数整合性チェックを行います。呼び出し側はバッチロジックを気にする必要はありません。出力は常に単一の完全なxlsxです。
2. 人手レビューテーブルの生成
先にフロー1を実行してセッションログxlsxを取得し、次に:
python3 {SKILL_DIR}/custom_service_data_transfer.py "<セッションログxlsxパス>" --start 2026-07-03 --end 2026-07-04
- 「関連知識」を複数行に分割し、新しい列を追加:人手処理の必要性、知識内容、知識スコア、知識ソース
- 人手処理が必要な行のみを保持(低評価 / 関連知識なし / 知識が回答を要約するには不十分、または正常回答で知識関連性 > 0.25)
- 出力:
客服小薪-人手レビュー_<開始>~<終了>.xlsx
3. ナレッジヒット明細テーブルの生成
先にフロー1を実行してセッションログxlsxを取得し、次に:
python3 {SKILL_DIR}/process_to_knowledge_detail.py "<セッションログxlsxパス>" --start 2026-07-03 --end 2026-07-04
- 「関連知識」を複数行に分割し、新しい列を追加:知識、知識ID、知識ソース、知識スコア、知識-質問、知識-回答
- すべての行を保持(フィルタリングなし)
- 出力:
客服小薪-ナレッジヒット明細_<開始>~<終了>.xlsx
ファイル命名形式
客服小薪-{セッションログ|人手レビュー|ナレッジヒット明細}_<開始>~<終了>.xlsx、日付は YYYY-MM-DD、開始と終了は ~ で接続。
半角の
/はパス区切り文字であり、ファイル名に使用できないため、日付は-で区切り、開始と終了は~で接続します。
SQLについて
dms_query.py には固定SQLテンプレートが内蔵されており、aim.custom_service_chat を LEFT JOIN company.company して客服小薪のQ&A明細をクエリします。時間範囲のみ変更可能(コマンドライン引数を介して)、その他の部分は変更できません。SQLの詳細はスクリプト内の SQL_TEMPLATE を参照してください。
また、スクリプトには COUNT_SQL(SQL_TEMPLATE と同じWHERE条件を使用)が内蔵されており、エクスポート前に総行数をカウントしてバッチ処理の必要性を判断します。このCOUNTクエリはJOINを含まず、custom_service_chat テーブルの行数のみをカウントします。
DMS 3000行制限
DMSセキュリティアクセスプロキシは単一クエリの結果セットに3000行の上限があります。dms_query.py は以下の戦略でデータの完全性を確保します:
- 最初にCOUNTクエリで対象時間範囲内の総行数を統計
- 総行数 <= 2900(100行の余裕を残す)の場合、単一クエリでエクスポート
- 総行数 > 2900の場合、日単位で分割、特定の日がまだ上限を超える場合は6時間 → 1時間の単位で段階的に分割
- 各バッチのクエリ結果をマージした後、COUNT結果と行数一致性チェックを実行
完了後
生成されたファイル名と絶対パスを報告します。