カスタムエージェント

エージェントはAIを使用してタスクを実行し、複雑な質問に答えます。マージリクエストの作成やコードのレビューなど、特定のタスクを実行するためのカスタムエージェントを作成できます。また、AIカタログを使用して、GitLabによって作成されたエージェントを見つけることもできます。

エージェントとやり取りする準備ができたら、エージェントを有効にして、GitLab UI、VS Code、JetBrains IDEのGitLab Duo Chatで使用を開始します。

前提条件

• GitLab Duo Agent Platformの前提条件を満たしている。
• カスタムエージェントが有効になっている。

エージェントの表示レベル

カスタムエージェントを作成する際、管理するプロジェクトを選択し、そのエージェントが公開、非公開、または制限付きのいずれであるかを決定します。

公開エージェント:

• 誰でも閲覧でき、前提条件を満たすすべてのプロジェクトで有効にできます。

制限付きエージェント:

• 管理プロジェクトのトップレベルグループ内のすべてのプロジェクトのメンバーが閲覧および使用できます。
• 同じトップレベルグループ内の他のプロジェクトで有効にできます。
• そのトップレベルグループの外では閲覧または有効にできません。
• ExploreのAIカタログでは閲覧できません。
• プロジェクトからのみ作成でき、ExploreのAIカタログからは作成できません。

そのトップレベルグループ外のプロジェクトによって有効にされている場合、公開エージェントを制限付きにすることはできません。

非公開エージェント:

• ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持つ管理プロジェクトのメンバーのみが閲覧できます。
• 管理対象プロジェクト以外のプロジェクトでは有効にできません。

管理プロジェクト以外のプロジェクトによって有効にされている場合、公開エージェントまたは制限付きエージェントを非公開にすることはできません。

プロジェクトのエージェントを表示する

前提条件:

• プロジェクトのデベロッパー、メンテナー、またはオーナーロールが必要です。

プロジェクトに関連付けられたエージェントのリストを表示するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 左側のサイドバーで、AI > エージェントを選択します。
   • プロジェクトで有効になっているエージェントを表示するには、有効タブを選択します。
   • プロジェクトで管理されているエージェントを表示するには、管理中タブを選択します。

エージェントを選択すると、その詳細を確認できます。

エージェントを作成する

プロジェクトから、またはAIカタログを使用して、エージェントを作成できます。

前提条件:

• プロジェクトのメンテナーまたはオーナーロールが必要です。

エージェントがAIカタログに表示されます。エージェントをChatで使用するには、エージェントを有効にする必要があります。

エージェントを有効にする

Chatでエージェントを使用するには、エージェントを有効にします。

プロジェクトでエージェントを有効にすると、そのプロジェクトのトップレベルグループでも同時に有効になります。

前提条件:

• プロジェクトのメンテナーまたはオーナーロールが必要です。

エージェントが、グループとプロジェクトのAI > エージェントページに表示されます。トップレベルグループ内にある任意のプロジェクトのメンバーは、そのプロジェクトでエージェントを有効にできるようになります。

プロジェクトで、エージェントとの新しいチャットを開始できます。詳細については、エージェントを選択するを参照してください。

プロジェクトで有効にする

エージェントがトップレベルグループで既に有効になっている場合、そのグループのプロジェクトでエージェントを有効にできます。

前提条件:

• プロジェクトのメンテナーまたはオーナーロールが必要です。
• プロジェクトのトップレベルグループでエージェントを有効にする必要があります。

プロジェクトでエージェントを有効にするには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 左側のサイドバーで、AI > エージェントを選択します。
3. 右上隅で、グループからのエージェントを有効にするを選択します。
4. ドロップダウンリストから、有効にするエージェントを選択します。
5. 有効を選択します。

エージェントが、プロジェクトのAI > エージェントページに表示されます。

プロジェクトで、エージェントとの新しいチャットを開始できます。

エージェントを使用する

GitLab UI、VS Code、およびJetBrains IDEでカスタムエージェントを使用できます。

GitLab UIの場合

前提条件:

• エージェントを使用するプロジェクトで、そのエージェントを有効にしている。

GitLab UIでカスタムエージェントを使用するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。

2. イシュー、エピック、またはマージリクエストを開きます。

3. GitLab Duoサイドバーで、新しいチャットを追加（ ）を選択します。

4. ドロップダウンリストから、カスタムエージェントを選択します。

   画面右側のGitLab Duoサイドバーに、Chatの会話が表示されます。

5. 質問またはリクエストを入力します。

VS Codeの場合

前提条件:

