# リース社内ナビゲーション — 運用ガイド

## 基本情報

| 項目 | 内容 |
|------|------|
| 業種 | リース |
| ユースケース | リース社内ナビゲーション (全社員向け) |
| WFパターン (v3.2) | `start(3変数) → [qc1(5カテゴリ判定) ‖ kr1(top_k=8)] → 3並列LLM(チェック‖申請‖参照) → tpl1(Jinja2統合) → end` + UX features |
| RAG | あり (4文書: 社内規定/商品マニュアル/事務手続き/FAQ) |
| 検証結果 | v3.2 E2E pass (2026-05-26, 7,481文字, **5/5 keys hit, 顧客/規程引用 16/16 パーフェクト**, source_refタグ 24個, **98.1s (-23%)**, 22,802tokens, gpt-5-mini) |
| デモURL例 | テスト時自動生成 (cleanup ルールで都度削除) |

## 概要

リース会社の全社員(営業・審査・契約事務など)向けに、社内問い合わせをセルフサービスで解決するエージェント。

社員からの「**この案件では何を確認すべきか**」「**どの申請が必要か**」「**誰に相談すべきか**」といった質問を受け、
社内規定・商品マニュアル・事務手続き・FAQの**4文書を横断検索**して、5セクション構成のガイダンスを返す。

## 既存UCとの差別化

| | 既存「リース顧客問い合わせ対応」 | 本UC「リース社内ナビゲーション」 |
|---|---|---|
| 想定ユーザー | 顧客対応窓口担当 | **全社員(営業・審査・契約事務)** |
| 入力 | 顧客からの問い合わせ | **社員からの問い合わせ + 案件情報 + コンテキスト** |
| 出力 | 顧客向け回答ドラフト | **回答 + チェックリスト + 必要申請 + 参照規定 + エスカレーション助言** |
| ナレッジ | 商品・契約情報中心 | **社内規定 + 商品 + 事務 + FAQ の4軸横断** |
| 期待効果 | 顧客対応時間短縮 | **新人/中堅社員の判断・初動を支援、ベテラン依存を軽減** |

## アーキテクチャ (v3.2 並列構成)

```
start (3変数)
  ├ query        (paragraph, required, max 2048) — 社員からの問い合わせ
  ├ case_info    (paragraph, optional, max 2048) — 案件情報(顧客名/物件/契約/残期間等)
  └ context      (paragraph, optional, max 1024) — 緊急度・部門・関連案件
   │ │
   │ └─────────┐
   ▼            ▼
qc1 (Question Classifier)        kr1 (Knowledge Retrieval)
  5カテゴリ判定                    top_k=8 横断検索 (4文書)
  - 中途解約・差し替え系             - 社内規定_リース契約規程
  - 与信・申込系                    - 商品マニュアル_リーススキーム
  - スキーム選択系                   - 事務手続き_申請フォーマット一覧
  - 法務・コンプラ系                 - FAQ_社員からよくある質問
  - 事務手続き・申請系
   │ │
   ▼ ▼
   3並列 LLM (全て temp=0.3, retry×2)
   ├─ llm_check  (チェックリスト生成, kr1+qc1 を context)
   ├─ llm_action (必要申請生成, kr1 を context)
   └─ llm_source (参照規定+エスカレーション生成, kr1 を context)
       │ │ │
       ▼ ▼ ▼
       tpl1 (template-transform, Jinja2)
       - qc1.class_name → 質問カテゴリ判定
       - start.case_info → 案件サマリ
       - 3並列LLM出力 → 各セクションに統合
        │
        ▼
       end (result: Markdown)

features:
  opening_statement: "こんにちは。リース業務の社内ヘルプデスクです 🧭..."
  suggested_questions: [5項目の社員向け典型質問]
  suggested_questions_after_answer.enabled: true
```

### v3.1 → v3.2 改善メトリクス

| 指標 | v3.1 | v3.2 | 差分 |
|---|---|---|---|
| 時間 | 127.9s | **98.1s** | **-23%** |
| 出力長 | 5,097文字 | 7,481文字 | +47% |
| 期待キー hit | 5/5 | 5/5 | 維持 |
| 顧客/規程引用 | 14/16 | **16/16** | パーフェクト |
| source_refタグ | 28個 | 24個 | -4個 (許容) |

### v3.2 で実装した Dify ベストプラクティス

1. **Question Classifier ノード** — 5カテゴリで質問種別を自動判定、結果を後続LLMにcontext経由で渡す
2. **3並列LLM + template-transform** — 直列二段→3並列で時間-23%、各LLMが専門領域に特化することで品質維持
3. **Jinja2 template-transform** — 静的な統合は LLM ではなく Jinja2 で実行、無駄なトークン消費削減
4. **features.opening_statement** — 営業現場でのオンボーディング体験を向上
5. **features.suggested_questions×5** — 典型質問サジェストで社員の質問ハードルを下げる
6. **features.suggested_questions_after_answer** — 回答後の連続QA促進

