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

# ナレッジ

> 重要なコンテキストや知識を共有して、Devin のオンボーディングを支援します

<div id="what-is-knowledge">
  ## Knowledge とは何ですか？
</div>

新しいエンジニアをオンボーディングするのと同様に、Devin をオンボーディングする際にも、最初に **Knowledge (ナレッジ) の共有** に一定の初期投資が必要です。

Knowledge とは、Devin がすべてのセッションで参照できるヒント、アドバイス、手順などの集合です。時間の経過とともに Devin の Knowledge ベースを継続的に拡充していくことができ、Devin は必要に応じて **関連する Knowledge を自動的に呼び出し** ます。

<video controls className="w-full aspect-video" src="https://mintcdn.com/cognitionai/ifLkKLaMB-vvINwf/images/feature-add-knowledge.mp4?fit=max&auto=format&n=ifLkKLaMB-vvINwf&q=85&s=a0d91cc2095f798e31fb3e182812f63d" data-path="images/feature-add-knowledge.mp4" />

Knowledge 機能を使うことで、ドキュメント、ヒント、カスタムの社内ライブラリ、その他 Devin が必要とする可能性のある資料を共有できます。

<div id="how-do-i-create-knowledge">
  ## Knowledge を作成するにはどうすればよいですか？
</div>

**Settings & Library** ページの **Knowledge** タブに移動し、右上の「Create knowledge」をクリックします。

<Frame>
  <img src="https://mintcdn.com/cognitionai/s_eAbNGhbOgn5ZqZ/images/knowledge_settings.png?fit=max&auto=format&n=s_eAbNGhbOgn5ZqZ&q=85&s=525ecdc36c84554bdb4fe14e06659e71" alt="Devin" width="2954" height="902" data-path="images/knowledge_settings.png" />
</Frame>

**Trigger Description** は、適切なタイミングで Devin が関連する Knowledge を呼び出すのに役立ちます。内容はシンプルなフレーズや文章で構いません。Devin は、現在の作業が指定されたトリガーに関連している場合にその Knowledge アイテムを参照します。また、すべての Knowledge には Trigger Description が必須です。

**Content** には、関連する情報を数文程度で記載してください。

<div id="macros">
  ### マクロ
</div>

任意の Knowledge アイテムに **マクロ** を割り当てることができます。これは `!` で始まる短い識別子です（例: `!deploy-checklist`）。マクロを使うと、プロンプト内でマクロ名を入力するだけで Knowledge をすばやく参照できます。マクロに使用できるのは英字、数字、ハイフンのみで、組織内で一意である必要があります。

<div id="enabling-and-disabling-knowledge">
  ### Knowledge の有効化と無効化
</div>

各 Knowledge アイテムは、ユーザーごとに個別に**有効化または無効化**できます。Knowledge アイテムを無効化すると、組織から削除することなく、Devin があなたのセッションでそのアイテムを参照しなくなります。これは、Knowledge アイテムが一時的に自分の作業には関係ないものの、チームメンバーや今後のためには役立つ可能性がある場合に便利です。

<div id="knowledge-suggestions">
  ## ナレッジの提案
</div>

Devin は、チャット内でのフィードバックに基づいて、自動的に記憶すべきナレッジを提案します。保存する前に提案されたナレッジを編集するか、役に立たない場合はそのナレッジを破棄できます。

<video controls className="w-full aspect-video" src="https://mintcdn.com/cognitionai/ifLkKLaMB-vvINwf/images/feature-knowledge-suggestions.mp4?fit=max&auto=format&n=ifLkKLaMB-vvINwf&q=85&s=a09d259bd828f60086f982d8f0ddf5a4" data-path="images/feature-knowledge-suggestions.mp4" />

フィードバックに基づいて、Devin にナレッジの提案を再生成するよう依頼することもできます。これにより、提案されたナレッジを手動で編集するのではなく、ブラッシュアップしやすくなります。Devin は新しいナレッジ項目を提案するだけでなく、既存のナレッジ項目への更新提案も行えます。

<div id="what-belongs-in-knowledge">
  ## Knowledge には何を含めるべきですか？
</div>

日常的によく繰り返しているプロンプトやプレイブックの要素を含めることをおすすめします。例えば、よくあるバグとその解決策、コード規約や標準への準拠方法、デプロイワークフロー、テストワークフロー、社内／専用ツールとのやり取り方法などです。

<div id="organizing-knowledge-with-folders">
  ## フォルダで Knowledge を整理する
</div>

Knowledge アイテムは、**フォルダ**に整理して管理しやすくできます。フォルダでは次のことが可能です。

