Skip to main content
Knowledge は非推奨となり、今後のアップデートで削除されます。既存の Knowledge は プラグインのスキル へ自動的に移行されます。移行は段階的に展開されており、お客様側での対応は不要です。今後 Devin と共有したい手順や前提情報には、スキルを利用してください。詳しくは移行に関する FAQ を参照してください。

​
Knowledge とは何ですか？

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

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

Settings → Resources → Knowledge に移動し、右上の Create knowledge をクリックします。 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

Knowledge のスコープは、単一の組織または Enterprise 全体のいずれかに設定できます。Knowledge ページに表示される内容は、どの組織にいるかによって異なります。
  • プライマリ以外の組織 — Knowledge ページには 2 つのタブがあります。
    • 組織 (デフォルト) — 現在の組織にスコープされた Knowledge アイテム。組織のすべてのメンバーが閲覧でき、新規の Knowledge アイテムのデフォルトのスコープになります。
    • Suggestions — セッションでのやり取りに基づいて AI が生成した Knowledge の提案。
  • プライマリ組織 — Knowledge ページにはタブがなく、Enterprise の Knowledge ビューのみが表示されます。Enterprise の Knowledge は Enterprise 内のすべての組織に適用され、Enterprise 管理者はここで作成・管理します。
プライマリ以外の組織に Enterprise タブはありません。組織が Enterprise に属している場合は、Knowledge ページの Looking for enterprise knowledge? リンクから、Enterprise のプライマリ組織で Enterprise の Knowledge を開いてください。
Enterprise の Knowledge アイテムは、全社的なコーディング標準、アーキテクチャのガイドライン、デプロイ手順など、すべての Team や組織に一律に適用すべき前提情報を共有する際に特に役立ちます。

​
組織の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 が作業しているすべてのリポジトリに自動的に適用されます。

​
Knowledge からスキルへの移行に関する FAQ

Knowledgeノートは廃止され、Devin に再利用可能な指示を与える標準的な方法であるスキルに置き換えられます。お客様のノートは Devin が自動的にスキルへ移行します。切り替え当日もチームの業務に変化はなく、お客様側で対応していただく作業もありません。

​
ノートとスキルの対応関係

たとえば、次のノートは: 次のようなスキルになります:
SKILL.md

​
FAQ

いいえ。ノートがトリガーに基づいて読み込まれていたのと同じように、移行されたスキルは説明 (description) に基づいて読み込まれます。
Devin アプリの Customize → プラグイン → Knowledge で確認できます。スキルは元のフォルダごとにグループ化されています。
ノートと同様に Devin 内に保存されます。SKILL.md ファイルとしてリポジトリにコミットするスキルとは異なり、移行されたスキルはリポジトリではなく、Devin が管理するプラグイン内に保存されます。リポジトリには何もコミットされないため、ファイルを追加したり管理したりする必要はありません。
Customize → スキル に移動し、対象のスキルを開いて編集します。組織のスキルは組織管理者と Manage Knowledge 権限を持つメンバーが、Enterprise のスキルは Enterprise 管理者が編集できます。
スキルを作成してください。スキルは Web アプリ、CLI、Devin Desktop など、Devin が動作するあらゆる環境で利用できます。

​
API ユーザー向け

Knowledgeノートのエンドポイント /v3/organizations/{org_id}/knowledge/notes[/{note_id}] と /v3/enterprise/knowledge/notes[/{note_id}]、および対応する /knowledge/folders エンドポイントです。
ノートについては、/v3beta1/organizations/{org_id}/managed-plugins および /v3beta1/enterprise/managed-plugins 配下のスキルエンドポイント (v3 beta) を利用します。一覧取得エンドポイントは、他の v3 エンドポイントと同様に first と after によるページネーションに対応しています。
移行されたノートは、knowledge バンドル内にスラッグ名で格納されています。すべてを一覧表示するには GET .../managed-plugins/bundles/knowledge/skills を、個別に取得するには GET .../managed-plugins/bundles/knowledge/skills/deploying-to-staging を利用します。