文档

配置

将发现文档中的每条规则逐区域转换为对应设置,即可查看客户无需编码即可调整的全部选项列表。

此阶段会将发现文档中的规则转化为相应设置。请按顺序处理下方的各个区域:先与客户共同确定各区域的配置,再完成设置。

过程中请记录下每项决策及其原因。交接说明正是基于这些说明构建而成。

项目

与客户共同确定:

  • 哪些代码库会对应成为项目;每个代码库对应一个项目。
  • CoRoid 将针对该分支发起拉取请求。
  • CoRoid 是否有权向代码库推送代码(已同步)还是仅能读取代码库内容(仅本地访问)。
  • 用于安装、构建和测试代码的命令,以及测试所需的服务。
  • 代理需要知晓但代码中未体现的信息。

从以下位置创建每个项目:项目。随后打开项目的设置页面:代码库用于配置分支及模式,环境变量,以及知识 → 上下文用于指定代理可读取的内容。请核对CoRoid检测到的构建与测试命令,将代理需知晓的信息写入AGENTS.md,存放于代码库中。

请参阅创建首个项目、代码库与分支设置、构建与测试配置以及编写一份AGENTS.md。

Quality Control

与客户共同确定:

  • 每项变更需满足的通过条件,以及哪些失败情况会触发阻断或仅作提示。
  • 质量检查的严格程度,以及检查的执行位置。
  • 人员提交的拉取请求将如何处理:由CoRoid执行质量审核,CoRoid审核可设为建议性流程或阻断性流程。
  • 可提交请求的来源,例如Slack、Telegram或Jira。
  • 出现异常情况时的处理方式,例如任务失败或部署出错。

在以下位置进行设置:Quality Control。设置组织默认配置为大多数项目所需的检查项。仅在配置存在差异时才为单个项目单独设置。请参阅质量策略与关卡以及反垃圾代码检查。

CoRoid生成的pull request仅当有人手动合并时才会生效。对于需要指定审批人的代码,例如支付相关代码,需在Git托管平台中启用分支保护功能。

指令

指令可让CoRoid启动无人工干预的任务,例如来自错误追踪系统的任务。但指令绝不会允许CoRoid合并或部署代码。

与客户共同确定:

  • CoRoid可自主启动的任务范围,以及对应的项目。
  • 每周或每月可支出的预算额度。
  • 客户重新审查指令的时间。

在以下位置设置指令:Quality Control:选择组织默认配置,然后指令位于交付分组中。若客户要求所有任务必须有人工参与,则无需设置指令。请参阅指令。

AI配置文件

与客户共同确定:

  • 组织默认采用的配置文件。
  • 模型调用是否必须限制在欧盟境内?若是,请选用仅限欧盟。
  • 模型费用是由CoRoid的模型点数支付,还是由客户自行提供的供应商密钥支付。
  • 代理绝对不能使用的供应商及模型。

在以下位置设置配置文件:设置 → AI 配置文件,密钥则存放于设置 → 提供商密钥。在以下位置限制可使用的供应商及模型:设置 → 身份与访问权限 → 组织策略。请参阅AI配置文件、提供商密钥以及模型点数。

自动化规则

与客户共同确定:

  • 哪些任务按日程启动,哪些任务在触发事件后启动。
  • 每项自动化规则的具体作用,以及适用的项目。
  • 自动化规则是仅用于读取和生成报告,还是用于创建任务。

在以下位置创建自动化规则:新任务,所有自动化规则可在以下位置查看:Factory → 自动化规则。“当出现异常时”下方的开关当出现异常时在质量审核中,每个开关可触发一项自动化规则。请参阅自动化规则、日程安排以及钩子。

工作流

工作流用于覆盖业务流程,例如客服收件箱。代理会执行工作流中的步骤,关键决策点则由人工确定。目前并非所有组织都启用工作流功能。询问 CoRoid让其开启该功能。

与客户共同决策:

  • 优先覆盖哪个流程。选择案例较多且规则清晰的流程。
  • 案例的触发方式:电子邮件、客户网站上的表单、人工操作或其他工作流。
  • 各步骤的内容,以及每个步骤的等待条件:无需等待、仅等待资金到账,或等待所有变更和消息。
  • 每个步骤的执行路径:询问客户、跳转至其他步骤、遵循规则表、将案例交由人工处理,或关闭案例。
  • 规则表,以“当满足此条件时,执行该操作”的行形式呈现。
  • 回复邮件的发件地址、签名以及 AI 披露声明行。

