Documentação

Configurar

Converta cada regra do documento de descoberta em configurações, área por área, e veja a lista completa do que o cliente pode alterar sem código.

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çãoConfigurações → Geral
Membros e suas funçõesConfigurações → Membros
Perfis do AIConfigurações → AI profile
Chaves de provedorConfigurações → Chaves de provedor
Contas de serviço para a entrada de trabalho do APIConfigurações → Contas de serviço
A conexão com o host GitConfigurações → Conexões → Controle de versão
Bots do Slack e TelegramConfigurações → Conexões → Canais
Servidores MCP externos e as ferramentas que os agentes podem chamarConfigurações → Conexões → MCP externo
Tokens de acesso, aprovações e políticas de automação do servidor MCP do CoRoidConfigurações → Conexões → Servidor MCP do CoRoid
SSO, domínios verificados e sincronização de diretóriosConfigurações → Identidade e acesso → Identidade corporativa
Modelos, provedores, comandos e ferramentas permitidosConfigurações → Identidade e acesso → Política da organização
Sessões autenticadasConfigurações → Identidade e acesso → Sessões ativas
O log de auditoria e sua exportaçãoConfigurações → Identidade e acesso → Registro de auditoria
Plano, vagas de agentes e créditos de modeloConfigurações → Cobrança e uso
Armazenamento, retenção de dados e exportação de configuraçõesConfigurações → Dados e jurídico
O nome, repositório, branches e modo de um projetoAs configurações do projeto Configurações → Geral e Repositório
As variáveis de ambiente de um projetoAs configurações do projeto Configurações → Variáveis de ambiente
O que os agentes leem sobre um projetoAs configurações do projeto Configurações → Conhecimento → Contexto
Revisar evidências das ferramentas do clienteAs 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écnicaControle de Qualidade
MandatosControle de Qualidade → Padrão da organização → Entrega
Proteções de Segurança, modelos de ameaças e superfície de ataqueSegurança → Projetos
Idiomas, verificações de tradução e colaboradoresGlobalização
Ambientes de lançamento, regras de aprovação, pipeline de implantação e versionamentoLançamentos → Configurações de lançamento
Automações de eventos e agendamentosFactory → Automações, criado em Novo trabalho
Relatórios agendadosFactory → Relatórios
Fluxos de trabalho e tabelas de regrasFluxos de trabalho
Instruções para agentesAGENTS.md e os outros arquivos de memória no repositório
Revisar regrasREVIEW.md e o review-rules pasta no repositório
Habilidadesskills/<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.