Overview

The GitHub connector for Gemini Enterprise lets you perform create, update, and read operations on GitHub data.

Supported actions

When the GitHub data store is enabled, you can use natural language commands in Gemini Enterprise to perform GitHub actions.

The following GitHub actions that modify data are supported by the data store. Additional read-only actions are also available for tasks like searching and fetching context.

Action Description
Add comment to pending review Add a review comment to your latest pending pull request review.
Add issue comment Add a comment to a specific issue or pull request.
Create branch Create a new branch in a repository.
Create or update file Create or update a single file in a repository.
Fork repository Fork a repository to your account or a specified organization.
Merge pull request Merge a pull request.
Push files Push multiple files to a repository in a single commit.
Reply to pull request comment Add a reply to an existing pull request comment.
Star repository Star a repository on behalf of the authenticated user.
Trigger Actions workflow Trigger a GitHub Actions workflow (run, cancel, or rerun jobs).
Triage issue Update labels, assignees, or state on an issue.
Unstar repository Unstar a repository on behalf of the authenticated user.
Update pull request Update an existing pull request.
Write discussion comment Add, reply to, update, delete, or mark/unmark as answer a discussion comment.
Write GitHub project Create or update GitHub Projects (project, items, fields, status updates).
Write issue Create or update an issue in a repository.
Write repository label Create, update, or delete a label on a repository.

Required permissions

To enable Gemini Enterprise to perform search using the GitHub data store, you need the following permissions:

Permission Name Permission Type Reason for Access
Repository: Actions Read and write Trigger, list, cancel, and rerun workflow runs; access job logs
Repository: Administration Read-only List repository collaborators
Repository: Contents Read and write Read files, commits, branches, tags, and releases; create branches, write files, push commits, and fork repositories
Repository: Discussions Read and write Read GitHub Discussions and discussion categories; add, update, or delete discussion comments
Repository: Issues Read and write Read issues, labels, comments, and search issues; create or update issues, post comments, triage issues, and manage labels
Repository: Metadata Read-only (Mandatory) Search for repositories and users
Repository: Pull requests Read and write Read pull requests, diffs, and PR comments; merge, update, and add review comments and replies
Repository: Code scanning alerts Read-only Read code scanning alerts
Repository: Dependabot alerts Read-only Read Dependabot security alerts
Repository: Secret scanning alerts Read-only Read secret scanning alerts
Organization: Members Read-only View organization teams and their members
Organization: Issue Types Read-only View organization issue types
Organization: Projects Read and write Read and manage organization-level Projects v2 (projects, items, fields, and status updates)
Account: Starring Read and write Star and unstar repositories
Account: Profile Read and write Access user profile information

For information on how to configure these permissions, see Set permissions and obtain client ID and client secret.

Limitations

This section outlines known issues and limitations that may affect your use of the GitHub data store.

  • When creating a new app or adding a data store to an existing one, it's recommended to associate only one data store with actions belonging to a single connector type.
  • Enforcing a VPC Service Controls perimeter on existing GitHub data stores is not supported. To enforce VPC Service Controls, you must delete and recreate the data stores. For more information on VPC Service Controls and how to use actions after enabling VPC Service Controls, see Secure your app with VPC Service Controls.
  • The GitHub data store is supported only in the global, us, and eu locations.

What's next