メインコンテンツへスキップ

Knowledge とは何ですか?

新しいエンジニアをオンボーディングするのと同様に、Devin をオンボーディングする際にも、最初に Knowledge (ナレッジ) の共有 に一定の初期投資が必要です。 Knowledge とは、Devin がすべてのセッションで参照できるヒント、アドバイス、手順などの集合です。時間の経過とともに Devin の Knowledge ベースを継続的に拡充していくことができ、Devin は必要に応じて 関連する Knowledge を自動的に呼び出し ます。 Knowledge 機能を使うことで、ドキュメント、ヒント、カスタムの社内ライブラリ、その他 Devin が必要とする可能性のある資料を共有できます。

Knowledge を作成するにはどうすればよいですか?

Settings & Library ページの Knowledge タブに移動し、右上の「Add Knowledge」をクリックします。
Devin
Trigger Description は、適切なタイミングで Devin が関連する Knowledge を呼び出すのに役立ちます。内容はシンプルなフレーズや文章で構いません。Devin は、現在の作業が指定されたトリガーに関連している場合にその Knowledge アイテムを参照します。また、すべての Knowledge には Trigger Description が必須です。 Content には、関連する情報を数文程度で記載してください。

マクロ

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

Knowledge の有効化と無効化

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

ナレッジの提案

Devin は、チャット内でのフィードバックに基づいて、自動的に記憶すべきナレッジを提案します。保存する前に提案されたナレッジを編集するか、役に立たない場合はそのナレッジを破棄できます。 フィードバックに基づいて、Devin にナレッジの提案を再生成するよう依頼することもできます。これにより、提案されたナレッジを手動で編集するのではなく、ブラッシュアップしやすくなります。Devin は新しいナレッジ項目を提案するだけでなく、既存のナレッジ項目への更新提案も行えます。

Knowledge には何を含めるべきですか?

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

フォルダで Knowledge を整理する

Knowledge アイテムは、フォルダに整理して管理しやすくできます。フォルダでは次のことが可能です。
  • ネストされた階層構造 — サブフォルダを作成して、構造化された Knowledge ツリーを構築できます。
  • 一括で有効化 / 無効化 — フォルダ全体のオン / オフを切り替えられます。フォルダが無効化されると、その中にあるすべての Knowledge アイテムもあなたのセッションで無効化されます。
  • アイテムの移動 — Knowledge アイテムをフォルダ間でドラッグしたり、移動アクションを使って再整理したりできます。
  • 自動整理 — 複数の Knowledge アイテムを選択すると、Devin が自動的に論理的なフォルダに振り分けます。
フォルダは、組繗内に異なるチーム、プロジェクト、ワークフローにまたがる多数の Knowledge アイテムがある場合に特に役立ちます。

Tips and tricks

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

組織レベルと Enterprise レベルの Knowledge

Enterprise 契約のお客様向けに、Knowledge ページは複数のタブに分かれており、異なるスコープでのナレッジ管理をサポートします。
  • Organization Knowledge — 現在の組織をスコープとする Knowledge アイテムです。組織内のすべてのメンバーに表示され、新しい Knowledge アイテムのデフォルトスコープになります。
  • Suggestions — セッションでのやり取りに基づいて AI が生成する Knowledge アイテムの提案です(プライマリ組織以外で表示されます)。
  • Enterprise Knowledge — Enterprise に属するすべての組織に適用される Knowledge アイテムです。Enterprise アカウントに所属している場合にのみ表示されます。Enterprise 管理者はこのタブから Enterprise レベルの Knowledge を作成および管理できます。
プライマリ組織のユーザーには、単一の Enterprise Knowledge タブが表示されます。Enterprise アカウントを持つ非プライマリ組織のユーザーには、Organization Knowledge をデフォルトとして 3 つすべてのタブが表示されます。Enterprise アカウントを持たない非プライマリ組織のユーザーには、Organization Knowledge と Suggestions のみが表示されます。
Enterprise Knowledge アイテムは、全社的なコーディング規約、アーキテクチャガイドライン、デプロイ手順など、すべてのチームや組織に一貫して適用すべきコンテキスト情報を共有するのに特に有用です。

組織のKnowledgeをEnterpriseに昇格させる

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

Knowledge をリポジトリにピン留めする

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