---
titulo: Implementar e instalar em cada ambiente
modelo: Modelo de Gestão de Agentes de IA
codigo: M11
versao: "1.2.0-rc.1"
condicao: "edição candidata; integração e operação no destino ainda não conferidas"
consumo: integral por implementação; consulta focal em atualização ou falha de presença
---

# M11 — Implementar e instalar em cada ambiente

Implementar é realizar as funções do modelo nos mecanismos disponíveis. Instalar é colocar a configuração e os recursos no destino de uso. A conclusão exige conferir o que chegou e o que consegue operar naquela conta, superfície e contexto. Uma implementação não comprova outra.

Reúna os componentes do kit definidos em [M07](M07-Compor-o-Kit-e-Preservar-a-Continuidade.md), as instruções de entrada de [M08](M08-Escrever-Prompts-e-Instrucoes-de-Entrada.md), as Skills de [M09](M09-Construir-Skills-a-Partir-do-Modelo.md) e os acessos e operações de [M10](M10-Compor-Acessos-Ferramentas-e-Operacoes.md). Preserve contribuição, critérios e autoridade comuns ao trocar o ambiente. Recursos de produto, nomes literais, limites, planos, importações e comportamentos de descoberta devem ser verificados no destino; não são princípios universais deste modelo.

## 1. Fazer a ficha do ambiente

Identifique produto/superfície, conta ou perfil sem expor segredo, plano quando relevante, versão ou data da inspeção, origem das instruções, forma de acesso a arquivos, ferramentas e capacidade de persistência. Registre quem configura, quem usa e se são contextos diferentes.

Consulte a documentação oficial pertinente e a interface ou configuração observada. A documentação informa possibilidade e condições; o ambiente indica o que está disponível ali; a execução confere o comportamento no recorte. Diferenças entre essas evidências precisam ser reconciliadas, sem completar a lacuna por semelhança com outro produto.

A ficha deve responder: o que governa o começo da sessão; como chega o núcleo integral; como recuperar fontes sob demanda; como expor e chamar Skills; que objetos podem ser lidos/escritos; como recuperar continuidade; que limites mudam a composição. Não registre catálogo de funcionalidades sem relação com o trabalho.

## 2. Mapear a arquitetura comum para os mecanismos

| Função comum | Realização a identificar | Evidência necessária |
|---|---|---|
| Entrada permanente | Campo, arquivo descoberto, conteúdo de sessão ou mecanismo equivalente | Conteúdo e edição recebidos desde a entrada prevista |
| Núcleo | Incorporação, importação ou leitura explícita antes da contribuição dependente | Conteúdo integral recebido, sem corte material |
| Fontes e procedimentos | Arquivo, recuperação, conector ou referência alcançável | Fonte correta, contexto e unidade de significado |
| Skills | Formato nativo ou operação equivalente explicitamente invocada | Recurso disponível, recebido e utilizado no modo declarado |
| Meios | Ferramentas e acesso autorizado | Operação no alvo e alcance previstos |
| Continuidade | Estado/objeto e registro persistentes | Escrita conferida e recuperação em outra ocorrência |

As seguintes famílias orientam a adaptação; não descrevem um fornecedor específico:

- **Campo de instruções e documentos anexados:** coloque a entrada no mecanismo de instrução confirmado e exponha o núcleo e as fontes pelo mecanismo de leitura real. Anexo não deve ser presumido presente integralmente. Sem escrita persistente, prepare atualização assistida e torne essa intervenção explícita.
- **Trabalho sobre pastas:** confirme pasta de entrada, regra de descoberta, precedência e arquivos efetivamente abrangidos. Use os literais exigidos pelo destino, caminhos reais e importações suportadas. Proteja originais e confira o escritor de Estado e artefatos.
- **Sessão conduzida por aplicação:** a aplicação precisa fornecer instruções, contexto, ferramentas e persistência a cada chamada ou retomada. Um identificador de sessão não garante sozinho que todo o conhecimento está presente. Defina quais dados cada etapa recebe e como a condição é recuperada.

Uma implementação pode combinar famílias. Escolha pelo que a superfície faz, sem transportar uma sintaxe ou capacidade apenas porque o produto parece semelhante.

## 3. Expor fontes e Skills

Confira o texto exato da entrada e sua edição de origem. Se o ambiente exigir uma composição gerada, incorpore os componentes necessários e preserve a correspondência de M07. Mantenha instruções superiores e configurações fora do alcance intactas; não altere preferências globais apenas para fazer um ensaio passar.

Para o núcleo, verifique presença integral antes do trabalho dependente. Se só houver recuperação por trechos, escolha uma forma que preserve a unidade necessária: incorporação, divisão coerente com leitura de todas as partes necessárias ou mecanismo alternativo. Uma frase mandando ler tudo não demonstra que o meio consegue entregar tudo.

Para fontes sob demanda, percorra uma pergunta representativa pelas rotas de [M05](M05-Organizar-Conhecimento-Compartilhado-Fontes-e-Rotas.md). Confira identidade, edição/período, conteúdo e interpretação, incluindo alternativas quando pertinentes. Para Skills, valide formato, apoios, dependências e forma de acionamento. Receber uma Skill por caminho explícito permite avaliar seu método, mas não prova seleção nativa. Se o destino usa uma operação equivalente sem suporte nativo, identifique essa realização e seu esforço de acionamento.

A exposição deve ser suficiente ao trabalho e ao acesso autorizado. Não anexe todo o acervo por hábito nem remova exceções essenciais para caber em um limite. A presença precisa ser repetível pelo mecanismo previsto, com condições reconhecíveis de falha e recuperação.

