MCP Tools Reference: developerconnect.googleapis.com

Alat: add-repo-pull-request-review-comment

Menambahkan komentar ulasan (inline pada diff) ke permintaan pull.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP add-repo-pull-request-review-comment.

Permintaan Curl 
curl --location 'https://developerconnect.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "add-repo-pull-request-review-comment",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk AddGitRepositoryLinkPullRequestReviewComment.

AddGitRepositoryLinkPullRequestReviewCommentRequest

Representasi JSON 
{
  "name": string,
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Kolom
name

string

Wajib. Nama resource GitRepositoryLink dalam format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequestId

string

Wajib. ID Permintaan Pull.
comment

object (PullRequestReviewComment)

Wajib. Komentar ulasan yang akan ditambahkan.
commitId

string

Opsional. SHA commit yang akan diberi komentar. Jika tidak ditentukan, setelan defaultnya adalah commit HEAD dari Permintaan Pull.

PullRequestReviewComment

Representasi JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Kolom
id

string

Hanya output. ID komentar.
body

string

Wajib. Isi komentar.
path

string

Wajib. Jalur file yang akan dikomentari.
firstLine

integer

Opsional. Baris pertama rentang komentar (inklusif). Jika tidak ditentukan, komentar hanya berlaku untuk last_line.
lastLine

integer

Wajib. Baris terakhir rentang komentar (inklusif). Jika first_line tidak ditentukan, komentar hanya berlaku untuk baris ini.
side

enum (DiffSide)

Opsional. Sisi diff yang akan dikomentari. Default-nya adalah HEAD.
author

string

Hanya output. Nama pengguna penulis.
createTime

string (Timestamp format)

Hanya output. Waktu saat komentar dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Waktu saat komentar diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
commitId

string

Hanya output. SHA commit yang sebenarnya diterapkan pada komentar.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nano non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

DiffSide

DiffSide menunjukkan sisi diff tempat komentar berada.

Enum
DIFF_SIDE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
BASE Sisi diff sebelum perubahan (baris yang dihapus atau diubah).
HEAD Sisi diff setelah perubahan (baris yang ditambahkan atau diubah).

Skema Output

Pesan yang mewakili Komentar Peninjauan Permintaan Pull SCM (inline pada diff).

PullRequestReviewComment

Representasi JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Kolom
id

string

Hanya output. ID komentar.
body

string

Wajib. Isi komentar.
path

string

Wajib. Jalur file yang akan dikomentari.
firstLine

integer

Opsional. Baris pertama rentang komentar (inklusif). Jika tidak ditentukan, komentar hanya berlaku untuk last_line.
lastLine

integer

Wajib. Baris terakhir rentang komentar (inklusif). Jika first_line tidak ditentukan, komentar hanya berlaku untuk baris ini.
side

enum (DiffSide)

Opsional. Sisi diff yang akan dikomentari. Default-nya adalah HEAD.
author

string

Hanya output. Nama pengguna penulis.
createTime

string (Timestamp format)

Hanya output. Waktu saat komentar dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Waktu saat komentar diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
commitId

string

Hanya output. SHA commit yang sebenarnya diterapkan pada komentar.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nano non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

DiffSide

DiffSide menunjukkan sisi diff tempat komentar berada.

Enum
DIFF_SIDE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
BASE Sisi diff sebelum perubahan (baris yang dihapus atau diubah).
HEAD Sisi diff setelah perubahan (baris yang ditambahkan atau diubah).

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk tersebut dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim kepada pengguna.

Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan aditif. Default: true.
  • idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