最初のセッションを開始する前に、リポジトリをインデックス化し、セットアップしていることを確認してください。これらは、Devin があなたのコードベースを理解し、扱えるようにするための基盤となる手順です。
セットアップが完了したら、さっそく最初の Devin セッションを開始しましょう。このガイドでは、新しいセッションインターフェースを順を追って紹介し、Devin と最適な形でやり取りする方法を理解できるようにします。
新しいセッションを開始すると、Ask と Agent の 2 つの主要なモードが表示されます。
すでにタスク範囲が完全に定義されたプランがある場合を除き、まずは Ask モードで Devin と一緒にプランを作成し、その後 Agent モードに切り替えて実行することをおすすめします。
Ask Devin は、実際のコードに変更を加えることなく、コードベースの調査やタスクの計画を行うための軽量なモードです。Ask Devin では、質問と計画の両方が可能です。
- コードの動作について 質問 できます。高度なコード検索を利用して、詳細で正確かつ根拠の明確な回答を返します。
- 実装前に作業のスコープ設定と計画を行い、タスクを計画 できます。Devin が Agent セッション向けの、十分なコンテキストを含むプロンプトを生成します。
Ask Devin から Devin セッションを開始すると、セッションのステータスが会話内に直接表示されます。
Ask モードはメインページまたは DeepWiki ページから起動できます。
メインページから Ask モードを使う場合は、Ask モードに切り替えて、質問したいリポジトリを選択します。
DeepWiki ページから Ask モードを使う場合は、ページ下部のチャット入力欄に質問内容を入力し、Ask をクリックします。これにより、Devin が参照する情報の範囲がそのリポジトリに自動的に限定されます。
詳しくは Ask Devin ガイド を参照してください。
Devin と一緒に問題を理解してプランを作成できたら、Agent モードに進む準備が整っています。
エージェントモードは、Devin が完全に自律的に動作し、コードの記述、コマンドの実行、Web の閲覧、複雑なタスクのエンドツーエンドでの完了まで行えるモードです。次のようなことを行いたいときにエージェントモードを使用します:
- 機能を実装したりバグを修正するとき
- Pull Request を作成するとき
- テストを実行して問題をデバッグするとき
- コード変更を伴う複数ステップのタスクを実行するとき
Agent モードは、メインページまたは Ask Devin セッションから起動できます。Ask Devin からセッションを開始した場合、そのステータスは進捗を追跡できるよう Ask Devin の会話内に表示されます。
タスクのスコープが明確でない場合は、次の進め方をおすすめします。
- まずは Ask モード でタスクの計画を立てる
- Ask セッションの内容を基にスコープされた計画を作成するために、Devin プロンプトを作成する
- Send to Devin をクリックして Agent モードに移行し、タスクを実行する
このフローは次のとおりです。
メインページから Agent モードを使う場合は、トグルで Agent モードに切り替え、作業対象とするリポジトリを選択します。
Agent セッションを開始する際には、いくつかのオプションを設定します。具体的には、Repository の選択と Agent の選択です。
Devin に作業させたいリポジトリを選択します。リポジトリセレクターをクリックすると、Devin のマシンに追加された すべてのリポジトリが表示されます。
リポジトリを選択すると、Devin は次のことができるようになります:
- コードベースにアクセスして変更を加えられる
- 正しいブランチを開始点として使用できる
- 適切なリポジトリに対してプルリクエストを作成できる
セッションでDevinが使用するエージェント構成を選択できます。エージェントによって機能が異なったり、特定の種類のタスク向けに最適化されていたりします。
現在、多くのタスクに適したデフォルトのエージェントと、データ分析タスク向けに最適化されたデータアナリストエージェントのDanaが利用できます。
どのエージェントを使うか迷う場合は、ほとんどのタスクで問題なく使えるデフォルトのエージェントを選択してください。
@ メンションを使用すると、ファイル、リポジトリ、その他のリソースに関する特定のコンテキストを Devin に付与できます。チャット入力欄で @ を入力すると、使用可能なメンションの一覧がドロップダウンで表示されます:
- @Repos - 特定のリポジトリを参照する
- @Files - コードベース内の特定のファイルを参照する
- @Macros - Knowledge エントリ用のマクロを参照する
- @Playbooks - チームまたはコミュニティのプレイブックを参照する。これは、Devin の振る舞いをガイドするために使用できる詳細なプロンプトテンプレートです。
- @Secrets - Devin のセッションマネージャから特定のシークレット (例:APIキー、認証情報など) を参照する
@メンションを使用することで、Devin はあなたが扱っている対象をより正確に理解し、プロンプトのあいまいさを減らすことができます。
まずは、成功条件が明確で、かつ Devin に必要なコンテキストを十分に渡せるタスク から始めてください。チームメイトに仕事を引き継ぐときと同じ要領です。慣れてきたら、徐々により複雑なタスクにも挑戦してみましょう。ユーザーは、ちょっとしたバグ修正から、特定箇所のリファクタリング、大規模なマイグレーション、ゼロからの機能開発まで、さまざまな作業で Devin を活用しています。
目安として、自分でやって3時間以内に終わるタスクであれば、Devin が対応できる可能性が高いです。より大きなプロジェクトは、目的を絞ったセッションに分割し、バッチセッションを使って並行して実行してください。
クイック PR を作成する(このプロンプトは Playbook での使用を推奨します)
Devin が「何を」「どのように」できるか、より詳しい例を確認したい場合は、ユースケースを参照してください。
セッションが終了したら、Session Insights を確認してください。そこで、何が起きたかのタイムライン、実用的なフィードバック、今後似たタスクで再利用できる改良済みプロンプトが得られます。
基本的なセッションに慣れてきたら、Devin をさらに活用するために以下のリソースを参照してください。