正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

カスタムエージェント

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

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

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

前提条件

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

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

公開エージェント:

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

非公開エージェント:

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

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

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

前提条件:

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

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

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

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

エージェントを作成する

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

前提条件:

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

エージェントを作成するには:

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

  2. 自動化 > エージェントを選択します。

  3. 新しいエージェントを選択します。

  4. 基本情報で、次の操作を行います:

    1. 表示名に、エージェントの名前を入力します。
    2. 説明に、エージェントの説明を入力します。

  5. 表示レベルとアクセスの下にある表示レベルで、非公開または公開を選択します。

  6. プロンプトの下にあるシステムプロンプトに、エージェントの特性、専門知識、動作を定義するプロンプトを入力します。

  7. オプション。利用可能なツールの下にあるツールドロップダウンリストから、エージェントがアクセスできるツールを選択します。たとえば、エージェントにイシューを自動的に作成させるには、イシューを作成を選択します。

    一部のツールはIDE拡張機能を必要とし、Web UIでは利用できません。詳細については、エージェントツールのリストを参照してください。

  8. エージェントを作成を選択します。

エージェントを作成するには:

  1. 上部のバーで、検索または移動先 > 検索を選択します。

  2. AIカタログを選択し、次にエージェントタブを選択します。

  3. 新しいエージェントを選択します。

  4. 基本情報で、次の操作を行います:

    1. 表示名に、エージェントの名前を入力します。
    2. 説明に、エージェントの説明を入力します。

  5. 表示レベルとアクセスで、次の操作を行います:

    1. 管理元ドロップダウンリストから、エージェントのプロジェクトを選択します。
    2. 表示レベルで、非公開または公開を選択します。

  6. プロンプトの下にあるシステムプロンプトに、エージェントの特性、専門知識、動作を定義するプロンプトを入力します。

  7. オプション。利用可能なツールの下にあるツールドロップダウンリストから、エージェントがアクセスできるツールを選択します。たとえば、エージェントにイシューを自動的に作成させるには、イシューを作成を選択します。

    利用可能なツールのリストについては、組み込みツールの定義を参照してください。

  8. エージェントを作成を選択します。

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

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

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

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

前提条件:

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

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

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 自動化 > エージェントを選択します。
  3. 管理中タブを選択し、有効にするエージェントを選択します。
  4. 右上隅で有効を選択します。
  5. プロジェクトの下で、エージェントを有効にするプロジェクトを選択します。
  6. 有効化を選択します。

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

  1. 上部のバーで、検索または移動先 > 検索を選択します。
  2. AIカタログを選択し、次にエージェントタブを選択します。
  3. 有効にするエージェントを選択します。
  4. 右上隅で有効を選択します。
  5. プロジェクトの下で、エージェントを有効にするプロジェクトを選択します。
  6. 有効化を選択します。

エージェントは、グループおよびプロジェクトの自動化 > エージェントページに表示されます。トップレベルグループ内の任意のプロジェクトのメンバーは、自分のプロジェクトでエージェントを有効にできるようになりました。

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

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

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

前提条件:

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

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

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

エージェントは、プロジェクトの自動化 > エージェントページに表示されます。

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

エージェントの使用

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

GitLab UIの場合

前提条件:

  • エージェントを使用したいプロジェクトで有効にします。

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

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

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

  3. GitLab Duoサイドバーで、新しいチャットを追加 ( pencil-square ) を選択します。

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

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

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

VS Codeで

前提条件:

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

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

JetBrains IDEで

前提条件:

まず、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 ( duo-agentic-chat ) を選択します。
  2. Chatタブを選択します。
  3. New chat ( duo-chat-new ) ドロップダウンリストからカスタムエージェントを選択します。
  4. 質問またはリクエストを入力します。

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

前提条件:

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

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

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

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

エージェントを複製する

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

前提条件:

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

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

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

エージェントを編集する

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

前提条件:

  • 管理プロジェクトのメンバーであり、メンテナーまたはオーナーのロールが必要です。
  1. トップバーで検索または移動先を選択し、グループまたはプロジェクトを見つけます。
  2. 自動化 > エージェントを選択します。
  3. 編集したいエージェントを選択します。
  4. 右上隅で、編集を選択します。
  5. 変更するフィールドを編集し、変更を保存を選択します。

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

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

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

前提条件:

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

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

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

エージェントを削除する

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

前提条件:

  • 管理者である必要があります。
  1. トップバーで検索または移動先を選択し、グループまたはプロジェクトを見つけます。
  2. 自動化 > エージェントを選択します。
  3. 削除したいエージェントを見つけて、アクション ( ellipsis_v ) > 削除を選択します。
  4. 確認ダイアログで、削除を選択します。