Esta etapa converte as regras do documento de descoberta em configurações. Trabalhe nas áreas abaixo em ordem. Para cada área, decida com o cliente e, então, defina-a.
Anote cada decisão e seu motivo à medida que avança. Nota de transferência é construído a partir dessas notas.
Projetos
Decida com o cliente:
- Quais repositórios se tornarão projetos. Use um projeto para cada repositório.
- O branch contra o qual CoRoid abre seus pull requests.
- Se CoRoid pode enviar alterações ao repositório (Sincronizado) ou apenas lê-lo (Apenas local).
- Os comandos que instalam, compilam e testam o código, além dos serviços necessários para os testes.
- O que os agentes precisam saber sobre o que o código não exibe.
Crie cada projeto a partir de Projetos. Em seguida, abra as configurações do projeto:
Repositório para os branches e o modo, Variáveis de ambiente, e
Conhecimento → Contexto para o que os agentes leem. Verifique os comandos de compilação e teste detectados pelo CoRoid. Escreva o que os agentes precisam saber em AGENTS.md, no
repositório.
Veja Crie seu primeiro projeto, Configurações de repositório e branch, Configuração de compilação e teste e Escreva um AGENTS.md.
Controle de Qualidade
Decida com o cliente:
- O que cada alteração deve cumprir e quais falhas bloqueiam ou apenas servem como orientação.
- Qual o nível de rigor do controle de qualidade e onde as verificações são executadas.
- O que acontece com os pull requests abertos pelas pessoas: Controle de Qualidade do CoRoid e Revisão do CoRoid como orientação ou bloqueio.
- Quais fontes podem enviar solicitações, como Slack, Telegram ou Jira.
- O que acontece quando algo falha, como uma tarefa ou implantação mal-sucedida.
Defina-o em Controle de Qualidade. Defina o Padrão da organização com as verificações que a maioria dos projetos precisa. Defina uma configuração própria para um projeto somente quando houver diferença. Veja Políticas e portões de qualidade e Verificações anti-slop.
Um pull request do CoRoid só faz merge quando uma pessoa autoriza. Para código que requer um aprovador nomeado, como o código de pagamentos, use proteção de branch no host git.
Mandatos
Um mandato permite que o CoRoid inicie trabalhos que chegam sem intervenção humana, por exemplo, da um rastreador de erros. Ele nunca permite que o CoRoid faça merge ou implante.
Decida com o cliente:
- Em quais projetos o CoRoid pode iniciar trabalhos sozinho.
- Quanto ele pode gastar por semana ou mês.
- Quando o cliente revisará o mandato novamente.
Defina os mandatos em Controle de Qualidade: escolha Padrão da organização, depois Mandatos no Entrega grupo. Se o cliente não quiser nenhum trabalho sem intervenção humana, não defina nenhum mandato. Veja Mandatos.
Perfis do AI
Decida com o cliente:
- Qual perfil a organização usa por padrão.
- Se as chamadas de modelo devem permanecer na UE. Nesse caso, use Apenas UE.
- Se os modelos serão pagos com créditos de modelo do CoRoid ou com as chaves do provedor do próprio cliente.
- Quais provedores e modelos os agentes nunca podem usar.
Defina os perfis em Configurações → AI profile, e as chaves em Configurações → Chaves de provedor. Limite provedores e modelos em Configurações → Identidade e acesso → Política da organização. Veja Perfis do AI, Chaves de provedor e Créditos de modelo.
Automações
Decida com o cliente:
- Quais trabalhos começam conforme um cronograma e quais começam quando algo acontece.
- O que cada automação faz e em quais projetos.
- Se uma automação apenas lê e gera relatórios ou também abre tarefas.
Crie automações em Novo trabalho, e encontre todas elas em Factory → Automações. As opções sob Quando algo falha em Controle de Qualidade acionam uma automação a cada execução. Veja Automações, Agendas e Ganchos.
Fluxos de trabalho
Um fluxo de trabalho abrange um processo de negócio, como uma caixa de entrada de suporte. Os agentes executam suas etapas, e as pessoas decidem onde o fluxo de trabalho indicar. Fluxos de trabalho ainda não estão disponíveis para todas as organizações. Pergunte ao CoRoid para ativá-lo.
Decida com o cliente:
- Qual processo cobrir primeiro. Escolha um com muitos casos semelhantes e regras claras.
- Como um caso começa: um e-mail, um formulário no site do cliente, uma pessoa ou outro fluxo de trabalho.
- As etapas e o que cada uma espera: nada, apenas dinheiro ou todas as alterações e mensagens.
- Os caminhos para cada etapa: perguntar ao cliente, ir para outra etapa, seguir uma tabela de regras, encaminhar o caso para uma pessoa ou encerrá-lo.
- As tabelas de regras, como linhas de "quando isso, então aquilo".
- O endereço de onde as respostas são enviadas, a assinatura e a linha de divulgação do AI.
Crie-o em Fluxos de trabalho. Cada fluxo de trabalho tem Casos, Etapas e Configurações, e as tabelas de regras são compartilhadas em Tabelas de regras. Execute Testar nas etapas antes de publicar: Testar envia dados sem fazer alterações. Depois Publicar e Ativar. Veja Fluxos de trabalho via MCP.
Revisar regras
Decida com o cliente o que o Revisor do CoRoid deve verificar no código deste cliente, além das próprias regras do CoRoid.
Escreva as regras em cada repositório: um arquivo REVIEW.md na raiz e arquivos de regras em uma pasta review-rules CoRoid os lê da branch base, para que um pull request não possa alterar as regras pelas quais será revisado. Defina o que o CoRoid Review posta em Controle de Qualidade, em Pull requests. Veja
Pull requests.
Habilidades
Uma habilidade é um procedimento que os agentes carregam somente quando o trabalho exigir, como "como escrevemos uma migração de banco de dados". Decida com o cliente quais procedimentos próprios os agentes devem seguir.
Escreva cada habilidade no repositório, como skills/<name>/SKILL.md. O arquivo
começa com metadados que contêm um name e um description. Os agentes leem
as habilidades apenas do repositório mesclado. Veja
Habilidades progressivas e
Escrever um AGENTS.md.
O que você pode alterar sem código
Clientes e implementadores não recebem o código-fonte do CoRoid. Tudo que um cliente pode alterar está nesta tabela: uma configuração no portal ou um arquivo no próprio repositório do cliente. Algumas páginas aparecem apenas onde o CoRoid ativou o recurso, como Fluxos de trabalho.
| O quê | Onde |
|---|---|
| Nome da organização | Configurações → Geral |
| Membros e suas funções | Configurações → Membros |
| Perfis do AI | Configurações → AI profile |
| Chaves de provedor | Configurações → Chaves de provedor |
| Contas de serviço para a entrada de trabalho do API | Configurações → Contas de serviço |
| A conexão com o host Git | Configurações → Conexões → Controle de versão |
| Bots do Slack e Telegram | Configurações → Conexões → Canais |
| Servidores MCP externos e as ferramentas que os agentes podem chamar | Configurações → Conexões → MCP externo |
| Tokens de acesso, aprovações e políticas de automação do servidor MCP do CoRoid | Configurações → Conexões → Servidor MCP do CoRoid |
| SSO, domínios verificados e sincronização de diretórios | Configurações → Identidade e acesso → Identidade corporativa |
| Modelos, provedores, comandos e ferramentas permitidos | Configurações → Identidade e acesso → Política da organização |
| Sessões autenticadas | Configurações → Identidade e acesso → Sessões ativas |
| O log de auditoria e sua exportação | Configurações → Identidade e acesso → Registro de auditoria |
| Plano, vagas de agentes e créditos de modelo | Configurações → Cobrança e uso |
| Armazenamento, retenção de dados e exportação de configurações | Configurações → Dados e jurídico |
| O nome, repositório, branches e modo de um projeto | As configurações do projeto Configurações → Geral e Repositório |
| As variáveis de ambiente de um projeto | As configurações do projeto Configurações → Variáveis de ambiente |
| O que os agentes leem sobre um projeto | As configurações do projeto Configurações → Conhecimento → Contexto |
| Revisar evidências das ferramentas do cliente | As configurações do projeto Configurações → Integrações |
| Verificações, Controle de Qualidade, fontes de solicitações, Pull requests e "Quando algo falha" | Controle de Qualidade |
| Regras anti-slop e limpeza semanal de dívida técnica | Controle de Qualidade |
| Mandatos | Controle de Qualidade → Padrão da organização → Entrega |
| Proteções de Segurança, modelos de ameaças e superfície de ataque | Segurança → Projetos |
| Idiomas, verificações de tradução e colaboradores | Globalização |
| Ambientes de lançamento, regras de aprovação, pipeline de implantação e versionamento | Lançamentos → Configurações de lançamento |
| Automações de eventos e agendamentos | Factory → Automações, criado em Novo trabalho |
| Relatórios agendados | Factory → Relatórios |
| Fluxos de trabalho e tabelas de regras | Fluxos de trabalho |
| Instruções para agentes | AGENTS.md e os outros arquivos de memória no repositório |
| Revisar regras | REVIEW.md e o review-rules pasta no repositório |
| Habilidades | skills/<name>/SKILL.md no repositório |
O Servidor MCP do CoRoid O assistente altera muitas dessas configurações dentro das ferramentas ativadas.
Uma necessidade que nada atende.
Quando nenhuma linha da tabela atende a uma regra, não tente adaptar o produto. Envie a necessidade para o CoRoid como um pedido por meio do página de contato. Escreva:
- A situação do cliente, sem dados pessoais.
- O que você testou com as configurações acima.
- O que o cliente precisa e por quê.
Uma alteração feita pelo CoRoid chega a todos os clientes em uma versão.
Concluído quando
- Cada regra no documento de descoberta tem uma configuração ou um pedido ao CoRoid.
- Cada decisão tem um motivo registrado nas suas notas.
- Uma tarefa em cada projeto chega ao pull request após passar pelas verificações.
Relacionado
- Visão geral das configurações
- Piloto, a próxima etapa