Help us learn about your current experience with the documentation. Take the survey.
Agent tools
The following tools are available to custom agents.
Tools available in the Web UI and IDE
| Name | Tool | Description |
|---|---|---|
| Add New Task | add_new_task | Add a task. |
| Build Review Merge Request Context | build_review_merge_request_context | Build comprehensive merge request context for code review. |
| CI Linter | ci_linter | Validate CI/CD YAML configurations against CI/CD syntax rules. |
| Confirm Vulnerability | confirm_vulnerability | Change the state of a vulnerability in a project to CONFIRMED. |
| Create Commit | create_commit | Create a commit with multiple file actions in a repository. |
| Create Epic | create_epic | Create epics in a group. |
| Create Issue | create_issue | Create issues in a project. |
| Create Issue Note | create_issue_note | Add notes to an issue. |
| Create Merge Request | create_merge_request | Create merge requests in a project. |
| Create Merge Request Diff Note | create_merge_request_diff_note | Add inline diff notes to a merge request. Quick actions are not supported. |
| Create Merge Request Note | create_merge_request_note | Add notes to a merge request. Quick actions are not supported. |
| Create Plan | create_plan | Create a list of tasks. |
| Create Vulnerability Issue | create_vulnerability_issue | Create an issue linked to security vulnerabilities in a project. |
| Create Work Item | create_work_item | Create a work item in a group or project. Quick actions are not supported. |
| Create Work Item Note | create_work_item_note | Add a note to a work item. Quick actions are not supported. |
| Dismiss Vulnerability | dismiss_vulnerability | Dismiss a security vulnerability in a project. |
| Extract Lines From Text | extract_lines_from_text | Extract specific lines from text. |
| Get Commit | get_commit | Get a commit from a project. |
| Get Commit Comments | get_commit_comments | Get the comments of a commit in a project. |
| Get Commit Diff | get_commit_diff | Get the diff of a commit in a project. |
| Get Current User | get_current_user | Get the following information about the current user: username, job title, and preferred languages. |
| Get Epic | get_epic | Get an epic in a group. |
| Get Epic Note | get_epic_note | Get a note from an epic. |
| Get Issue | get_issue | Get an issue from a project. |
| Get Issue Note | get_issue_note | Get a note from an issue. |
| Get Job Logs | get_job_logs | Get the trace for a job. |
| Get Merge Request | get_merge_request | Get details about a merge request. |
| Get Pipeline Errors | get_pipeline_errors | Get the logs for failed jobs from the latest pipeline of a merge request. |
| Get Pipeline Failing Jobs | get_pipeline_failing_jobs | Get the IDs for failed jobs in a pipeline. |
| Get Plan | get_plan | Get a list of tasks. |
| Get Previous Session Context | get_previous_session_context | Get context from a previous session. |
| Get Project | get_project | Get details about a project. |
| Get Repository File | get_repository_file | Get the contents of a file from a remote repository. |
| Get Security Finding Details | get_security_finding_details | Get the details of a potential vulnerability by its ID and the ID of the pipeline scan that identified it. |
| Get Vulnerability Details | 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. |
| Get Wiki Page | get_wiki_page | Get a wiki page from a project or group, including all its comments. |
| Get Work Item | get_work_item | Get a work item from a group or project. |
| Get Work Item Notes | get_work_item_notes | Get all notes for a work item. |
| Get Work Item Statuses | get_work_item_statuses | Get the available work item statuses for a group or project. |
| GitLab API Get | gitlab_api_get | Make read-only GET requests to any REST API endpoint. |
| GitLab Blob Search | gitlab_blob_search | Search 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 Search | gitlab_commit_search | Search for commits in a project or group. |
| GitLab Documentation Search | gitlab_documentation_search | Search the GitLab documentation for information. |
| GitLab GraphQL | gitlab_graphql | Execute read-only GraphQL queries against the GraphQL API. |
| GitLab Group Project Search | gitlab_group_project_search | Search for projects in a group. |
| GitLab Issue Search | gitlab_issue_search | Search for issues in a project or group. |
| GitLab Merge Request Search | gitlab_merge_request_search | Search for merge requests in a project or group. |
| GitLab Milestone Search | gitlab_milestone_search | Search for milestones in a project or group. |
| GitLab Note Search | gitlab_note_search | Search for notes in a project. |
| GitLab User Search | gitlab__user_search | Search for users in a project or group. |
| GitLab Wiki Blob Search | gitlab_wiki_blob_search | Search the contents of wikis in a project or group. |
| Link Vulnerability To Issue | link_vulnerability_to_issue | Link an issue to security vulnerabilities in a project. |
| Link Vulnerability To Merge Request | link_vulnerability_to_merge_request | Link a security vulnerability to a merge request in a project using GraphQL. |
| List All Merge Request Notes | list_all_merge_request_notes | List all notes on a merge request. |
| List Commits | list_commits | List commits in a project. |
| List Epic Notes | list_epic_notes | List all notes for an epic. |
| List Epics | list_epics | List all epics of a group and its subgroups. |
| List Group Audit Events | list_group_audit_events | List audit events for a group. You must have the Owner role to access group audit events. |
| List Instance Audit Events | list_instance_audit_events | List instance-level audit events. You must be an administrator to see instance audit events. |
| List Issue Notes | list_issue_notes | List all notes on an issue. |
| List Issues | list_issues | List all issues in a project. |
| List Merge Request Diffs | list_merge_request_diffs | List the diffs of changed files in a merge request. |
| List Project Audit Events | list_project_audit_events | List audit events for a project. You must have the Owner role to access project audit events. |
| List Repository Tree | list_repository_tree | List files and directories in a repository. |
| List Security Findings | list_security_findings | List ephemeral security findings from a specific pipeline security scan. |
| List Vulnerabilities | list_vulnerabilities | List security vulnerabilities in a project. |
| List Work Items | list_work_items | List work items in a project or group. |
| Post GitLab Duo Code Review | post_duo_code_review | Post a GitLab Duo code review to a merge request. |
| Post SAST FP Analysis To GitLab | post_sast_fp_analysis_to_gitlab | Post SAST false positive detection analysis results. |
| Remove Task | remove_task | Remove a task from a list of tasks. |
| Revert To Detected Vulnerability | revert_to_detected_vulnerability | Revert a vulnerability’s state to detected. |
| Run GLQL Query | run_glql_query | Execute GLQL queries for work items, epics, and merge requests. |
| Run Tests | run_tests | Execute test commands for any language or framework. |
| Set Task Status | set_task_status | Set the status of a task. |
| Update Epic | update_epic | Update an epic in a group. |
| Update Issue | update_issue | Update an issue in a project. |
| Update Merge Request | update_merge_request | Update a merge request. You can change the target branch, edit the title, or even close the MR. |
| Update Task Description | update_task_description | Update the description of a task. |
| Update Vulnerability Severity | update_vulnerability_severity | Update the severity level of vulnerabilities in a project. |
| Update Work Item | update_work_item | Update an existing work item in a group or project. Quick actions are not supported. |
Tools available in the IDE only
| Name | Tool | Description |
|---|---|---|
| Create File With Contents | create_file_with_contents | Create a file and write content to it. |
| Edit File | edit_file | Edit existing files. |
| Find Files | find_files | Recursively find files in a project. |
| Grep | grep | Recursively search for text patterns in files. This tool respects .gitignore file rules. |
| List Dir | list_dir | List files in a directory relative to the root of the project. |
| Mkdir | mkdir | Create a directory in the current working tree. |
| Read File | read_file | Read the contents of a file. |
| Read Files | read_files | Read the contents of files. |
| Run Command | run_command | Run bash commands in the current working directory. Git commands are not supported. |
| Run Git Command | run_git_command | Run Git commands in the current working directory. |