### ナレッジベース構成

`knowledge/` 配下4ファイル (top_k=8 で全文書から関連チャンクを引く):

| ファイル | 内容 | 主な利用箇所 |
|---|---|---|
| `社内規定_リース契約規程.txt` | リース契約規程・与信規程・リスク管理規程・法務関連の主要条項 | check_items / required_actions の判断根拠 |
| `商品マニュアル_リーススキーム.txt` | ファイナンス/オペレーティング/残価設定型/再リース/差し替え/PPA等のスキーム比較 | summary_answer.recommended_scheme の選択 |
| `事務手続き_申請フォーマット一覧.txt` | A-201/B-101/B-102/C-301/D-201/E-101/X-901 等の申請フォーム + 承認権限額 | required_actions の form_id / approval_flow |
| `FAQ_社員からよくある質問.txt` | 中途解約・差し替え・与信・スキーム選択・エスカレーション順序の社内Q&A | check_items / escalation_advice |

## デモ手順

1. DDF Web UI (`/dashboard`) を開く
2. 「リース社内ナビゲーション」の「デモ生成」ボタンをクリック
3. 業種「リース」、UC「リース社内ナビゲーション」が自動入力される
4. 「デモ生成開始」をクリック
5. 生成完了後、デモURLを社員向けポータルにリンクすれば即運用可能

## テスト入力例

```
質問: 既存顧客から、リース満了前(残り6ヶ月)に途中で他社へ機器入れ替えしたいと
      相談されました。中途解約になるのか、再リースで延長できるのか、社内的に
      はどう動けばいいですか？営業担当としてまず何を確認・申請すべきか教えて
      ください。

案件情報: 株式会社サンライト工業 (既存取引10年・延滞ゼロ)
         2021年締結・5年ファイナンスリース(マシニングセンタ2台、3,500万円)
         残期間: 6ヶ月、残債: 420万円
         営業担当: 入社2年目の若手、初の中途案件対応

コンテキスト: 緊急度: 中(顧客の意思決定タイムライン3-4週間)
           部門: 法人営業本部 第二営業部
```

## 出力サンプル品質 (v3.1)

E2E pass 出力の主な特徴 (2026-05-26 計測):

- **推奨スキーム**「差し替え契約」を即提示 + 緊急度判定 + 重要ポイント4項目
- **確認チェックリスト 6項目** (高優先4件/中優先2件) — 各項目に「なぜ・どうやって・参考根拠」付き
- **必要申請手続き 6項目** — 表形式(申請名/カテゴリ/フォーム番号/提出先/想定日数) + 各申請の詳細(承認フロー)
- **参照規定 4文書** すべての関連条項を要約付きで明示
- **エスカレーション 5部署** (課長/契約管理部/法務/与信部/法人営業部長) + 各部署の役割明示
- **AIで判断不可な領域** を明示 (最終与信可否/法的解釈/中古市場査定/最終商談)
- **次のアクション 5ステップ** で時系列の動き方を完全ナビゲーション
- **source_ref タグ 28箇所** で `[社内規定:第18条]` `[事務手続き:A-201]` `[FAQ:Q4]` `[案件固有事実]` を引用

## 顧客への説明ポイント

- 「**新人・中堅社員の判断と初動を完全ナビゲート**、ベテラン依存を軽減できます」
- 「**御社固有の社内規定・申請フォーム**を学習させれば、御社のルールに沿ったガイダンスが可能」
- 「**source_ref タグで判断根拠が明示**されるので、社員が安心して動ける + 承認者も検証可能」
- 「Self-hosted なので、御社の規程・FAQ は外部に出ません」

## 受託提案の次ステップ

1. 顧客の実規程・実FAQ・申請フォーム一覧で RAG カスタマイズ (POC: 15-20万円)
2. 過去問い合わせログを KB に追加して FAQ 自動拡充 (継続案件: 月額 5-10万円)
3. Slack/Teams 連携で社内ヘルプデスク BotとしてWeb UI不要に
4. 申請フォーム自動起票連携 (kintone/Microsoft Forms/Salesforce Flow)

## デプロイ上の注意

本UCは v3.1 パターン (multi-var start + source_ref タグ) のため、postprocess の signed multi-var skip 機構
(`src/postprocess/__init__.py:_force_start_query_var`) が必要。本機構は commit `4739ec5` で導入済み。

E2E確認スクリプト: `scripts/test_internal_navigation.py`