Agent tools

The following tools are available to custom agents.

Name	Description
Gitlab Blob Search	Search for the contents of files in a group or project.
Ci Linter	Validate CI/CD YAML configurations against CI/CD syntax rules.
Run Git Command	Run Git commands in the current working directory.
Gitlab Commit Search	Search for commits in a project or group.
Create Epic	Create epics in a group.
Create Issue	Create issues in a project.
Create Issue Note	Add notes to an issue.
Create Merge Request	Create merge requests in a project.
Create Merge Request Note	Add notes to a merge request. Quick actions are not supported.
Edit File	Edit existing files.
Find Files	Recursively find files in a project.
Get Commit	Get a commit from a project.
Get Commit Comments	Get the comments of a commit in a project.
Get Commit Diff	Get the diff of a commit in a project.
Get Epic	Get an epic in a group.
Get Epic Note	Get a note from an epic.
Get Issue	Get an issue from a project.
Get Issue Note	Get a note from an issue.
Get Job Logs	Get the trace for a job.
Get Merge Request	Get details about a merge request.
Get Pipeline Errors	Get the logs for failed jobs from the latest pipeline of a merge request.
Get Project	Get details about a project.
Get Repository File	Get the contents of a file from a remote repository.
Grep	Recursively search for text patterns in files. This tool respects `.gitignore` file rules.
Gitlab Group Project Search	Search for projects in a group.
Gitlab Issue Search	Search for issues in a project or group.
List All Merge Request Notes	List all notes on a merge request.
List Commits	List commits in a project.
List Dir	List files in a directory relative to the root of the project.
List Epic Notes	List all notes for an epic.
List Epics	List all epics of a group and its subgroups.
List Issue Notes	List all notes on an issue.
List Issues	List all issues in a project.
List Merge Request Diffs	List the diffs of changed files in a merge request.
Gitlab Merge Request Search	Search for merge requests in a project or group.
Gitlab Milestone Search	Search for milestones in a project or group.
Mkdir	Create a directory in the current working tree.
Gitlab Note Search	Search for notes in a project.
Read File	Read the contents of a file.
Run Command	Run bash commands in the current working directory. Git commands are not supported.
Set Task Status	Set the status of a task.
Update Epic	Update an epic in a group.
Update Issue	Update an issue in a project.
Update Merge Request	Update a merge request. You can change the target branch, edit the title, or even close the MR.
Gitlab User Search	Search for users in a project or group.
Gitlab Wiki Blob Search	Search the contents of wikis in a project or group.
Create File With Contents	Create a file and write content to it.
Gitlab Documentation Search	Search the GitLab documentation for information.
Get Current User	Get the following information about the current user: username, job title, and preferred languages.
Add New Task	Add a task.
Create Vulnerability Issue	Create an issue linked to security vulnerabilities in a project. You must specify the project by its full path. For example, ‘group/subgroup/project’. You can create an issue linked to vulnerabilities by ID. You can provide up to 100 IDs at once.
Read Files	Read the contents of files.
Get Work Item	Get a work item from a group or project. You must provide either the `group_id/project_id` and `work_item_iid`, or the URL to the work item.
Create Plan	Create a list of tasks.
Get Plan	Get a list of tasks.
Update Task Description	Update the description of a task.
Revert To Detected Vulnerability	Revert a vulnerability’s state to `detected`. You can provide an optional comment with a reason for reverting. You must identify the vulnerability by its ID.
Get Previous Session Context	Get context from a previous session.
List Repository Tree	List files and directories in a repository. To identify a project you must provide either a `project_id` or the URL to the project. You can specify a path to get contents of a subdirectory or a specific ref.
Create Work Item Note	Add a note to a work item. Quick actions are not supported.
Remove Task	Remove a task from a list of tasks. You must specify the task by its ID.
Update Vulnerability Severity	Update the severity level of vulnerabilities in a project. You must provide the full path of the project. You can provide an optional comment explaining the update.
List Project Audit Events	List audit events for a project. You must have the Owner role to access project audit events.
List Group Audit Events	List audit events for a group. You must have the Owner role to access group audit events.
Link Vulnerability To Issue	Link an issue to security vulnerabilities in a project. You must provide the full path of the project. You can provide up to 100 vulnerability IDs at once.
List Instance Audit Events	List instance-level audit events. You must be an administrator to see instance audit events.
Get Vulnerability Details	Get the following information about a vulnerability specified by ID: basic vulnerability information, location details, CVE enrichment data, detection pipeline information, and detailed vulnerability report data.
Dismiss Vulnerability	Dismiss a security vulnerability in a project. You must provide the full path of the project. You can provide an optional comment explaining the dismissal.
Confirm Vulnerability	Change the state of a vulnerability in a project to `CONFIRMED`.
Update Work Item	Update an existing work item in a group or project. Quick actions are not supported.
List Work Items	List work items in a project or group.
Create Commit	Create a commit with multiple file actions in a repository. To identify the project you must provide either a `project_id` the URL to the project. Actions include creating, updating, deleting, moving, or changing file permissions.
List Vulnerabilities	List security vulnerabilities in a project. You must provide the full project path. You can filter vulnerabilities by severity level and report type.
Get Work Item Notes	Get all notes for a work item. To identify a work item you must provide either a `group_id/project_id` and `work_item_iid`, or the URL to the work item.
Create Work Item	Create a work item in a group or project. Quick actions are not supported.
Get Wiki Page	Get a wiki page from a project or group, including all its comments. You must provide the slug of the wiki page and either the `project_id` or `group_id`.
Get Security Finding Details	Get the details of a potential vulnerability by its ID and the ID of the pipeline scan that identified it.
Gitlab Api Get	Make read-only GET requests to any REST API endpoint. Supports both direct API endpoint paths and resource URLs.
Gitlab Graphql	Execute read-only GraphQL queries against the GraphQL API.
Link Vulnerability To Merge Request	Link a security vulnerability to a merge request in a project using GraphQL. You must provide the full path of the project. The tool supports linking a vulnerability to a merge request by ID. The merge request ID is its global ID.
Get Pipeline Failing Jobs	Get the IDs for failed jobs in a pipeline. You can identify a specific pipeline ID, or ask for all failing jobs in a merge request.
Run Tests	Execute test commands for any language or framework.
Extract Lines From Text	Extract specific lines from text.
List Security Findings	List ephemeral security findings from a specific pipeline security scan.
Build Review Merge Request Context	Build comprehensive merge request context for code review. Fetches MR details, AI-reviewable diffs, and file contents.
Post Sast Fp Analysis To Gitlab	Post SAST false positive detection analysis results.
Post Duo Code Review	Post a GitLab Duo code review to a merge request.