カスタムエージェント

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

エージェントとやり取りする準備ができたら、それを有効にして、GitLab UI、VS Code、およびJetBrains IDEでGitLab Duo Chatとともに使用を開始してください。

前提条件

• GitLab Duo Agent Platformの前提条件を満たしていること。
• カスタムエージェントがオンになっている必要があります。

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

カスタムエージェントを作成する際は、そのエージェントを管理するプロジェクトを選択し、エージェントを公開または非公開のどちらにするかを選択します。

公開エージェント:

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

非公開エージェント:

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

エージェントが現在有効になっている場合、公開エージェントを非公開にすることはできません。

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

前提条件:

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

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

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の場合

前提条件:

• エージェントを使用したいプロジェクトで有効にします。
• バージョン6.47.0以降のVS Code用GitLabをインストールして設定します。
• デフォルトの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 > エージェント > 管理中に表示されますが、実行できません。
• 基本エージェントと外部エージェントは引き続き利用可能です。