> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ナレッジベース

> ナレッジベースを作成・管理して、組織の知識、ドキュメント、手順で AI エージェントを強化する

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

***

## 汎用 AI の問題点

汎用 AI モデルは AWS のベストプラクティスを知っています — しかし、*あなたの* AWS 環境については知りません。会社のポリシーで、すべての S3 バケットに特定のキー ARN を持つ SSE-KMS が必要であることを知りません。ディザスタリカバリの RTO が AWS 推奨の 1 時間ではなく 4 時間であることを知りません。インシデント対応手順で、修復アクションの前に Opsgenie アラートが義務付けられていることを知りません。

その結果：会社のポリシーと矛盾し、既存のドキュメントと相反し、ベテランエンジニアなら誰もが知っている会社固有のコンテキストを見落とした汎用的な AI 推奨事項が生まれます。

**ナレッジベースはこれを解決します。** ランブック、ポリシー、コンプライアンスドキュメント、アーキテクチャドキュメントを接続することで、CloudThinker エージェントは汎用的なクラウドベストプラクティスだけでなく、組織の制度的知識に基づいて動作します。

***

## 汎用 RAG との比較

| アプローチ             | 汎用 AI       | CloudThinker ナレッジベース       |
| ----------------- | ----------- | -------------------------- |
| **会社ポリシー**        | 不明          | インデックス化され、関連するすべての応答で参照される |
| **カスタムランブック**     | 利用不可        | 関連する場合に自動的に取得される           |
| **アーキテクチャコンテキスト** | 汎用ベストプラクティス | 特定の設計決定と制約                 |
| **コンプライアンス要件**    | 標準フレームワーク   | 特定の監査要件と証跡フォーマット           |
| **インシデント手順**      | 汎用ステップ      | 会社固有のエスカレーションパスとツール        |

| ソースタイプ           | 機能                                          |
| ---------------- | ------------------------------------------- |
| **ドキュメントアップロード** | PDF、Word ドキュメント、テキストファイルを追加してナレッジリポジトリを作成する |
| **Web クローリング**   | Web サイト、Wiki、ドキュメントサイトを自動的にインデックス化する        |

***

## クイックセットアップ

<Steps>
  <Step title="ナレッジベースを作成する">
    CloudThinker の **Knowledge** に移動し、**「Create Knowledge Base」** をクリックします
  </Step>

  <Step title="タイプを選択する">
    コンテンツソースに応じて **ドキュメントアップロード** または **Web クローラー** を選択します
  </Step>

  <Step title="設定を構成する">
    * **Name**: わかりやすい名前をつける
    * **Description**: コンテンツの概要
    * **Access**: このナレッジベースを使用できるユーザーを選択する
  </Step>

  <Step title="コンテンツを追加する">
    ドキュメントをアップロードするか、Web クローリングをセットアップします（以下のセクションを参照）
  </Step>
</Steps>

***

## ドキュメントアップロード

### 対応ファイル

* **テキスト**: TXT、Markdown、RTF
* **Office**: Word（.docx）、PowerPoint（.pptx）、Excel（.xlsx）
* **PDF**: Adobe PDF ファイル
* **Web**: HTML、XML、JSON

### アップロード方法

<Tabs>
  <Tab title="ファイルを一つずつアップロード">
    1. **「Upload Document」** をクリックする
    2. ファイルを選択する（最大 50MB）
    3. タイトルとタグを追加する
    4. **「Upload」** をクリックする
  </Tab>

  <Tab title="複数ファイルをまとめてアップロード">
    1. 最大 100 ファイルをドラッグ＆ドロップする
    2. または ZIP ファイルをアップロードする
    3. バッチメタデータを追加する
    4. **「Process All」** をクリックする
  </Tab>
</Tabs>

***

## Web クローリング

### 基本セットアップ

<Steps>
  <Step title="Web サイト URL を入力する">
    クローリングを開始するページの URL を入力します
  </Step>

  <Step title="制限を設定する">
    * **Depth**: 何クリック分の深さ（1〜10）
    * **Pages**: クローリングする最大ページ数（100〜10,000）
  </Step>

  <Step title="スケジュールを選択する">
    * **One-time**: 単発クロール
    * **Daily**: 24 時間ごとに更新
    * **Weekly**: 週次更新
    * **Manual**: トリガーした時のみ
  </Step>
</Steps>

### よくある例

* ドキュメントサイト（GitBook、Confluence）
* 社内 Wiki
* ヘルプセンターと FAQ
* GitHub リポジトリ

***

## ナレッジベースの使用

### アクセスモード

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

### エージェントコマンド

