汎用 AI の問題点
汎用 AI モデルは AWS のベストプラクティスを知っています — しかし、あなたの AWS 環境については知りません。会社のポリシーで、すべての S3 バケットに特定のキー ARN を持つ SSE-KMS が必要であることを知りません。ディザスタリカバリの RTO が AWS 推奨の 1 時間ではなく 4 時間であることを知りません。インシデント対応手順で、修復アクションの前に Opsgenie アラートが義務付けられていることを知りません。 その結果:会社のポリシーと矛盾し、既存のドキュメントと相反し、ベテランエンジニアなら誰もが知っている会社固有のコンテキストを見落とした汎用的な AI 推奨事項が生まれます。 ナレッジベースはこれを解決します。 ランブック、ポリシー、コンプライアンスドキュメント、アーキテクチャドキュメントを接続することで、CloudThinker エージェントは汎用的なクラウドベストプラクティスだけでなく、組織の制度的知識に基づいて動作します。汎用 RAG との比較
| アプローチ | 汎用 AI | CloudThinker ナレッジベース |
|---|---|---|
| 会社ポリシー | 不明 | インデックス化され、関連するすべての応答で参照される |
| カスタムランブック | 利用不可 | 関連する場合に自動的に取得される |
| アーキテクチャコンテキスト | 汎用ベストプラクティス | 特定の設計決定と制約 |
| コンプライアンス要件 | 標準フレームワーク | 特定の監査要件と証跡フォーマット |
| インシデント手順 | 汎用ステップ | 会社固有のエスカレーションパスとツール |
| ソースタイプ | 機能 |
|---|---|
| ドキュメントアップロード | PDF、Word ドキュメント、テキストファイルを追加してナレッジリポジトリを作成する |
| Web クローリング | Web サイト、Wiki、ドキュメントサイトを自動的にインデックス化する |
クイックセットアップ
ドキュメントアップロード
対応ファイル
- テキスト: TXT、Markdown、RTF
- Office: Word(.docx)、PowerPoint(.pptx)、Excel(.xlsx)
- PDF: Adobe PDF ファイル
- Web: HTML、XML、JSON
アップロード方法
- ファイルを一つずつアップロード
- 複数ファイルをまとめてアップロード
- 「Upload Document」 をクリックする
- ファイルを選択する(最大 50MB)
- タイトルとタグを追加する
- 「Upload」 をクリックする
Web クローリング
基本セットアップ
よくある例
- ドキュメントサイト(GitBook、Confluence)
- 社内 Wiki
- ヘルプセンターと FAQ
- GitHub リポジトリ
ナレッジベースの使用
アクセスモード
| モード | 動作 |
|---|---|
| Always Available(自動) | エージェントがすべての会話でこのナレッジを自動的に使用する |
| Manual Search(オンデマンド) | #kb コマンドで明示的に指定した場合のみエージェントが使用する |
エージェントコマンド
エージェント例
- Alex - クラウドエンジニア
- Oliver - セキュリティエンジニア
- Tony - データベースエンジニア
ナレッジタイプ:
- AWS ドキュメントとガイド
- コスト最適化プレイブック
- インフラ手順
ベストプラクティス
コンテンツの整理
ドキュメント構造(検索しやすくする):- 明確な見出しを使用する(H1、H2、H3)
- 目次を含める
- 関連キーワードを追加する
- 箇条書きとリストを使用する
- 一貫したタグ名を使用する
- 機能タグを含める(security、database、aws)
- 優先度レベルを追加する(critical、reference)
- 部門・チームタグを含める
メンテナンスのヒント
- 月次でコンテンツを確認・更新する
- 古くなったドキュメントを削除する
- 最も使用されるコンテンツを監視する
- 定期的に検索機能をテストする
クイック例
例 1: 会社の手順
例 2: 技術ドキュメント
例 3: セキュリティポリシー
導入チェックリスト
最初のナレッジベースを作成する
- CloudThinker でナレッジベースを作成する
- 重要なドキュメント 3〜5 件をアップロードするか、Web クローリングをセットアップする
- 適切なタグと説明を追加する
- 検索機能をテストする
エージェントを設定する
- 各エージェントのナレッジベースアクセスを設定する
-
#kbコマンドで手動検索をテストする - 重要なナレッジに「Always Available」を設定する
- チームに使用コマンドをトレーニングする
トラブルシューティング
エージェントが情報を見つけられない
エージェントが情報を見つけられない
解決策:
- エージェントがナレッジベースへのアクセス権を持っているか確認する
- ナレッジベースが「Always Available」に設定されているか、
#kbコマンドを使用しているか確認する - ドキュメントのタイトルを改善してキーワードを追加する
- 異なる検索語でテストする
ドキュメントをアップロードできない
ドキュメントをアップロードできない
解決策:
- ファイルサイズを確認する(ファイルあたり最大 50MB)
- ファイルタイプがサポートされているか確認する
- ドキュメントがパスワード保護されていないか確認する
- ファイルを一つずつアップロードしてみる
Web クローリングが機能しない
Web クローリングが機能しない
解決策:
- Web サイトの URL がアクセス可能か確認する
- Web サイトがクローラーをブロックしていないか確認する(robots.txt)
- より少ないページ数制限から始める
- まず単一ページのクローリングを試す
次のステップ
成功のヒント:
- 最も重要なドキュメントから小さく始める
- すべてに明確でわかりやすい名前をつける
- 本番稼働前に検索機能をテストする
#kbコマンドの構文をチームにトレーニングする
🚀 ナレッジベースを作成する
今すぐ始める最初のナレッジベースを作成してコンテンツのアップロードを開始する
🤖 エージェントを設定する
AI エージェントをセットアップするナレッジベースを効果的に活用するようエージェントを設定する