Communitygithub.com

客服小薪会话记录查询导出与审查处理 Skill

查询导出客服小薪会话记录,生成人工审查表或知识命中明细表。

客服小薪会话记录查询导出与审查处理 Skill とは?

このスキル(Codex Skill)は、`客服小薪`(カスタマーサービスチャットボット)のセッションログをDMSデータベースからクエリ・エクスポートし、その後、人手によるレビュー用テーブルまたはナレッジヒット明細テーブルを生成するためのものです。クエリエクスポート → レビューテーブル生成、クエリエクスポート → ナレッジヒット明細生成の2つのワークフローを独立して、または連続して実行できます。このスキルは特に、カスタマーサービス品質管理やナレッジベースの有効性分析の自動化を目的としており、Claude CodeやCursorなどのAIエージェントと統合して使用されます。Pythonスクリプトを使用し、`pandas`、`openpyxl`、`pymysql`に依存しています。DMSのセキュリティプロキシによる3000行の結果セット制限を自動的に処理し、データの完全性を保証します。ユーザーは開始日と終了日を指定するだけで、すべての処理が自動化されます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add AngChow/customer-service-records

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

客服小薪 セッションログ 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 は以下の戦略でデータの完全性を確保します:

  1. 最初にCOUNTクエリで対象時間範囲内の総行数を統計
  2. 総行数 <= 2900(100行の余裕を残す)の場合、単一クエリでエクスポート
  3. 総行数 > 2900の場合、日単位で分割、特定の日がまだ上限を超える場合は6時間 → 1時間の単位で段階的に分割
  4. 各バッチのクエリ結果をマージした後、COUNT結果と行数一致性チェックを実行

完了後

生成されたファイル名と絶対パスを報告します。

関連スキル