云效 AI 助手使用指南

更新时间:
复制 MD 格式

云效 AI 助手贯穿 DevOps 全流程,覆盖需求设计、测试设计、代码评审、构建部署、定时任务等环节。通过自然语言交互即可完成内容补全、问题发现、配置生成、结论提炼等操作,减少重复性工作。本文介绍 AI 助手的功能概览、开通配置、计费规则,并提供 6 个典型使用场景的操作示例。

功能概览

适用场景速览

环节

典型痛点

AI 助手价值

需求设计

需求描述不完整、验收标准难写;原始信息松散,散落于聊天记录、会议纪要、邮件等各处,难以直接形成可执行的需求

快速补全需求、生成验收项;拆分/整合零散信息,生成结构清晰、可落地的新需求

测试设计

写用例耗时、覆盖不全

基于需求自动生成测试用例

代码质量

人工 Review 成本高、容易遗漏,问题定位慢;检测出的问题较多时,手工修复耗时

自动发现风险点、定位根因并给出修复建议;对批量或典型问题支持一键/智能修复

构建部署

YAML 编写繁琐、报错难排查

自然语言生成/优化流水线、定位失败原因

定时任务

日报/周报重复手工整理、容易遗漏

按自然语言描述自动生成并定时推送报告

如何找到 AI 助手

云效 AI 助手主要有两个入口:

  • 全局入口:云效页面顶部有 AI 助手图标,单击即可唤起 AI 助手会话,随时提问。

  • 场景化入口:云效多个页面提供了场景化的 AI 功能按钮(如工作项、代码评审、流水线编辑页等),单击后会唤起 AI 助手会话,并自动准备好对应场景的提示词,可快速开始操作。

使用前准备

管理员开通与权限配置

云效 AI 助手默认全员不可用,需要组织管理员先开通并配置可用范围:

  1. 进入管理后台:组织管理员登录云效,进入管理后台

  2. 开通 AI 助手:进入管理后台,找到 AI 助手相关设置,完成开通。

  3. 设置可用用户:默认不开放给任何成员,管理员需手动设置哪些用户可以使用 AI 助手(暂不支持按角色赋权)。

说明

如果单击 AI 助手入口后提示无权限,需联系组织管理员确认是否已开通并配置使用权限。

计费规则

云效 AI 助手使用的是 StarOps(全域智能运维平台)的核心能力,计费由 StarOps 统一处理:

  • 计量单位:积分(AI_Credits)。

  • 查看消耗:组织管理员可前往云效 管理后台 > 智能化用量页面查看 AI 助手的积分消耗情况。单击查看资源明细可查看详细的积分使用记录,支持时间范围筛选和导出 CSV。

  • 账单出处:账单由 StarOps 出具,具体计费规则参考StarOps 计费说明

  • 消耗参考

    • 代码评审(如合并请求 AI 评审)一次大约消耗 100 积分。

    • 需求优化(如智能优化需求描述)一次大约消耗 50 积分。

说明

实际消耗会随输入长度、输出内容、调用次数等因素波动,建议以 管理后台 > 智能化用量页面显示为准。建议使用前让管理员了解积分消耗规则,避免产生意外费用。

使用约定

  • AI 助手基于当前上下文(当前项目、当前工作项、当前代码库等)回答问题。

  • 涉及敏感操作时,AI 仅提供建议,不会自动执行。

  • 提示词建议包含:目标、背景、输出格式、约束条件。

快速上手:6 个典型场景

每个场景按照"入口 → 示例任务 → 提示词示例 → 预期结果 → 下一步操作"展开,可直接参照操作。

需求设计:让 AI 帮助批量录入需求

适用入口:项目详情页 > 需求列表 > 单击智能录入需求

示例任务 1:产品经理已经写好 PRD 文档,里面包含多个功能点,需要拆分成需求录入云效,再转交开发团队。

示例任务 2:与客户交流后产生了一份会议记录文档,里面包含多个新需求,需要整理出来录入云效进行跟踪。

提示词示例

@具体项目名称 请帮我智能拆分需求

