MCP Tools Reference: developerconnect.googleapis.com

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

Aggiungi un commento di revisione (incorporato nella differenza) a una richiesta di pull.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP add-repo-pull-request-review-comment.

Richiesta 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
}'

Schema di input

Messaggio di richiesta per AddGitRepositoryLinkPullRequestReviewComment.

AddGitRepositoryLinkPullRequestReviewCommentRequest

Rappresentazione JSON 
{
  "name": string,
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Campi
name

string

Obbligatorio. Il nome risorsa di GitRepositoryLink nel formato projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequestId

string

Obbligatorio. L'ID della richiesta di pull.
comment

object (PullRequestReviewComment)

Obbligatorio. Il commento della recensione da aggiungere.
commitId

string

Facoltativo. Lo SHA del commit da commentare. Se non specificato, il valore predefinito è il commit HEAD della richiesta di pull.

PullRequestReviewComment

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

string

Solo output. L'ID del commento.
body

string

Obbligatorio. Il corpo del commento.
path

string

Obbligatorio. Il percorso del file da commentare.
firstLine

integer

Facoltativo. La prima riga dell'intervallo di commenti (inclusa). Se non specificato, il commento si applica solo a last_line.
lastLine

integer

Obbligatorio. L'ultima riga dell'intervallo di commenti (inclusa). Se first_line non è specificato, il commento si applica solo a questa riga.
side

enum (DiffSide)

Facoltativo. Il lato della differenza da commentare. Il valore predefinito è HEAD.
author

string

Solo output. Il nome utente dell'autore.
createTime

string (Timestamp format)

Solo output. Quando è stato creato il commento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Quando è stato aggiornato il commento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
commitId

string

Solo output. Lo SHA del commit a cui è stato effettivamente applicato il commento.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi dell'ora UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrisponde a un intervallo compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che avanzano nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

DiffSide

DiffSide rappresenta il lato della differenza su cui si trova il commento.

Enum
DIFF_SIDE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
BASE Il lato della differenza prima delle modifiche (righe eliminate o modificate).
HEAD Il lato della differenza dopo le modifiche (righe aggiunte o modificate).

Schema di output

Messaggio che rappresenta un commento alla revisione di una richiesta di pull SCM (incorporato nella differenza).

PullRequestReviewComment

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

string

Solo output. L'ID del commento.
body

string

Obbligatorio. Il corpo del commento.
path

string

Obbligatorio. Il percorso del file da commentare.
firstLine

integer

Facoltativo. La prima riga dell'intervallo di commenti (inclusa). Se non specificato, il commento si applica solo a last_line.
lastLine

integer

Obbligatorio. L'ultima riga dell'intervallo di commenti (inclusa). Se first_line non è specificato, il commento si applica solo a questa riga.
side

enum (DiffSide)

Facoltativo. Il lato della differenza da commentare. Il valore predefinito è HEAD.
author

string

Solo output. Il nome utente dell'autore.
createTime

string (Timestamp format)

Solo output. Quando è stato creato il commento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Quando è stato aggiornato il commento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
commitId

string

Solo output. Lo SHA del commit a cui è stato effettivamente applicato il commento.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi dell'ora UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrisponde a un intervallo compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che avanzano nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

DiffSide

DiffSide rappresenta il lato della differenza su cui si trova il commento.

Enum
DIFF_SIDE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
BASE Il lato della differenza prima delle modifiche (righe eliminate o modificate).
HEAD Il lato della differenza dopo le modifiche (righe aggiunte o modificate).

Annotazioni dello strumento

Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare un prompt di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

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