## 4. Conectar gestão, pastas e dados

Leia o esquema vivo e os recursos expostos antes de criar bases, relações ou chamadas. No Notion ou em outro sistema de gestão, realize os objetos e perguntas de [M02](M02-Desenhar-o-Ambiente-e-o-Modelo-de-Gestao.md) com as propriedades realmente suportadas. Preserve identidades existentes e use IDs retornados pelo destino, sem inventá-los.

Na pasta, confirme o destino existente e sua função. Uma árvore local e sua representação remota podem ter diferenças de sincronização e permissão. Confira conteúdo e destino efetivos, sem presumir que o caminho escrito corresponde ao local de uso por outra conta.

Teste leitura e escrita como capacidades separadas, no menor recorte suficiente. Uma vista filtrada não demonstra restrição de acesso; um conector ligado pelo autor não prova que o consumidor tem a mesma permissão. Quando o usuário final for outro perfil, confira o perfil correspondente antes de afirmar alcance compartilhado.

Se não houver capacidade de aplicar parte da configuração, entregue texto ou esquema concreto, destino, sequência necessária e critério de conferência. Identifique a intervenção restante e o que já está realizado. A preparação pode estar concluída enquanto a instalação depende dessa passagem.

## 5. Instalar e realizar a primeira aplicação

Fixe um caso de trabalho, entradas e propriedades esperadas antes de rodar. Escolha efeitos controlados que preservem a pergunta sem produzir envio ou alteração externa indevida. Preserve a configuração anterior quando a substituição exigir possibilidade de retorno.

Conduza a instalação e confira cada passagem material:

1. A configuração foi salva no objeto e perfil corretos, com edição reconhecível?
2. Uma sessão nova recebe a entrada pelo mecanismo normal, sem o autor colá-la para suprir falha de descoberta?
3. O núcleo chega integralmente antes da contribuição e a fonte especializada entra quando necessária?
4. O agente aplica o critério, realiza o trabalho autorizado e preserva a fronteira de decisão?
5. A entrega e a condição atual são salvas, relidas e recuperáveis por outra ocorrência?

Se for preciso fornecer manualmente uma peça, registre a intervenção e a camada que o ensaio permite julgar. A boa resposta com contexto assistido não prova a instalação autossuficiente. Da mesma forma, descoberta correta não demonstra bom julgamento.

Em falha, diferencie formato/caminho, descoberta/precedência, corte de contexto, cópia antiga, acesso, conhecimento, orientação, efeito e continuidade. Corrija a casa responsável e repita o trecho afetado. Um ambiente cuja fonte essencial não chega não está adequado àquela contribuição apenas porque os arquivos aparecem na lista.

## 6. Preservar portabilidade e fechar o alcance

A ficha de implementação liga função comum, realização concreta, edições, evidência, intervenção e limite. Ela permite reconstruir outra implementação sem tomar a configuração antiga como norma. A mudança de superfície pode exigir nova exposição e persistência, preservando trabalho, critério, responsabilidade e autoridade.

Exemplo ilustrativo: em um ambiente de pasta, o núcleo pode ser recuperado por leitura do arquivo integral. Em outro, a realização pode incorporar entrada e núcleo no conteúdo de instruções, se suportado. Ambos precisam conservar o método, ter correspondência com os originais e conferir o que a sessão recebeu. O fato de o primeiro funcionar não comprova o segundo, e uma importação literal não deve ser transportada sem suporte observado.

Entregue localização e edição dos componentes, condição da configuração, operação realizada, resultado conferido e dependências concretas. [M12](M12-Auditar-a-Construcao-e-Diagnosticar-Lacunas.md) pode avaliar sua construção sem exigir prova de eficácia continuada; [M15](M15-Conferir-o-Sistema-em-Uso.md) organiza os casos de aplicação e os limites de cada alegação. Não use uma frase genérica de “instalação concluída” para encobrir uma passagem essencial que depende de intervenção.

## 7. Localizar a prova em cada superfície

Conversa com acesso à pasta, nova conversa de um projeto e recurso instalado são recortes diferentes de implementação. Identifique quais deles fazem parte do destino. Para cada recorte, registre superfície, origem/edição, mecanismo de entrada, conteúdo necessário, acesso de leitura/escrita, resultado e evidência. Os nomes de campos, formatos e comandos específicos são definidos pela documentação e pela observação atual do ambiente; este método pode ser realizado com os componentes que a implementação produzir.

Fixe a edição e o conteúdo normal de entrada antes da aplicação. Confira a chegada do núcleo e da fonte pertinente, depois leitura e escrita como operações separadas no alvo. Execute uma entrega autorizada, grave e releia o resultado. Abra outra conversa ou ocorrência pelo mecanismo previsto e confira a recuperação da condição, das decisões e do último resultado válido. Registre o que foi recuperado e o que dependeu de intervenção. Um recurso instalado não demonstra que uma conversa o selecionou, e uma sessão com pasta não prova o acesso de outra superfície.

A primeira conversa não recebe a resposta esperada do avaliador. Na retomada, forneça apenas a identidade da demanda e os novos dados legítimos; orientação e condição devem chegar pelo mecanismo de implementação. Quando a passagem for manual, entregue o texto ou arquivo completo, destino confirmado e critério de conferência. Se faltarem acesso à conta ou observação da superfície, conclua a preparação e registre a operação pendente. A evidência documental de M11 não substitui a aceitação em uso de M15.