auto-review-github-action

This action is an automated review action using OpenAI or Azure OpenAI. It replies to a pull request with a summary of the pull request and suggestions for improvement.

This action requires an OpenAI API key.

Submission details

The pull request summary and suggestions for improvement will be posted in the pull request comments as follows

Usage

- uses: akiojin/auto-review-github-action@v1
  if: github.event_name == 'pull_request'
  continue-on-error: true
  with:
    openai-api-key: ${{ secrets.OPENAI_API_KEY }}
    target: 'ts,yml'

In this example, the review is performed when there is an update to *.ts or *.yml.

You must also add write permission to pull_requests in your permission settings.

permissions:
  pull-requests: write
  ...

Arguments

Name	Required	Type	Default	Description
`openai-api-key`	`true`	`string`		Specify the API key for OpenAI; for Azure OpenAI, specify the API key for Azure OpenAI.
`model`	`false`	`string`	`gpt-3.5-turbo`	Specifies the ChatGPT model to use; can be omitted if Azure OpenAI is used. Possible values are: `gpt-4`, `gpt-3.5`, `gpt-3.5-turbo`.
`github-token`	`true`	`string`	`${{ github.token }}`	Specify a GitHub token. By default, `${{ github.token }}` is specified.
`target`	`true`	`string`		Specify the extension of the file to be reviewed. If there are multiple files, specify them separated by commas. ex) `'md,txt,ts'`
`language`	`true`	`string`	`English`	Specify the language in which the comments will be written. This value should be specified in plain language. ex) 日本語
`resource-name`	`false`	`string`		Specify the resource name when using Azure OpenAI. The resource name corresponds to the in the URL of the Azure OpenAI resource. https://.openai.azure.com/
`deployment-id`	`false`	`string`		Specify a deployment name when using Azure OpenAI.
`optimize`	`false`	`boolean`	`true`	Specifies whether to optimize the review of pull requests. If optimized, only the differences from the parent commit are reviewed. If not optimized, all differences from the base branch are reviewed.

Notes

ChatGPT has a limit on the number of messages that can be sent at one time. Therefore, if there are significant changes, ChatGPT may return an error 400. In that case, review cannot be performed, so please use continue-on-error: true to allow the step to proceed even if an error occurs.

Review Optimization

You can optimize your pull request reviews. Optimization offers the following advantages

Only the differences can be reviewed.
Reduces the number of tokens used for OpenAI

Optimization is enabled by default.

If no optimization is performed, the review will always be a difference from the base branch, may contain similar reviews and consume more OpenAI tokens.