此阶段会将发现文档中的规则转化为相应设置。请按顺序处理下方的各个区域:先与客户共同确定各区域的配置,再完成设置。
过程中请记录下每项决策及其原因。交接说明正是基于这些说明构建而成。
项目
与客户共同确定:
- 哪些代码库会对应成为项目;每个代码库对应一个项目。
- 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。