然后按照 AI 助手的提示,提供具体的文档。可以上传附件,也可以提供在线文档链接。

预期结果

  • AI 根据文档的标题和结构,拆分出多个需求条目。

  • AI 为每个需求生成标题和描述。

下一步:根据 AI 的提示,选择好需求类型、需求负责人、迭代等字段信息,然后开始正式导入。

需求设计:让 AI 帮助优化需求描述

适用入口:需求详情页 > 单击智能优化内容

示例任务:需求只填写了简单的描述,需要对内容和结构进行优化。

提示词示例

@具体的需求ID 请智能优化内容

预期结果

  • AI 识别需求描述中的缺失信息,补充背景和目标。

  • AI 优化内容结构,使需求更清晰、更易读。

  • AI 生成或完善验收标准。

下一步:查看优化后的内容,选择采纳全部或部分修改,必要时继续让 AI 调整。

测试设计:基于需求自动生成测试用例

适用入口:需求详情页 > 关联用例列表 > 单击智能生成用例

示例任务:已有一个需求工作项,需要快速生成覆盖正向、反向、边界场景的测试用例。

提示词示例

@具体需求ID 请智能生成测试用例

预期结果

  • 生成若干条用例标题。

  • 标注优先级(P0/P1/P2)。

  • 给出前置条件、操作步骤、预期结果。

下一步:一键导入测试用例,或选择部分用例保留。

代码质量:让 AI 辅助代码评审

适用入口:代码库 > 创建合并请求 > 单击请求 AI 评审

示例任务:提交了一个合并请求,想让 AI 先做一次代码评审。

使用方式

这个场景无需通过 AI 助手对话框提问。单击请求 AI 评审后,AI 助手会直接通过合并请求评论写下评审意见。可以继续通过评论追问 AI,让它解释某条意见或给出更详细的修改建议。

预期结果

  • AI 通过合并请求评论列出潜在 Bug 或风险点。

  • 给出代码风格、性能、安全等方面的优化建议。

  • 标注问题严重等级。

下一步:根据评审意见修改代码,或通过评论 @相关同事确认。

构建部署:让 AI 自动生成流水线

适用入口:流水线列表 > 单击智能创建流水线

示例任务 1:云效流水线的新用户,对流水线规则或 YAML 语法不太熟悉,想请 AI 协助快速生成一条流水线。

示例任务 2:团队之前使用 Jenkins 或 GitLab CI,现在打算迁移到云效,希望 AI 把现有的 CI 配置转换成云效流水线 YAML。

提示词示例

请帮忙创建一条流水线

预期结果

  • 生成一段可运行的云效流水线 YAML 草稿。

  • 说明每个阶段和步骤的作用。

  • 提示需要替换的参数(如镜像地址、环境变量、代码库地址)。

下一步:保存并运行流水线。如果遇到报错,单击智能排查,AI 会协助分析原因并给出修复方案,还可以自动修复流水线 YAML。

定时任务:让 AI 自动生成并推送报告

适用入口:云效工作台 > AI 助手任务

示例任务 1:每天早上自动发送某个项目的迭代进展报告。

示例任务 2:每周汇总项目的工时数据,形成周报并发送给团队。

创建方式有两种

方式一:直接在任务列表创建

前往云效工作台 > AI 助手任务列表,单击创建任务,设置好定时器,并用自然语言描述任务内容,例如:

每天早上 9 点,帮我生成项目 XXX 的昨日迭代进展报告,并发送到钉钉群 XXX。

方式二:先通过对话框跑通,再转成定时任务

  1. 打开云效 AI 助手

    帮我生成项目 XXX 昨日的迭代进展日报。
  2. 通过多轮对话调整报告内容、格式、数据范围,直到结果满意。

  3. 把这个报告做成每天早上 9 点自动执行的定时任务。

    预期结果

    • AI 助手生成一份符合要求的报告内容。

    • 设置好定时执行规则(如每天/每周、具体时间点)。

    • 指定发送目标(如 IM 群、邮件、站内消息等)。

下一步:前往AI 助手任务列表查看任务运行记录,确认定时任务正常执行;如需调整内容或时间,可随时编辑。