ナレッジベース

ナレッジベースは、繰り返し検索・共有される必要がある安定した情報を格納します。完全な流れは、作成 → ソースの追加 → 処理の確認 → ナレッジカードのコンパイル → メンバーとWakerの管理 → 新しいチャットでの検証 です。 一回限りの要件は現在のタスクに、役割ルールはWakerのプロフィールまたはメモリに保持してください。あらゆる種類のコンテキストをナレッジベースに入れないでください。

​

ナレッジベースを開く

パス: 左側のナビゲーション → Capabilities & Resources → Knowledge Base。

一覧は次を区別します:

• Created by me: あなたがナレッジベースの所有者であり、ソース・メンバー・設定を管理できます。
• Shared with me: 別の所有者がアクセスを許可しています。利用可能な操作はあなたのメンバー権限によって異なります。
• Featured: プロダクトが提供する読み取り専用のナレッジベースです。確認してWakerにバインドできますが、そのソースやカードを編集することはできません。利用可否はリージョンとバージョンに依存します。

「Product Manual」や「Customer Support Policy」のように、1つのナレッジベースには1つの安定したテーマを使用してください。無関係なテーマは分けて、アクセス・更新・検証を管理しやすい状態に保ちます。

​

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

1. New Knowledge Base を選択します。
2. テーマと範囲を明確に示すタイトルを入力します。
3. それを開き、ソース・カード・メンバー・スケジュール・設定のエントリが利用可能であることを確認します。

完了チェック: ナレッジベースが Created by me の下に表示され、正常に開き、意図したタイトルを持っていること。

​

Featuredナレッジベースを使用する

Featuredナレッジベースは、すぐに使える公開またはプロダクトの知識です:

1. Featured を開き、その説明・範囲・最終更新を確認します。
2. ナレッジベースから、または対象のWakerのKnowledge設定からバインドします。
3. Wakerは読み取り専用のアクセスを取得します。Featured項目ではソースのアップロード、カードの編集、メンバーの管理はできません。
4. 新しいチャットを開始し、既知の事実1つ、境界ケース1つ、未対応の質問1つをテストします。

資料を追加または改訂するには、自分のナレッジベースを作成し、使用が許可されているソースをインポートしてください。Featuredタブが表示されない場合は、アカウント・リージョン・バージョン、または機能の利用可否が反映されていることがあります。

​

ソースを追加する

Add source を選択します。利用可能なソースの種類はエディションとバージョンによって異なりますが、ローカルファイルやURLが含まれることがあります。

​

ローカルファイルをアップロードする

1. アップロードダイアログに表示される形式とサイズの要件を満たすファイルを選択します。
2. アップロードと解析が完了するまで待ちます。
3. ソースを開き、タイトル・本文・ページが正しく抽出されたことを確認します。

アップロードしたファイルは必ずしも検索できるとは限りません。ページがアップロード中・処理中・失敗を報告しなくなるまで待ってください。

​

URLをインポートする

1. 完全な https:// または http:// のアドレスを入力します。
2. QoderWakeがページを取得して処理するまで待ちます。
3. ソースを開き、内容が意図した本文であり、サインイン・エラー・空のページではないことを確認します。

認証を必要とするページ、プライベートネットワークでのみ利用可能なページ、取得をブロックするページ、複雑なスクリプトに依存するページは失敗することがあります。許可されている場合は、コンテンツに対応した形式のファイルにエクスポートし、代わりにアップロードしてください。

​

ソースを整理して維持する

コレクションが大きくなったら、テーマ・エディション・プロダクトラインごとにフォルダーを使用しますが、階層は浅く保ってください。必要に応じてバージョンまたは発効日をタイトルに含めます。

• 旧版・重複・矛盾するバージョンを削除します。
• 複数のドキュメントが同じルールを説明している場合は、権威のあるソースを特定します。
• 原本が変更されたらソースを再アップロードまたは更新します。
• 資料を置き換えたり削除したりした後は、再コンパイルして検証質問を再実行します。

​

SourcesとCardsを理解する

Sources はインポートされた生素材です。Cards はそれらの素材からコンパイルされた構造化された知識です。ソースは正常にアップロードされても、コンパイルがまだ実行されていないため、新しい情報が信頼できる検索にはまだ利用できないことがあります。 両方のリストを確認してください。カードは読みやすく、ヘッダー・エラーページ・重複段落を公式の知識に変えてはなりません。

​

コンパイルを設定して実行する

ナレッジベースのサイドバーから Settings を開きます。

​

テンプレートを選択する

1. Compilation template を開きます。
2. ソースの種類と期待される用途に適したテンプレートを選択します。
3. 抽出または除外する知識を指定する必要がある場合に限り、プロンプトを追加します。認証情報や一時的なタスクを決して含めないでください。

たとえばコーディング標準のナレッジベースでは、技術スタック・エンジニアリングルール・アーキテクチャに関するカードを要求し、採用や会議のコンテンツは除外します。

​

手動でコンパイルする

1. Compilation settings を開きます。
2. すべてのソースが完全であることを確認してから、Start compilation を選択します。
3. 完了を待って Cards を確認します。
4. いくつかのカードをその素材と比較します。

​

自動またはスケジュールでコンパイルする

頻繁に更新されるソースには自動コンパイルまたはスケジュールコンパイルを使用します。有効にする前に次を確認してください:

• 頻度が不要な繰り返しの作業を生み出さないこと。
• コンパイルがソース処理の完了後にのみ開始されること。
• 失敗に見える状態と再試行の経路があること。

自動コンパイルはカードを生成しますが、ソース品質レビューや業務受け入れに取って代わるものではありません。

​

メンバーを管理する

Members を開いて、所有者と共同作業者を確認します。

1. このテーマを必要とする人だけを招待します。
2. 責任に応じて閲覧・編集・管理アクセスを付与します。
3. メンバーの役割が変わったら削除します。
4. 機微なソースをアップロードする前にメンバーシップを再確認します。

共同作業者を変更できるのは、所有者または管理権限を持つメンバーだけです。ナレッジベースを共有しても、それがすべてのWakerに割り当てられるわけではありません。

​

ナレッジベースをWakerにバインドする

ナレッジベース一覧のWaker割り当てエントリを使用するか、Wakerを開いて Knowledge Base に進みます。

1. そのテーマを役割上必要とするWakerだけを選択します。
2. ソース処理とコンパイルが完了したことを確認します。
3. 割り当てを保存します。
4. 新しいチャットを開始して検索を検証します。

無関係なナレッジベースが多すぎると検索ノイズが生じ、矛盾するポリシーが混在することがあります。

​

知識を検証する

少なくとも3種類の質問をテストします:

1. 存在する事実: 回答が正確で、根拠を確認できること。
2. 境界または例外: 他のテーマと混ぜることなく正しいルールが使用されること。
3. 存在しない事実: Wakerが回答を捏造する代わりに、証拠が不十分であると述べることで。

バインド後は新しいチャットを使用します。回答を元のソースとコンパイル済みカードの両方と比較します。 完了チェック: 既存の事実が正確で追跡可能であり、欠落した事実が捏造されず、更新と再コンパイルの後でも同じテストが合格すること。

​

更新または削除する

• ソースを変更した後は再コンパイルし、影響を受けたカードを確認します。
• ソースを削除する前に、それが唯一の権威あるコピーではないことを確認します。
• ナレッジベースを削除する前に、Wakerのバインドを解除し、依存するAutonomous Work・Groups・IMの使用事例を確認します。
• ナレッジベースを削除しても、以前の回答が取り消されたり、関連するチャット履歴が消去されたりはしません。

​

トラブルシューティング