Skip to main content
Glama
aliyun

AlibabaCloud DevOps MCP Server

Official
by aliyun

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

TableJSON Schema
NameRequiredDescriptionDefault
organizationIdYes组织ID,可在组织管理后台的基本信息页面获取。示例:'60d54f3daccf2bbd6659f3ad'
repositoryIdYes代码库ID或者URL-Encoder编码的全路径。示例:'2835387' 或 '60de7a6852743a5162b5f957%2FDemoRepo'(注意:斜杠需要URL编码为%2F)
localIdYes局部ID,表示代码库中第几个合并请求。示例:'1' 或 '42'
comment_typeNo评论类型。GLOBAL_COMMENT - 全局评论(对整个合并请求的评论);INLINE_COMMENT - 行内评论(针对特定代码行的评论)。创建行内评论时,必须提供 file_path、line_number、from_patchset_biz_id 和 to_patchset_biz_id 参数GLOBAL_COMMENT
contentYes评论内容,长度必须在 1 到 65535 之间。示例:'This is a comment content.' 或 '这里需要优化性能,建议使用缓存机制'
draftNo是否草稿评论。true - 草稿评论(不会立即显示给其他人);false - 正式评论(默认值)
resolvedNo是否标记已解决。true - 已解决;false - 未解决(默认值)
patchset_biz_idYes关联版本ID,具有唯一性。对于全局评论,使用最新合并源版本ID;对于行内评论,选择 from_patchset_biz_id 或 to_patchset_biz_id 中的一个。示例:'bf117304dfe44d5d9b1132f348edf92e'
file_pathNo文件路径,仅行内评论需要。表示评论针对的文件路径。示例:'/src/main/java/com/example/MyClass.java' 或 'src/utils/helper.ts' 或 'frontend/components/Button.tsx'
line_numberNo行号,仅行内评论需要。表示评论针对的代码行号,从1开始计数。示例:42 表示第42行,100 表示第100行
from_patchset_biz_idNo比较的起始版本ID,行内评论类型必传。表示代码比较的起始版本(通常是目标分支版本,即合并目标对应的版本)。示例:'bf117304dfe44d5d9b1132f348edf92e'
to_patchset_biz_idNo比较的目标版本ID,行内评论类型必传。表示代码比较的目标版本(通常是源分支版本,即合并源对应的版本)。示例:'537367017a9841738ac4269fbf6aacbe'
parent_comment_biz_idNo父评论ID,用于回复评论。如果这是对某个评论的回复,需要传入被回复评论的 bizId。示例:'1d8171cf0cc2453197fae0e0a27d5ece'
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It notes the type constraint and required inline parameters but omits side effects like notification or permissions, which are important for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, front-loaded with the category, and contains no redundant information. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers basic usage for two comment types but does not explain the purpose of other parameters like draft, resolved, or parent_comment_biz_id, nor any side effects. For a complex tool with 13 parameters, more context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides full parameter descriptions, but the description adds meaningful usage constraints by specifying required parameters for inline comments, which is not explicit in the schema alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool creates a comment on a change request, specifies two types (GLOBAL_COMMENT and INLINE_COMMENT), and differentiates from sibling tools like create_commit_comment or create_work_item_comment by focusing on change request comments.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states when to use each comment type and lists required parameters for INLINE_COMMENT, providing clear context for usage. However, it does not explicitly exclude other scenarios or compare to alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aliyun/alibabacloud-devops-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server