* **ネストされた階層構造** — サブフォルダを作成して、構造化された Knowledge ツリーを構築できます。
* **一括で有効化 / 無効化** — フォルダ全体のオン / オフを切り替えられます。フォルダが無効化されると、その中にあるすべての Knowledge アイテムもあなたのセッションで無効化されます。
* **アイテムの移動** — Knowledge アイテムをフォルダ間でドラッグしたり、移動アクションを使って再整理したりできます。
* **自動整理** — 複数の Knowledge アイテムを選択すると、Devin が自動的に論理的なフォルダに振り分けます。

フォルダは、組繗内に異なるチーム、プロジェクト、ワークフローにまたがる多数の Knowledge アイテムがある場合に特に役立ちます。

<div id="tips-and-tricks">
  ## Tips and tricks
</div>

1. 1 つのワークフローやアクションを対象にした、具体的な Knowledge を作成してください。Devin は Knowledge の内容全体を参照するため、内容はすべて関連性が高く、最新の状態に保ちましょう！
   * 可能であれば、Knowledge はより小さく分割してください。Devin は複数の Knowledge 「アイテム」に同時にアクセスできます。
2. Knowledge を追加・更新することを習慣にしましょう。これらは組織全体で共有され、時間の経過とともにチーム向けの Devin を継続的に改善していきます。
3. Devin は、関連がある場合に Knowledge を参照するのであって、最初に一度にすべてを参照するわけではありません。参照のトリガーは、内容との関連性が高くなるようにしてください。
4. フォルダを使って関連する knowledge（例: プロジェクト、チーム、またはワークフロー別）をグループ化すると、注力対象が変わったときに knowledge のセットをすばやく有効化または無効化できます。

<div id="organization-and-enterprise-knowledge">
  ## 組織レベルと Enterprise レベルの Knowledge
</div>

Enterprise 契約のお客様向けに、Knowledge ページは複数のタブに分かれており、異なるスコープでのナレッジ管理をサポートします。

* **Organization Knowledge** — 現在の組織をスコープとする Knowledge アイテムです。組織内のすべてのメンバーに表示され、新しい Knowledge アイテムのデフォルトスコープになります。
* **Suggestions** — セッションでのやり取りに基づいて AI が生成する Knowledge アイテムの提案です（プライマリ組織以外で表示されます）。
* **Enterprise Knowledge** — Enterprise に属するすべての組織に適用される Knowledge アイテムです。Enterprise アカウントに所属している場合にのみ表示されます。Enterprise 管理者はこのタブから Enterprise レベルの Knowledge を作成および管理できます。

<Note>
  プライマリ組織のユーザーには、単一の **Enterprise Knowledge** タブが表示されます。Enterprise アカウントを持つ非プライマリ組織のユーザーには、Organization Knowledge をデフォルトとして 3 つすべてのタブが表示されます。Enterprise アカウントを持たない非プライマリ組織のユーザーには、Organization Knowledge と Suggestions のみが表示されます。
</Note>

Enterprise Knowledge アイテムは、全社的なコーディング規約、アーキテクチャガイドライン、デプロイ手順など、すべてのチームや組織に一貫して適用すべきコンテキスト情報を共有するのに特に有用です。

<div id="promoting-organization-knowledge-to-enterprise">
  ### 組織のKnowledgeをEnterpriseに昇格させる
</div>

組織レベルのKnowledgeアイテムがEnterprise全体で共有する価値がある場合は、Knowledgeエディタから直接Enterpriseに昇格できます。アイテムを開き、**Details**タブで**Promote to Enterprise**をクリックします。アイテムは組織スコープからEnterpriseスコープに移動され、Enterprise内のすべての組織で利用できるようになります。

昇格するにはEnterpriseのKnowledge管理権限が必要です。また、この機能を利用できるのは、Enterpriseに属する組織内のユーザーが作成したKnowledgeアイテムのみです。

<div id="pinning-knowledge-to-repos">
  ## Knowledge をリポジトリにピン留めする
</div>

Knowledge をリポジトリに適用する方法として、「なし」「特定のリポジトリ」「すべてのリポジトリ」から選択できます。

* **no repo** にピン留め: Knowledge は、Devin が現在のコンテキストに関連すると判断したときにのみ参照されます。
* **a specific repo** にピン留め: Knowledge は、Devin がその特定のリポジトリで作業しているときは常に使用されます。
* **all repos** にピン留め: Knowledge は、任意のセッションで Devin が作業しているすべてのリポジトリに自動的に適用されます。