A configuração da organização pode ser exportada como um pacote portátil e aplicada a outra organização. Encontre-o em Configurações → Dados → Exportar configurações.
Isso é útil para três situações: criar uma segunda organização com configurações idênticas à existente, promover uma configuração de um ambiente de teste para um ambiente real e manter um registro revisável de como um espaço de trabalho está configurado.
O que é incluído no pacote
O pacote abrange a configuração em nível de organização:
| Área | Incluído |
|---|---|
| Política e qualidade | Política da organização, políticas de qualidade, regras de projeto, políticas de ciclo de vida e regras de revisão |
| Entrega | Mandatos: para que serve o trabalho autônomo (objetivo, meta, prioridades, escopo, orçamento por janela, condições de interrupção, data de revisão, regra de desvio, função do responsável). As linhas de base são medições permanentes; uma importação cria rascunhos para que uma pessoa os publique. |
| Agentes e modelos | Perfis AI, chaves de provedor referências |
| Automação | Gatilhos, agendamentos |
| Conexões | Integrações de controle de versão, pontes de canal e servidores MCP |
| Acesso | Configuração de identidade corporativa, contas de serviço e se cada uma inicia o trabalho qualificado automaticamente |
| Dados | Configurações de retenção, configuração de armazenamento e destinos de auditoria |
Uma importação não cria contas de serviço. Uma conta já existente com o mesmo nome adota a opção do pacote sobre se seu trabalho qualificado deve iniciar automaticamente.
O que não é incluído no pacote
Os segredos nunca saem do sistema. Chaves de provedor, tokens e credenciais são exportados como placeholders. O pacote registra isso que uma chave existe e quem a utiliza, nunca seu valor — você deve reinserir os segredos após a importação.
Também excluído: tudo que diz respeito à identidade do espaço de trabalho e não à configuração — o nome da organização, seus membros, sua relação de faturamento — e o histórico operacional, como tarefas, execuções e eventos de auditoria.
A regra é que um pacote descreve como um espaço de trabalho está configurado, e não o que ocorreu nele.
Aplicando um pacote
O portal exporta pacotes, mas não os importa. Para aplicar um, conecte um agente como o Hermes ao servidor MCP do Coroid. O agente pré-visualiza o pacote e depois o aplica. Ele também pode configurar uma organização a partir de capturas de tela, arquivos ou descrições, escrevendo-os primeiro em um pacote.
Para aplicar um pacote, é necessária uma conexão pertencente a um proprietário, e um proprietário ou administrador deve aprovar cada aplicação. No coroid.ai, essas ferramentas de administração ainda não estão ativadas. Veja Configurações da organização via MCP.
Pré-visualizar antes de aplicar
A aplicação de um pacote executa uma pré-visualização primeiro, mostrando o que cada seção faria:
| Status | Significado |
|---|---|
applied | A configuração será criada ou atualizada |
unchanged | Já corresponde; nada a fazer |
needsRebind | Depende de algo que precise ser redefinido localmente |
failed | Não pode ser aplicado; o motivo é indicado |
Leia a pré-visualização com atenção. needsRebind é o item mais importante — ele sinaliza configurações que fazem referência a algo que não existe de forma idêntica no destino, geralmente uma conexão de repositório ou um segredo. Esses itens precisam de atenção antes que a configuração seja efetivamente equivalente.
Bundle de configurações
- Política e qualidade
- Perfis do AI
- Hooks e agendamentos
- Conexões
••••••Os segredos se tornam placeholders
Visualizar na organização de destino
- Perfis do AISerão criados ou atualizadosapplied
- Políticas de qualidadeJá correspondeunchanged
- Integração com controle de versãoRedirecione para uma conexão local e insira novamente sua secretneedsRebind
- HooksNão podem ser aplicados; o motivo é exibidofailed
Mantendo pacotes no controle de versão
Um pacote exportado é um arquivo, portanto pode ficar em um repositório, ser comparado e revisado. Para equipes que tratam a configuração como código, esse é o valor: uma alteração na política da organização vira um diff revisável em vez de um clique feito por alguém.
Como os segredos são placeholders, um pacote é seguro para ser commitado — mas verifique se há algo que identifique sua própria configuração antes de torná-lo público.