Agent tools

The following tools are available to custom agents.

Tools available in the Web UI and IDE

NameToolDescription
Add New Taskadd_new_taskAdd a task.
Build Review Merge Request Contextbuild_review_merge_request_contextBuild comprehensive merge request context for code review.
Ci Linterci_linterValidate CI/CD YAML configurations against CI/CD syntax rules.
Confirm Vulnerabilityconfirm_vulnerabilityChange the state of a vulnerability in a project to CONFIRMED.
Create Commitcreate_commitCreate a commit with multiple file actions in a repository.
Create Epiccreate_epicCreate epics in a group.
Create Issuecreate_issueCreate issues in a project.
Create Issue Notecreate_issue_noteAdd notes to an issue.
Create Merge Requestcreate_merge_requestCreate merge requests in a project.
Create Merge Request Notecreate_merge_request_noteAdd notes to a merge request. Quick actions are not supported.
Create Plancreate_planCreate a list of tasks.
Create Vulnerability Issuecreate_vulnerability_issueCreate an issue linked to security vulnerabilities in a project.
Create Work Itemcreate_work_itemCreate a work item in a group or project. Quick actions are not supported.
Create Work Item Notecreate_work_item_noteAdd a note to a work item. Quick actions are not supported.
Dismiss Vulnerabilitydismiss_vulnerabilityDismiss a security vulnerability in a project.
Extract Lines From Textextract_lines_from_textExtract specific lines from text.
Get Commitget_commitGet a commit from a project.
Get Commit Commentsget_commit_commentsGet the comments of a commit in a project.
Get Commit Diffget_commit_diffGet the diff of a commit in a project.
Get Current Userget_current_userGet the following information about the current user: username, job title, and preferred languages.
Get Epicget_epicGet an epic in a group.
Get Epic Noteget_epic_noteGet a note from an epic.
Get Issueget_issueGet an issue from a project.
Get Issue Noteget_issue_noteGet a note from an issue.
Get Job Logsget_job_logsGet the trace for a job.
Get Merge Requestget_merge_requestGet details about a merge request.
Get Pipeline Errorsget_pipeline_errorsGet the logs for failed jobs from the latest pipeline of a merge request.
Get Pipeline Failing Jobsget_pipeline_failing_jobsGet the IDs for failed jobs in a pipeline.
Get Planget_planGet a list of tasks.
Get Previous Session Contextget_previous_session_contextGet context from a previous session.
Get Projectget_projectGet details about a project.
Get Repository Fileget_repository_fileGet the contents of a file from a remote repository.
Get Security Finding Detailsget_security_finding_detailsGet the details of a potential vulnerability by its ID and the ID of the pipeline scan that identified it.
Get Vulnerability Detailsget_vulnerability_detailsGet 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.
Get Wiki Pageget_wiki_pageGet a wiki page from a project or group, including all its comments.
Get Work Itemget_work_itemGet a work item from a group or project.
Get Work Item Notesget_work_item_notesGet all notes for a work item.
GitLab API Getgitlab_api_getMake read-only GET requests to any REST API endpoint.
GitLab Blob Searchgitlab_blob_searchSearch for the contents of files in a group, project, or instance. To search across a group or in an instance, you must turn on either advanced or exact code search.
GitLab Commit Searchgitlab_commit_searchSearch for commits in a project or group.
GitLab Documentation Searchgitlab_documentation_searchSearch the GitLab documentation for information.
GitLab GraphQLgitlab_graphqlExecute read-only GraphQL queries against the GraphQL API.
GitLab Group Project Searchgitlab_group_project_searchSearch for projects in a group.
GitLab Issue Searchgitlab_issue_searchSearch for issues in a project or group.
GitLab Merge Request Searchgitlab_merge_request_searchSearch for merge requests in a project or group.
GitLab Milestone Searchgitlab_milestone_searchSearch for milestones in a project or group.
GitLab Note Searchgitlab_note_searchSearch for notes in a project.
GitLab User Searchgitlab__user_searchSearch for users in a project or group.
GitLab Wiki Blob Searchgitlab_wiki_blob_searchSearch the contents of wikis in a project or group.
Link Vulnerability To Issuelink_vulnerability_to_issueLink an issue to security vulnerabilities in a project.
Link Vulnerability To Merge Requestlink_vulnerability_to_merge_requestLink a security vulnerability to a merge request in a project using GraphQL.
List All Merge Request Noteslist_all_merge_request_notesList all notes on a merge request.
List Commitslist_commitsList commits in a project.
List Epic Noteslist_epic_notesList all notes for an epic.
List Epicslist_epicsList all epics of a group and its subgroups.
List Group Audit Eventslist_group_audit_eventsList audit events for a group. You must have the Owner role to access group audit events.
List Instance Audit Eventslist_instance_audit_eventsList instance-level audit events. You must be an administrator to see instance audit events.
List Issue Noteslist_issue_notesList all notes on an issue.
List Issueslist_issuesList all issues in a project.
List Merge Request Diffslist_merge_request_diffsList the diffs of changed files in a merge request.
List Project Audit Eventslist_project_audit_eventsList audit events for a project. You must have the Owner role to access project audit events.
List Repository Treelist_repository_treeList files and directories in a repository.
List Security Findingslist_security_findingsList ephemeral security findings from a specific pipeline security scan.
List Vulnerabilitieslist_vulnerabilitiesList security vulnerabilities in a project.
List Work Itemslist_work_itemsList work items in a project or group.
Post GitLab Duo Code Reviewpost_duo_code_reviewPost a GitLab Duo code review to a merge request.
Post SAST FP Analysis To GitLabpost_sast_fp_analysis_to_gitlabPost SAST false positive detection analysis results.
Remove Taskremove_taskRemove a task from a list of tasks.
Revert To Detected Vulnerabilityrevert_to_detected_vulnerabilityRevert a vulnerability’s state to detected.
Run GLQL Queryrun_glql_queryExecute GLQL queries for work items, epics, and merge requests.
Run Testsrun_testsExecute test commands for any language or framework.
Set Task Statusset_task_statusSet the status of a task.
Update Epicupdate_epicUpdate an epic in a group.
Update Issueupdate_issueUpdate an issue in a project.
Update Merge Requestupdate_merge_requestUpdate a merge request. You can change the target branch, edit the title, or even close the MR.
Update Task Descriptionupdate_task_descriptionUpdate the description of a task.
Update Vulnerability Severityupdate_vulnerability_severityUpdate the severity level of vulnerabilities in a project.
Update Work Itemupdate_work_itemUpdate an existing work item in a group or project. Quick actions are not supported.

Tools available in the IDE only

NameToolDescription
Create File With Contentscreate_file_with_contentsCreate a file and write content to it.
Edit Fileedit_fileEdit existing files.
Find Filesfind_filesRecursively find files in a project.
GrepgrepRecursively search for text patterns in files. This tool respects .gitignore file rules.
List Dirlist_dirList files in a directory relative to the root of the project.
MkdirmkdirCreate a directory in the current working tree.
Read Fileread_fileRead the contents of a file.
Read Filesread_filesRead the contents of files.
Run Commandrun_commandRun bash commands in the current working directory. Git commands are not supported.
Run Git Commandrun_git_commandRun Git commands in the current working directory.