メインコンテンツへスキップ
ドキュメントのアップロードや Web サイトのクローリングを通じて、AI エージェントに組織の知識へのアクセスを提供します。エージェントはこの情報を参照して、より優れたコンテキストに沿った応答を提供できます。

汎用 AI の問題点

汎用 AI モデルは AWS のベストプラクティスを知っています — しかし、あなたの AWS 環境については知りません。会社のポリシーで、すべての S3 バケットに特定のキー ARN を持つ SSE-KMS が必要であることを知りません。ディザスタリカバリの RTO が AWS 推奨の 1 時間ではなく 4 時間であることを知りません。インシデント対応手順で、修復アクションの前に Opsgenie アラートが義務付けられていることを知りません。 その結果:会社のポリシーと矛盾し、既存のドキュメントと相反し、ベテランエンジニアなら誰もが知っている会社固有のコンテキストを見落とした汎用的な AI 推奨事項が生まれます。 ナレッジベースはこれを解決します。 ランブック、ポリシー、コンプライアンスドキュメント、アーキテクチャドキュメントを接続することで、CloudThinker エージェントは汎用的なクラウドベストプラクティスだけでなく、組織の制度的知識に基づいて動作します。

汎用 RAG との比較

アプローチ汎用 AICloudThinker ナレッジベース
会社ポリシー不明インデックス化され、関連するすべての応答で参照される
カスタムランブック利用不可関連する場合に自動的に取得される
アーキテクチャコンテキスト汎用ベストプラクティス特定の設計決定と制約
コンプライアンス要件標準フレームワーク特定の監査要件と証跡フォーマット
インシデント手順汎用ステップ会社固有のエスカレーションパスとツール
ソースタイプ機能
ドキュメントアップロードPDF、Word ドキュメント、テキストファイルを追加してナレッジリポジトリを作成する
Web クローリングWeb サイト、Wiki、ドキュメントサイトを自動的にインデックス化する

クイックセットアップ

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

アップロード方法

  1. 「Upload Document」 をクリックする
  2. ファイルを選択する(最大 50MB)
  3. タイトルとタグを追加する
  4. 「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 リポジトリ

ナレッジベースの使用

アクセスモード

モード動作
Always Available(自動)エージェントがすべての会話でこのナレッジを自動的に使用する
Manual Search(オンデマンド)#kb コマンドで明示的に指定した場合のみエージェントが使用する

エージェントコマンド

# 任意のナレッジベースを検索する
@alex #kb find AWS cost optimization strategies

# 特定のナレッジベースを検索する
@tony #kb:database-guide PostgreSQL backup procedures

# エージェントがナレッジを使用するタイミングを決定する(Always モード)
@oliver analyze this security incident
# Oliver はセキュリティ手順を自動的に参照する

エージェント例

ナレッジタイプ:
  • AWS ドキュメントとガイド
  • コスト最適化プレイブック
  • インフラ手順
例:
@alex #kb find EC2 cost savings
→ アップロードされたコスト最適化ガイドを参照
→ 具体的な推奨事項を提供

ベストプラクティス

コンテンツの整理

ドキュメント構造(検索しやすくする):
  • 明確な見出しを使用する(H1、H2、H3)
  • 目次を含める
  • 関連キーワードを追加する
  • 箇条書きとリストを使用する
タグ付け(スマートな整理):
  • 一貫したタグ名を使用する
  • 機能タグを含める(security、database、aws)
  • 優先度レベルを追加する(critical、reference)
  • 部門・チームタグを含める

メンテナンスのヒント

  • 月次でコンテンツを確認・更新する
  • 古くなったドキュメントを削除する
  • 最も使用されるコンテンツを監視する
  • 定期的に検索機能をテストする

クイック例

例 1: 会社の手順

Name: "Operations Procedures"
Type: Document Upload
Content: 
  - Employee handbook (PDF)
  - IT policies (Word docs)
  - Emergency procedures (PDF)
Access: Always Available
Agents: All agents can reference

例 2: 技術ドキュメント

Name: "AWS Documentation"
Type: Web Crawler
URL: "https://docs.aws.amazon.com/"
Schedule: Weekly updates
Access: Manual (#kb command)
Agents: Alex (primary), others as needed

例 3: セキュリティポリシー

Name: "Security Compliance"
Type: Document Upload
Content:
  - SOC 2 checklist (PDF)
  - Security policies (Multiple PDFs)
  - Incident templates (Word)
Access: Manual (sensitive content)
Agents: Oliver (full access), others (limited)

導入チェックリスト

1

ナレッジを計画する

  • 主要なドキュメントと Web サイトを特定する
  • 命名規則を決定する
  • 各ナレッジベースのアクセスレベルを選択する
2

最初のナレッジベースを作成する

  • CloudThinker でナレッジベースを作成する
  • 重要なドキュメント 3〜5 件をアップロードするか、Web クローリングをセットアップする
  • 適切なタグと説明を追加する
  • 検索機能をテストする
3

エージェントを設定する

  • 各エージェントのナレッジベースアクセスを設定する
  • #kb コマンドで手動検索をテストする
  • 重要なナレッジに「Always Available」を設定する
  • チームに使用コマンドをトレーニングする
4

監視・改善する

  • 最も使用されるコンテンツを確認する
  • 古くなった情報を更新する
  • チームのニーズに基づいて新しいナレッジを追加する
  • フィードバックを収集して最適化する

トラブルシューティング

解決策:
  • エージェントがナレッジベースへのアクセス権を持っているか確認する
  • ナレッジベースが「Always Available」に設定されているか、#kb コマンドを使用しているか確認する
  • ドキュメントのタイトルを改善してキーワードを追加する
  • 異なる検索語でテストする
解決策:
  • ファイルサイズを確認する(ファイルあたり最大 50MB)
  • ファイルタイプがサポートされているか確認する
  • ドキュメントがパスワード保護されていないか確認する
  • ファイルを一つずつアップロードしてみる
解決策:
  • Web サイトの URL がアクセス可能か確認する
  • Web サイトがクローラーをブロックしていないか確認する(robots.txt)
  • より少ないページ数制限から始める
  • まず単一ページのクローリングを試す

次のステップ

成功のヒント:
  • 最も重要なドキュメントから小さく始める
  • すべてに明確でわかりやすい名前をつける
  • 本番稼働前に検索機能をテストする
  • #kb コマンドの構文をチームにトレーニングする

🚀 ナレッジベースを作成する

今すぐ始める最初のナレッジベースを作成してコンテンツのアップロードを開始する

🤖 エージェントを設定する

AI エージェントをセットアップするナレッジベースを効果的に活用するようエージェントを設定する