在 中构建它工作流。每个工作流包含案例、步骤以及设置,规则表共享于规则表。运行试用在发布前先在步骤上试用:试用功能只会发送请求但不会更改任何内容。随后发布和开启。查看通过 MCP 实现的工作流。

审核规则

与客户共同确定 CoRoid 的审核员在此客户的代码中需重点核查的内容,这些内容需超出 CoRoid 自身规则的范围。

在每个代码库中编写规则:根目录下放置一个REVIEW.md文件,规则文件则存放在review-rules文件夹中。CoRoid 会从基准分支读取这些规则,因此 pull request 无法更改其审核所依据的规则。设定 CoRoid 审核结果发布的位置Quality Control,位于拉取请求。查看拉取请求。

技能

技能是一种仅在需要时才由智能体调用的流程,例如“数据库迁移的编写方法”。与客户共同确定智能体必须遵循的其内部流程。

在每个代码库中编写每项技能,形式为skills/<name>/SKILL.md。文件开头包含前端元数据,其中含有name和description。智能体仅从合并后的代码库读取技能。查看渐进式技能以及编写 AGENTS.md。

无需编码即可更改的内容

客户和实施人员无法获取 CoRoid 的源代码。客户可更改的所有内容均列于此表中:门户中的设置,或客户自身代码库中的文件。部分页面仅在 CoRoid 开启对应功能后才显示,例如工作流。

什么何处
组织名称设置 → 常规
成员及其角色设置 → 成员
AI 配置文件设置 → AI 配置文件
提供商密钥设置 → 提供商密钥
用于接收工作的服务账号 API设置 → 服务账号
Git 主机连接设置 → 连接 → 源代码管理
Slack 和 Telegram 机器人设置 → 连接 → 频道
外部 MCP 服务器,以及智能体可调用的工具设置 → 连接 → 外部 MCP
CoRoid MCP 服务器的访问令牌、审批流程和自动化策略设置 → 连接 → CoRoid MCP 服务器
SSO、已验证域名和目录同步设置 → 身份与访问权限 → 企业身份
允许的模型、提供商、命令和工具设置 → 身份与访问权限 → 组织策略
登录会话设置 → 身份与访问权限 → 活跃会话
审计日志及其导出设置 → 身份与访问权限 → 审计日志
计划、智能体插槽和模型配额设置 → 账单与用量
存储、数据保留和设置导出设置 → 数据与法律
项目的名称、代码库、分支和模式项目的设置 → 常规以及代码库
项目的环境变量项目的设置 → 环境变量
智能体读取的项目相关信息项目的设置 → 知识 → 上下文
来自客户工具的审核证据项目的设置 → 集成
检查项、QA、请求来源、拉取请求以及“出现故障时”相关配置Quality Control
反冗余规则及每周技术债清理Quality Control
指令Quality Control → 组织默认值 → 交付
安全防护、威胁模型和攻击面安全 → 项目
语言、翻译检查和贡献者全球化
发布环境、审批规则、部署流水线和版本管理版本发布 → 版本发布设置
事件自动化和定时任务Factory → 自动化,创建于新任务
定时报告Factory → 报告
工作流和规则表工作流
智能体指令AGENTS.md以及代码库中的其他记忆文件
审核规则REVIEW.md以及review-rules代码库中的 文件夹
技能skills/<name>/SKILL.md在代码库中

该CoRoid MCP 服务器助手可在已启用的工具内更改多项此类设置。

这是现有方案无法满足的需求

若表中无行符合规则要求,请勿围绕该产品进行开发。 请将需求作为请求发送至CoRoid。联系页面撰写内容:

  • 客户的使用场景(不含客户数据)
  • 您使用上述设置尝试的操作
  • 客户的需求及原因

CoRoid所做的变更会在版本发布时同步至所有客户。

完成于

  • 发现文档中的每条规则都对应一项设置,或对应一条向CoRoid提交的请求。
  • 每条决策在您的笔记中均有对应理由。
  • 每个项目中的一项任务会通过各项检查后提交给pull request。