MCP Tools Reference: developerconnect.googleapis.com

כלי: add-repo-pull-request-review-comment

הוספת הערת ביקורת (בתוך השורה ב-diff) לבקשת משיכה.

בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP‏ add-repo-pull-request-review-comment.

בקשת 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
}'

סכימת הקלט

הודעת בקשה ל-AddGitRepositoryLinkPullRequestReviewComment.

AddGitRepositoryLinkPullRequestReviewCommentRequest

ייצוג ב-JSON 
{
  "name": string,
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
שדות
name

string

חובה. שם המשאב של GitRepositoryLink בפורמט projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequestId

string

חובה. המזהה של בקשת משיכה (pull request).
comment

object (PullRequestReviewComment)

חובה. התגובה לביקורת שרוצים להוסיף.
commitId

string

זה שינוי אופציונלי. ה-SHA של ה-commit שעליו רוצים להגיב. אם לא מציינים את הפרמטר, ברירת המחדל היא ה-commit של ה-HEAD של בקשת משיכה (pull request).

PullRequestReviewComment

ייצוג ב-JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
שדות
id

string

פלט בלבד. המזהה של התגובה.
body

string

חובה. גוף התגובה.
path

string

חובה. נתיב הקובץ שרוצים להגיב עליו.
firstLine

integer

זה שינוי אופציונלי. השורה הראשונה בטווח התגובות (כולל). אם לא מציינים את זה, ההערה חלה רק על last_line.
lastLine

integer

חובה. השורה האחרונה בטווח התגובות (כולל). אם לא מציינים את first_line, ההערה חלה רק על השורה הזו.
side

enum (DiffSide)

זה שינוי אופציונלי. הצד של ההבדל שעליו רוצים להגיב. ברירת המחדל היא HEAD.
author

string

פלט בלבד. שם המשתמש של המחבר.
createTime

string (Timestamp format)

פלט בלבד. מתי התגובה נוצרה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. מתי התגובה עודכנה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
commitId

string

פלט בלבד. ה-SHA של ה-commit שהתגובה הוחלה עליו בפועל.

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (טווח שמתאים ל-‎0001-01-01T00:00:00Z עד ‎9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציה של ננו-שנייה. השדה הזה הוא החלק של הננו-שניות במשך הזמן, ולא חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שנספרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

DiffSide

השדה DiffSide מייצג את הצד של ההשוואה שבו נמצאת התגובה.

טיפוסים בני מנייה (enum)
DIFF_SIDE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
BASE הצד של ההשוואה לפני השינויים (שורות שנמחקו או שונו).
HEAD הצד של ההשוואה אחרי השינויים (שורות שנוספו או שונו).

סכימת הפלט

הודעה שמייצגת הערה על בדיקה של בקשת משיכה ב-SCM (בתוך השורה ב-diff).

PullRequestReviewComment

ייצוג ב-JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
שדות
id

string

פלט בלבד. המזהה של התגובה.
body

string

חובה. גוף התגובה.
path

string

חובה. נתיב הקובץ שרוצים להגיב עליו.
firstLine

integer

זה שינוי אופציונלי. השורה הראשונה בטווח התגובות (כולל). אם לא מציינים את זה, ההערה חלה רק על last_line.
lastLine

integer

חובה. השורה האחרונה בטווח התגובות (כולל). אם לא מציינים את first_line, ההערה חלה רק על השורה הזו.
side

enum (DiffSide)

זה שינוי אופציונלי. הצד של ההבדל שעליו רוצים להגיב. ברירת המחדל היא HEAD.
author

string

פלט בלבד. שם המשתמש של המחבר.
createTime

string (Timestamp format)

פלט בלבד. מתי התגובה נוצרה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. מתי התגובה עודכנה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
commitId

string

פלט בלבד. ה-SHA של ה-commit שהתגובה הוחלה עליו בפועל.

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (טווח שמתאים ל-‎0001-01-01T00:00:00Z עד ‎9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציה של ננו-שנייה. השדה הזה הוא החלק של הננו-שניות במשך הזמן, ולא חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שנספרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

DiffSide

השדה DiffSide מייצג את הצד של ההשוואה שבו נמצאת התגובה.

טיפוסים בני מנייה (enum)
DIFF_SIDE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
BASE הצד של ההשוואה לפני השינויים (שורות שנמחקו או שונו).
HEAD הצד של ההשוואה אחרי השינויים (שורות שנוספו או שונו).

הערות לגבי הכלים

הערות הכלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כלא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש בקשה לאישור.

בנוסף למחרוזת הכותרת, הרמזים הבוליאניים הבאים מוגדרים כך:

  • ‫readOnlyHint: אם הערך הוא True, הכלי לא משנה את הסביבה שלו. ברירת המחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא False, הכלי יכול לבצע רק פעולות הוספה. ברירת המחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת המחדל: false.
  • ‫openWorldHint: אם הערך הוא True, הכלי יכול לקיים אינטראקציה עם "עולם פתוח" של ישויות חיצוניות. אם הערך הוא false, הכלי יכול לקיים אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי חיפוש באינטרנט הוא כלי בעולם פתוח, אבל כלי זיכרון הוא לא כלי בעולם פתוח.

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