# 運用Runbook自動生成 — 運用ガイド

## 基本情報

| 項目 | 内容 |
|------|------|
| 業種 | クラウドサービス |
| ユースケース | 運用Runbook自動生成 |
| WFパターン | `` |
| RAG | あり |
| 検証結果 | E2E pass |
| デモURL例 | http://localhost/workflow/KRHDYWpe3YWbyF97 |

## 概要

出力は空やエラーではなく具体的なテキストが含まれており（合格基準1）、IAM ポリシー簡易レビューというユースケースに直接関連した指摘と分析を行っています（合格基準2）。顧客デモ用として十分な詳細度（危険な許可の列挙、具体的な Sids/ARN/バケット名/ロール名の記載、対処手順、例示ポリシー）があり最低限の品質を満たしています（合格基準3）。入力クエリ固有の要素として AdminRole、ar

## デモ手順

1. DDF Web UI (`/dashboard`) を開く
2. 「運用Runbook自動生成」の「デモ生成」ボタンをクリック
3. 業種「クラウドサービス」、UC「運用Runbook自動生成」が自動入力される
4. 「デモ生成開始」をクリック
5. 生成完了後、デモURLを顧客に共有

## ナレッジベース（RAG）

このワークフローにはナレッジベースが必要です。

### 同梱ドキュメント

バンドル内の `knowledge/` フォルダに以下のテキストファイルが保存されています:

- `Runbook: Webアプリが外部から接続できない（DNS_ロードバランサー）.txt`
- `Runbook: APIレスポンスが遅い_タイムアウト発生（アプリ層_DB）.txt`
- `Runbook: オブジェクトストレージへの書き込みが失敗する（S3互換_ブロックストレージ）.txt`

### デプロイ手順

1. Dify管理画面 → ナレッジ → 新規作成
2. 上記テキストファイルをアップロード
3. インデキシング完了を待つ
4. WFのKRノードで作成したナレッジベースを選択

またはDDFパイプラインで自動セットアップ:
```
run_pipeline(knowledge_docs=[...])  # 自動でKB作成+ID注入
```

**顧客デモ時は、顧客の実ドキュメントに差し替えるとインパクトが大きくなります。**


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

- 「これは自動生成されたプロトタイプです。本番利用には追加の設計・開発が必要です」
- 「御社の実データ/ドキュメントを使えば、さらに精度の高いデモをお見せできます」
- 「Self-hostedなので、御社のデータは外部に出ません」

## AI品質評価コメント

出力は空やエラーではなく詳細なテキストを返しており（基準1）、Cloud Run（orders-service）やCloud SQL/Postgres、特定の API (/api/v1/orders)、デプロイ v3.2.1、ログ中のエラーメッセージ（"could not obtain connection from pool", "context deadline exceeded"）など、ユースケース固有の要素に具体的に言及しています（基準2・4）。切り分け手順、期待される観測結果、具体的な gcloud コマンド、優先度付き初動対応、復旧・ロールバック手順、検証基準、恒久対策まで網羅されており、顧客デモとして見せられる実務レベルの品質が確保されています（基準3）。出力は単なるテンプレートではなく、入力の症状と時間・構成に応じた具体的対処が含まれているため、汎用テンプレートのみで構成されていない点も満たします（基準5）。

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

1. 顧客の実データでカスタマイズデモ（POC: 5-10万円）
2. 本番環境設計・構築（受託開発）
3. 既存システム（kintone/Salesforce等）とのAPI連携
4. 運用保守サポート