create_change_request_comment
Create comments on change requests, either globally on the entire merge request or inline on specific code lines with file path and line number.
Instructions
[Code Management] Create a comment on a change request. Supports two types: GLOBAL_COMMENT (global comment on the entire merge request) and INLINE_COMMENT (inline comment on specific code lines). For INLINE_COMMENT, you must provide file_path, line_number, from_patchset_biz_id, and to_patchset_biz_id parameters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organizationId | Yes | 组织ID,可在组织管理后台的基本信息页面获取。示例:'60d54f3daccf2bbd6659f3ad' | |
| repositoryId | Yes | 代码库ID或者URL-Encoder编码的全路径。示例:'2835387' 或 '60de7a6852743a5162b5f957%2FDemoRepo'(注意:斜杠需要URL编码为%2F) | |
| localId | Yes | 局部ID,表示代码库中第几个合并请求。示例:'1' 或 '42' | |
| comment_type | No | 评论类型。GLOBAL_COMMENT - 全局评论(对整个合并请求的评论);INLINE_COMMENT - 行内评论(针对特定代码行的评论)。创建行内评论时,必须提供 file_path、line_number、from_patchset_biz_id 和 to_patchset_biz_id 参数 | GLOBAL_COMMENT |
| content | Yes | 评论内容,长度必须在 1 到 65535 之间。示例:'This is a comment content.' 或 '这里需要优化性能,建议使用缓存机制' | |
| draft | No | 是否草稿评论。true - 草稿评论(不会立即显示给其他人);false - 正式评论(默认值) | |
| resolved | No | 是否标记已解决。true - 已解决;false - 未解决(默认值) | |
| patchset_biz_id | Yes | 关联版本ID,具有唯一性。对于全局评论,使用最新合并源版本ID;对于行内评论,选择 from_patchset_biz_id 或 to_patchset_biz_id 中的一个。示例:'bf117304dfe44d5d9b1132f348edf92e' | |
| file_path | No | 文件路径,仅行内评论需要。表示评论针对的文件路径。示例:'/src/main/java/com/example/MyClass.java' 或 'src/utils/helper.ts' 或 'frontend/components/Button.tsx' | |
| line_number | No | 行号,仅行内评论需要。表示评论针对的代码行号,从1开始计数。示例:42 表示第42行,100 表示第100行 | |
| from_patchset_biz_id | No | 比较的起始版本ID,行内评论类型必传。表示代码比较的起始版本(通常是目标分支版本,即合并目标对应的版本)。示例:'bf117304dfe44d5d9b1132f348edf92e' | |
| to_patchset_biz_id | No | 比较的目标版本ID,行内评论类型必传。表示代码比较的目标版本(通常是源分支版本,即合并源对应的版本)。示例:'537367017a9841738ac4269fbf6aacbe' | |
| parent_comment_biz_id | No | 父评论ID,用于回复评论。如果这是对某个评论的回复,需要传入被回复评论的 bizId。示例:'1d8171cf0cc2453197fae0e0a27d5ece' |