GitHub Copilot CLI（コマンドラインインターフェース） 用のカスタム エージェントの作成と使用

特定の開発タスクに合わせてカスタマイズされた専門知識を持つ特殊なエージェントを作成します。

この記事の内容

イントロダクション

カスタム・エージェント を使用すると、Copilot の専門知識を特定のタスクに合わせてカスタマイズできます。

Copilot がタスクを実行するよう求めると、Copilot は、そのタスクに最も適したエージェントの専門知識があると判断する場合に カスタム エージェント のいずれかを選択することがあります。

カスタム エージェント が実行する作業は、サブエージェントを使用して行われます。このサブエージェントは、タスクを行うために起動される一時的なエージェントです。 サブエージェントには独自のコンテキスト ウィンドウがあり、メイン エージェントに関連しない情報で設定できます。 この方法では、特に大規模なタスクの場合、メイン エージェントのコンテキスト ウィンドウを乱雑にすることなく、作業の一部を カスタム エージェント にオフロードできます。 その後、メイン エージェントは、より高いレベルの計画と調整に集中できます。

詳しくは、「カスタム エージェントについて」をご覧ください。

カスタム エージェント を作成する

各 カスタム エージェント は、.agent.md 拡張子を持つ Markdown ファイルによって定義されます。 これらのファイルは、次の手順で説明するように、自分で作成することも、CLI 内から追加することもできます。

  1. 対話型モードで、「 /agent」と入力します。

  2. オプションの一覧から [ 新しいエージェントの作成 ] を選択します。

  3. リポジトリまたはユーザーのホーム ディレクトリのどちらかに カスタム エージェント を作成するかを選択します。

    •      **Project** (`.github/agents/`)

    •      **ユーザー** (`~/.config/copilot/agents/`)

    メモ

    両方の場所に同じ名前の カスタム エージェント がある場合は、リポジトリ内の名前ではなく、ホーム ディレクトリ内のデータが使用されます。

  4. Copilot を使用して カスタム エージェント ファイルを作成するか、または自分で作成するかを選択します。

           **オプション 1: Copilot を使用する**

    作成するエージェントの詳細を入力します。 エージェントの専門知識と、エージェントを使用するタイミングについて説明します。 Copilot は、入力された説明を受け取り、それを使用してエージェント プロファイルを作成します。

    たとえば、次のように入力できます。

    I am a security expert. I check code files thoroughly for potential security issues. Use me whenever a security review/check/audit is requested for one or more code files, or when the word "seccheck" is used in a prompt in reference to code files.

I will identify potential problems, such as code that:

- Exposes secrets or credentials
- Allows cross-site scripting
- Allows SQL injection
- Contains vulnerable dependencies
- Allows authentication to be bypassed

If any problems are identified, create a single GitHub issue in this repository on GitHub.com with details of problems, giving full details of each issue, including, but not limited to, risk level and recommended fix.

    Copilot によって初期のエージェント プロファイルの生成が完了すると、次のオプションが表示されます。

    • 続行
    • コンテンツを確認する
    • もう一度お試しください
    • 終了する

    コンテンツを確認する場合は、エージェント ファイルが既定のエディターで開きます。 必要に応じて、CLI でエージェント作成プロセスを続行する前に、確認して変更を行うことができます。

    作成プロセスを完了するには、[続行] を選択 します。

           **オプション 2: エージェント プロファイルを手動で作成する**

    エージェント ファイルを自分で作成することを選択すると、エージェント プロファイルを作成するために必要な情報を入力するための一連のプロンプトが表示されます。

    1. エージェントの名前を入力します。 入力する名前は、使用可能なエージェントを一覧表示するときに表示される名前です。 このバージョンは、エージェント ファイルの名前として使用されます。たとえば、「Security expert」と入力すると、エージェント ファイルには security-expert.agent.md という名前が付けられます。

      ヒント

      カスタム エージェント をプログラムで使用する際の使い勝手を向上するため、小文字とハイフンのみからなる名前を選ぶことをお勧めします。

    2. このエージェントが持っている専門知識と使用する必要があるタイミングを示す説明を入力します。

    3. 特定のガイドライン、実行する必要があるアクション、それに従う必要がある制約など、エージェントの動作方法の手順を入力します。

  5. カスタム エージェント がアクセスできるツールを選択します。

    既定では、カスタム エージェント はすべてのツールにアクセスできます。 エージェントのアクセスを制限すると、 tools 仕様がエージェント ファイルに追加されます。

  6. CLI を再起動して、新しい カスタム エージェント を読み込みます。

カスタム エージェント を使用する

カスタム・エージェント は、次の方法で使用できます。

  •         **スラッシュ コマンド**

    対話モードで /agent と入力して、利用できる カスタム エージェント の一覧から選択します。 次に、選択したエージェントに渡されるプロンプトを入力します。

    メモ

    CLI の既定のエージェントは、この一覧には含まれません。 既定のエージェントの詳細については、「 GitHub Copilot CLI の使用」を参照してください。

  •         **明示的な命令**

    Copilot に特定のエージェントを使用するよう指示します。 例えば次が挙げられます。

    Use the security-auditor agent on all files in the /src/app directory

  •         **推論による**

    エージェント ファイル内の説明に基づいて、特定のエージェントの使用をトリガーするプロンプトを使用します。 例えば次が挙げられます。

    Check all TypeScript files in or under the src directory for potential security problems

    または ("seccheck" がエージェント プロファイルのトリガー ワードとして定義されている場合):

    seccheck /src/app/validator.go

    Copilot は、使用するエージェントを自動的に判断します。

  •         **プログラムによって**

    コマンドライン オプションで使用したい カスタム エージェント を指定します。 例えば次が挙げられます。

    copilot --agent security-auditor --prompt "Check /src/app/validator.go"

    ここで security-auditor は、拡張子が .agent.md されていない カスタム エージェント プロファイルのファイル名です。 通常、これはエージェント プロファイルの name 値と同じですが、必ずしも同じではありません。

詳細については、次を参照してください。

  •         [AUTOTITLE](/copilot/concepts/agents/copilot-cli/comparing-cli-features)

  •         [AUTOTITLE](/copilot/reference/custom-agents-configuration)

  •         [AUTOTITLE](/copilot/tutorials/customization-library/custom-agents) - サンプルの厳選されたコレクション