• エージェントを使用するプロジェクトで、そのエージェントを有効にしている。
• GitLab for VS Codeバージョン6.47.0以降をインストールして設定している。
• デフォルトのGitLab Duoネームスペースを設定している。

VS Codeでカスタムエージェントを使用するには:

1. VS Codeの左側のサイドバーで、GitLab Duo Agent Platform（ ）を選択します。
2. Chatタブを選択します。
3. New chat（ ）ドロップダウンリストからカスタムエージェントを選択します。
4. 質問またはリクエストを入力します。

JetBrains IDEの場合

前提条件:

• エージェントを使用するプロジェクトで、そのエージェントを有効にしている。
• JetBrains IDE用GitLab Duoプラグインバージョン3.19.0以降をインストールして設定している。
• デフォルトのGitLab Duoネームスペースを設定している。

まず、GitLab Duo Agent Platformを有効にします:

1. JetBrains IDEで、Settings > Tools > GitLab Duoに移動します。
2. GitLab Duo Agent Platformで、Enable GitLab Duo Agent Platformチェックボックスを選択します。
3. プロンプトが表示されたら、IDEを再起動します。

次に、カスタムエージェントを使用するには:

1. JetBrains IDEの右側のツールウィンドウバーで、GitLab Duo Agent Platform（ ）を選択します。
2. Chatタブを選択します。
3. New chat（ ）ドロップダウンリストからカスタムエージェントを選択します。
4. 質問またはリクエストを入力します。

エージェントを無効にする

前提条件:

• グループの場合、メンテナーまたはオーナーロールが必要です。
• プロジェクトの場合、メンテナーまたはオーナーロールが必要です。

エージェントを無効にするには:

1. 上部のバーで検索または移動先を選択し、グループまたはプロジェクトを見つけます。
2. AI > エージェントを選択します。
3. 削除するエージェントを見つけて、アクション（ ）> 無効を選択します。
4. 確認ダイアログで、無効を選択します。

エージェントはプロジェクトに表示されなくなり、Chatで使用できなくなります。

エージェントを複製する

元のエージェントを上書きせずに変更を加えるには、既存のエージェントのコピーを作成します。

前提条件:

• プロジェクトのメンテナーまたはオーナーロールが必要です。

エージェントを複製するには:

1. 上部のバーで、検索または移動先 > 検索を選択します。
2. AIカタログを選択し、次にエージェントタブを選択します。
3. 複製するエージェントを選択します。
4. 右上隅で、アクション（ ）> 複製を選択します。
5. オプション。変更するフィールドを編集します。
6. エージェントを作成を選択します。

エージェントを編集する

エージェントを編集して設定を変更します。

前提条件:

• 管理プロジェクトのメンバーであり、メンテナーまたはオーナーロールが必要です。

1. 上部のバーで検索または移動先を選択し、グループまたはプロジェクトを見つけます。
2. AI > エージェントを選択します。
3. 編集するエージェントを選択します。
4. 右上隅で、編集を選択します。
5. 変更するフィールドを編集し、変更を保存を選択します。

エージェントを非表示にする

エージェントを非表示にして、AIカタログから削除します。

エージェントを非表示にすると、ユーザーはそのエージェントを有効にできなくなります。ただし、エージェントが既に有効になっているグループやプロジェクトでは、引き続きそのエージェントを操作できます。

前提条件:

• 管理プロジェクトのメンバーであり、メンテナーまたはオーナーロールが必要です。

エージェントを非表示にするには:

1. 上部のバーで検索または移動先を選択し、グループまたはプロジェクトを見つけます。
2. AI > エージェントを選択します。
3. 非表示にするエージェントを見つけて、アクション（ ）> 非表示を選択します。
4. 確認ダイアログで、確認を選択します。

エージェントを削除する

エージェントを削除して、インスタンスから完全に削除します。

前提条件:

• 管理者である必要があります。

1. 上部のバーで検索または移動先を選択し、グループまたはプロジェクトを見つけます。
2. AI > エージェントを選択します。
3. 削除するエージェントを見つけて、アクション（ ）> 削除を選択します。
4. 確認ダイアログで、削除を選択します。

カスタムエージェントをオンまたはオフにする

デフォルトでは、カスタムエージェントはオンになっています。トップレベルグループまたはインスタンスでオン/オフを切り替えることができます。

カスタムエージェントがオフになっている場合:

• ユーザーはカスタムエージェントを作成、有効化、無効化、または実行できません。
• 既存のカスタムエージェントは、プロジェクトのAI > エージェント > 有効に表示されなくなります。
• プロジェクトで作成されたカスタムエージェントは、AI > エージェント > 管理中に表示されますが、実行できません。
• 基本エージェントと外部エージェントは引き続き利用可能です。