产品文档

本译文为机器生成(测试版)。以英文指南为准。

受治理的自动化

Console Bots

在聊天中设计范围明确的 ArchiBot 任务、审查任务包,并由运维人员设置机器人策略、配置文件和蓝图,以决定机器人何时可以运行。

客户管理员平台运维人员

最近更新

安全示例数据中的 Bots 任务聊天标签和 Task packet 视图:显示团队、配置文件和源字段,以及 Overview、Source、Product 和 QA & save 标签。
安全示例数据:任务包会在保存草稿前收集机器人任务需要的信息。

Bots (/bots) 会将描述清楚且范围明确的更改转化为 ArchiBot 工作:“创建有边界的 ArchiBot 工作,在任何内容合并前完成 Console 合并事件、审查、QA 和人工批准。”机器人任务会记录代码库和分支、机器人可修改的路径,以及用于证明更改有效的 QA 备注。

保存任务不会合并代码。在为团队启用执行之前,会显示 Setup only标记;此时任务只是可供审查的记录。启用 Workspace handoff enabled后,Console 仍会先检查策略、配置文件、蓝图、并发运行限制和月度预算,然后才会启动工作区。

谁可以查看

  • 团队管理员可以为自己的团队起草和管理机器人工作。
  • 平台操作员和平台管理员可以为任何团队执行相同操作,并管理控制执行权限的Bot policy、Bot profiles和Blueprints。
  • 团队成员看不到 Bots。请让团队管理员起草任务。

各个标签

标签内容
Task chat聊天构建器和草稿的任务包。
Bot tasks已起草和完成的任务,以及其 review、QA、日志和审批状态。
Run history运行请求,以及对应的运行器、活动和经过脱敏的日志。
Bot policy团队开关以及控制执行的限制。
Bot profiles用于设置工作器模板、推理和限制的配置文件。
Blueprints固定工作流模板,以及每个模板是否对团队启用。

在聊天中设计任务

  1. 选择 New bot task,或停留在 Task chat → Chat with ArchiBot。
  2. 描述需要更改的内容、完成标准,以及 QA 应如何验证。可使用快捷项:Acceptance criteria、QA plan、Add evidence 和 Narrow scope。
  3. 在 Message ArchiBot 中输入内容并发送。每次回复都会更新 QA 备注,也可能建议标题或范围。
  4. 打开 Task packet 查看收集到的信息:团队、配置文件和源,以及 Overview、Source(代码仓库、基准分支、Path scope)、可选的 Product(Add dependent product repository)和 QA 与保存标签。
  5. 选择 保存草稿(仅设置的团队)或 Start bot(已启用交接)。设置标题和必填字段前,按钮会保持禁用状态。运维人员需要先选择团队。

任务范围应具体。“Add a field to Space Console”并提供验收标准是合适的。“修复应用”则不够具体。

安全示例数据中的任务包:团队、配置文件和源卡片位于 Overview、Source、Product 和 QA & save 标签上方。

机器人任务和运行

Bot tasks会列出所有任务。取消任务会保留审计记录,并将任务标记为已取消,而不是删除。

Run history会列出运行请求;Run detail会显示模式、分支、运行器作业、活动时间线和经过脱敏的日志。如果存在合并事件,Open merge request会链接到该请求。人员会在 CI & Review 中批准并合并。

机器人策略(运维人员)

Bot policy用于决定团队是否可以运行机器人,并显示 Team enabled 或已禁用:

  1. Allow bot runs for this team。平台开关和运行编排器也必须启用。
  2. 新运行默认使用的配置文件和工作区目标。
  3. 每月机器人预算和并发运行数,以及预设值。
  4. 日志和制品保留期限、运行后工作区清理,以及制品处理方式(例如归档到 Shared Drive)。
  5. 此团队可以使用的蓝图。

选择 保存政策。

机器人配置文件(运维人员)

在 Bot profiles中选择团队,然后选择 New profile。设置名称、蓝图以及允许修改内容的说明。启用 Make this profile selectable,然后设置工作区目标、模板、推理力度、运行时上限、预算、并发运行数和工具允许列表。选择 Save profile。

蓝图(运维人员)

Blueprints会列出固定工作流(托管功能、修复和文档),以及各自的 review 模型、QA 步骤、运行时上限和文件预算。Enable for team / Disable for team用于控制团队可以使用哪些蓝图。启用蓝图不会开始任何工作。

在手机上

  • 六个标签可横向滚动;所有控件都有大尺寸点按区域。
  • 编辑时,保存政策和Save profile会固定在屏幕底部。
  • 在 Task packet 中,只要 QA 与保存 行在屏幕上,带有 保存草稿的该行就会固定在屏幕底部。
  • 日期和数字预设都是大尺寸按钮。

手机上的机器人策略页面:Bots 标签可横向滚动,“允许此团队运行机器人”设置显示在上方,“保存策略”固定在底部。

安全内容

切勿在任务、QA 备注、配置文件或蓝图中填写密码、API 密钥、Cookie、邀请链接、Webhook 密钥、代码库令牌、数据库 URL、原始日志或客户数据。代码库 URL、分支名称、问题引用、路径范围和 Console 中可见的错误均可提供。

相关指南

完成标志

  • 任务标题、代码库、分支、路径范围和 QA 备注均不含机密信息。
  • 只有团队策略和 ISM 均启用机器人执行后,才预期会触发工作区或合并事件。
  • 仍由人员在 CI & Review 中批准并合并。