```text theme={null}
# 任意のナレッジベースを検索する
@alex #kb find AWS cost optimization strategies

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

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

### エージェント例

<Tabs>
  <Tab title="Alex - クラウドエンジニア">
    **ナレッジタイプ：**

    * AWS ドキュメントとガイド
    * コスト最適化プレイブック
    * インフラ手順

    **例：**

    ```
    @alex #kb find EC2 cost savings
    → アップロードされたコスト最適化ガイドを参照
    → 具体的な推奨事項を提供
    ```
  </Tab>

  <Tab title="Oliver - セキュリティエンジニア">
    **ナレッジタイプ：**

    * セキュリティポリシーと手順
    * コンプライアンスドキュメント
    * インシデント対応プレイブック

    **例：**

    ```
    @oliver #kb security incident response
    → アップロードされたインシデント手順を参照
    → ステップバイステップのガイダンスを提供
    ```
  </Tab>

  <Tab title="Tony - データベースエンジニア">
    **ナレッジタイプ：**

    * データベース管理ガイド
    * パフォーマンスチューニングドキュメント
    * バックアップとリカバリ手順

    **例：**

    ```
    @tony #kb PostgreSQL performance tuning
    → データベース最適化ガイドを参照
    → 具体的な改善提案を提示
    ```
  </Tab>
</Tabs>

***

## ベストプラクティス

### コンテンツの整理

**ドキュメント構造（検索しやすくする）：**

* 明確な見出しを使用する（H1、H2、H3）
* 目次を含める
* 関連キーワードを追加する
* 箇条書きとリストを使用する

**タグ付け（スマートな整理）：**

* 一貫したタグ名を使用する
* 機能タグを含める（security、database、aws）
* 優先度レベルを追加する（critical、reference）
* 部門・チームタグを含める

### メンテナンスのヒント

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

***

## クイック例

### 例 1: 会社の手順

```yaml theme={null}
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: 技術ドキュメント

```yaml theme={null}
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: セキュリティポリシー

```yaml theme={null}
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)
```

***

## 導入チェックリスト

<Steps>
  <Step title="ナレッジを計画する">
    * [ ] 主要なドキュメントと Web サイトを特定する
    * [ ] 命名規則を決定する
    * [ ] 各ナレッジベースのアクセスレベルを選択する
  </Step>

  <Step title="最初のナレッジベースを作成する">
    * [ ] CloudThinker でナレッジベースを作成する
    * [ ] 重要なドキュメント 3〜5 件をアップロードするか、Web クローリングをセットアップする
    * [ ] 適切なタグと説明を追加する
    * [ ] 検索機能をテストする
  </Step>

  <Step title="エージェントを設定する">
    * [ ] 各エージェントのナレッジベースアクセスを設定する
    * [ ] `#kb` コマンドで手動検索をテストする
    * [ ] 重要なナレッジに「Always Available」を設定する
    * [ ] チームに使用コマンドをトレーニングする
  </Step>

  <Step title="監視・改善する">
    * [ ] 最も使用されるコンテンツを確認する
    * [ ] 古くなった情報を更新する
    * [ ] チームのニーズに基づいて新しいナレッジを追加する
    * [ ] フィードバックを収集して最適化する
  </Step>
</Steps>

***

## トラブルシューティング

<Accordion title="エージェントが情報を見つけられない">
  **解決策：**

  * エージェントがナレッジベースへのアクセス権を持っているか確認する
  * ナレッジベースが「Always Available」に設定されているか、`#kb` コマンドを使用しているか確認する
  * ドキュメントのタイトルを改善してキーワードを追加する
  * 異なる検索語でテストする
</Accordion>

<Accordion title="ドキュメントをアップロードできない">
  **解決策：**

  * ファイルサイズを確認する（ファイルあたり最大 50MB）
  * ファイルタイプがサポートされているか確認する
  * ドキュメントがパスワード保護されていないか確認する
  * ファイルを一つずつアップロードしてみる
</Accordion>

<Accordion title="Web クローリングが機能しない">
  **解決策：**

  * Web サイトの URL がアクセス可能か確認する
  * Web サイトがクローラーをブロックしていないか確認する（robots.txt）
  * より少ないページ数制限から始める
  * まず単一ページのクローリングを試す
</Accordion>

***

## 次のステップ

<Note>
  **成功のヒント：**

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

<CardGroup cols={2}>
  <Card title="🚀 ナレッジベースを作成する" icon="rocket" href="https://app.cloudthinker.io/knowledge">
    **今すぐ始める**

    最初のナレッジベースを作成してコンテンツのアップロードを開始する
  </Card>

  <Card title="🤖 エージェントを設定する" icon="robot" href="/ja/guide/agents">
    **AI エージェントをセットアップする**

    ナレッジベースを効果的に活用するようエージェントを設定する
  </Card>
</CardGroup>