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