---
titulo: Organizar conhecimento compartilhado, fontes e rotas
modelo: Modelo de Gestão de Agentes de IA
codigo: M05
versao: "1.2.0-rc.1"
consumo: integral ao desenhar fontes; consulta por necessidade na manutenção
---

# M05 — Organizar conhecimento compartilhado, fontes e rotas

Uma fonte entra no sistema pelo julgamento ou pela operação que sustenta. A organização permite chegar ao conteúdo competente, compreender seu alcance e usá-lo na versão adequada. A pasta guarda; a rota conduz; a fonte governa o conteúdo. Essas funções se relacionam sem constituir três cadastros concorrentes.

Use o enquadramento de [M01](M01-Compreender-o-Trabalho-e-Enquadrar-a-Solucao.md) e o desenho do ambiente de [M02](M02-Desenhar-o-Ambiente-e-o-Modelo-de-Gestao.md). Quando a concepção detalhada do agente for produzida em [M03](M03-Conceber-o-Agente-e-suas-Capacidades.md), confronte novamente sua cobertura de conhecimento. Uma reforma focal de acesso pode encerrar aqui, sem redesenhar o agente.

## 1. Derivar fontes das contribuições

Para cada entrega ou julgamento essencial, identifique o que o agente precisa perceber, saber, distinguir e transformar. Separe quatro contribuições: conhecimento que ensina a julgar; fatos do caso; condição atual que permite continuar; evidência que sustenta uma afirmação. Um manual pode ensinar a avaliar uma entrega, mas não demonstra que ela foi realizada.

Registre as relações necessárias, sem impor uma tabela por arquivo:

| Contribuição do trabalho | Conhecimento e informação requeridos | Fonte ou lacuna | Uso esperado |
|---|---|---|---|
| Comparar alternativas | Critérios, limites e razões | Método suficiente ou conteúdo a desenvolver | Comparação fundamentada |
| Informar situação | Identidade, período e condição vigente | Sistema ou Estado competente | Retrato do recorte consultado |
| Sustentar um efeito | Evento, objeto e resultado observados | Evidência da operação | Alegação limitada ao que foi conferido |

Leia o conteúdo que decide a contribuição. Título semelhante e resultado de busca indicam candidatos, sem provar suficiência. Uma fonte pode sustentar várias operações; uma operação pode exigir fontes com papéis diferentes. Se um julgamento fica sem sustentação, nomeie a lacuna. Se um documento não muda nenhuma contribuição, questione sua presença no contexto.

## 2. Resolver identidade e autoridade

A autoridade depende do objeto e da afirmação. O regime do contexto deve indicar onde vivem decisões e responsabilidades, originais de conhecimento, dados operacionais e condição atual. Não atribua autoridade a um documento por sua pasta, aparência, posição na busca ou data de modificação.

Antes de combinar retornos, confira: trata-se do mesmo objeto? Qual edição ou período? O texto é original, proposta, histórico ou cópia? Quem tem competência para defini-lo? Qual trecho sustenta a afirmação? Uma decisão aprovada pode prevalecer sobre um rascunho modificado depois; um dado atual do produtor pode superar uma exportação sem alterar o método de interpretação.

Se duas fontes vigentes sustentarem sentidos incompatíveis, exponha a divergência e sua consequência para o trabalho. Resolva pela autoridade competente quando identificável. Se a decisão continuar aberta, preserve o que cada fonte permite afirmar e encaminhe apenas a definição necessária. Não entregue uma mistura aparentemente coerente nem obrigue o destinatário a descobrir o conflito.

Uma fonte inacessível mantém sua identidade e seu papel. A falta de acesso não autoriza recriar o seu conteúdo como se fosse conhecido. Uma alternativa pode permitir parte do trabalho, com a data, cobertura e limitação correspondentes.

## 3. Distribuir conhecimento comum e específico

Mantenha uma definição comum quando vários agentes precisam do mesmo critério e sua manutenção pertence à mesma origem. Preserve conhecimento específico quando muda a interpretação de um território, usa evidências próprias ou tem atualização independente. A abrangência do uso não define, sozinha, quem mantém.

Por exemplo, um critério comum de clareza pode servir a agentes de atendimento e de conteúdo. A política de resolução de um atendimento pertence ao seu domínio. Reescrever o critério comum em cada kit cria manutenção concorrente; forçar todas as políticas em uma fonte transversal dificulta encontrar o que decide cada caso.

Uma fonte mista pode permanecer inteira se suas partes precisam ser compreendidas juntas. Separe quando houver consumo ou manutenção próprios, conservando as relações. Procedimento, referência e Skill podem compartilhar critérios: o procedimento organiza uma execução determinada; a referência desenvolve o saber; a Skill incorpora uma transformação reutilizável. [M04](M04-Desenvolver-a-Inteligencia-do-Trabalho.md) desenvolve o conteúdo e [M09](M09-Construir-Skills-a-Partir-do-Modelo.md) a transformação em Skill.

## 4. Declarar a relação com a origem

| Relação | Contrato de conteúdo | Consequência da mudança |
|---|---|---|
| Original | Identidade e conteúdo mantidos na casa competente | Rever consumidores pertinentes ao alcance alterado |
| Cópia | Reprodução declarada, integral ou delimitada | Comparar com a edição de origem e atualizar segundo o contrato |
| Espelho | Cópia com compromisso explícito de fidelidade e sincronização | Conferir fidelidade, edição e cobertura; não editar como original independente |
| Aplicação própria | Usa a inteligência de uma origem com escolhas e forma próprias | Avaliar impacto; adaptar somente o que muda sua aplicação |
| Consulta externa | Recupera conteúdo do produtor no momento pertinente | Conservar identidade, período, acesso e alcance do retorno |

Identifique origem recuperável, relação, edição utilizada e manutenção necessária. Não imponha versionamento numérico ao dado que é identificado por período ou evento. A aplicação tem versão própria e deve permitir reconhecer quais contribuições incorporou. Uma adaptação com alterações substantivas não pode se apresentar como espelho fiel.

Ao corrigir, altere a casa competente. Se a correção está fora da autoridade presente, preserve o diagnóstico e encaminhe o ajuste; pode corrigir a aplicação local autorizada sem falsificar a origem. [M13](M13-Operar-Gerir-e-Evoluir-o-Conjunto.md) determina prioridade e propagação gerencial; [M07](M07-Compor-o-Kit-e-Preservar-a-Continuidade.md) organiza a presença física das relações.

## 5. Separar acervo e contexto

O acervo é o conjunto disponível; o contexto é o conteúdo que chega à IA naquela ocorrência. Um arquivo existente não garante leitura. Defina o consumo pela contribuição:

- Permanente: o que deve governar a atuação comum e precisa estar presente desde a entrada.
- Integral sob demanda: um raciocínio ou método cuja unidade é necessária à aplicação.
- Seletivo: trecho que conserva significado, condições e exceções suficientes.
- Consulta atual: fato ou situação a recuperar no produtor no momento pertinente.

Preserve regra, condição, razão e exceção como unidade de interpretação. Um trecho que diz “aprovar quando houver confirmação” perde o sentido se a fonte distingue quem confirma e qual evidência serve. Resumos que eliminam essas relações reduzem o arquivo e empobrecem a decisão.

Quando o ambiente limitar arquivos ou contexto, selecione e exponha conjuntos coerentes. Dividir, consolidar ou recuperar sob demanda são decisões de implementação, a conferir em [M11](M11-Implementar-e-Instalar-em-Cada-Ambiente.md). Mover documentos para uma pasta ou citar seus nomes não cria um mecanismo de recuperação.

## 6. Escrever uma rota que permita chegar e interpretar

Comece pela pergunta de trabalho. Investigue o percurso com os recursos disponíveis e escreva somente interfaces e propriedades observadas. Uma linha basta para uma fonte inequívoca com leitura direta. Casos com relações, homônimos, períodos ou cobertura parcial exigem transferir a receita.

Uma rota suficiente informa, na medida da dificuldade:

1. A necessidade atendida e a identidade do objeto, incluindo como separar edições e homônimos.
2. A fonte competente, o ponto de entrada e o papel de cada fonte auxiliar.
3. O percurso de consulta, filtros ou vínculos, o cadastro que armazena a ligação e a cobertura necessária.
4. O conteúdo a ler e a interpretação que autoriza a conclusão.
5. A alternativa praticável, seu limite e a condição que exige recuperar a fonte principal.
6. A mudança que pede revisão e onde preservar a evidência ou a condição atual.

Não congele resultados voláteis dentro da receita. Se o sistema exige paginação, cubra o recorte antes de concluir sobre o conjunto. Se a ligação está registrada apenas no cadastro de origem, consulte esse cadastro. Exemplo ilustrativo: se cada demanda registra quais agentes participam dela, consulte as demandas para descobrir os trabalhos de um agente; o cadastro do agente pode não conter a lista inversa. O percurso depende da estrutura encontrada, não de uma relação presumida no template. Uma associação entre recursos não prova seu uso; para alegar uso, procure evento ou registro correspondente ao mesmo objeto e período.

Um retorno vazio informa o que a consulta encontrou. Confira identidade, filtro, cobertura e acesso antes de inferir ausência no recorte. Mesmo uma busca adequada não demonstra inexistência universal.

## 7. Tratar mudança e insuficiência

Quando mudar fonte compartilhada, identifique consumidores conhecidos e a parte que cada um usa. Diferencie relação direta, cópia e aplicação própria. Compare conteúdo material, atualize o que cabe e confira a edição recebida e sua aplicação no consumidor; a data do arquivo distribuído não comprova isso. M13 define como conduzir pendências e [M15](M15-Conferir-o-Sistema-em-Uso.md) como ensaiar a propagação.

Classifique a insuficiência pelo próximo trabalho que resolve:

| Situação | Próxima operação |
|---|---|
| Fonte conhecida, acesso ausente | Recuperar acesso ou usar alternativa com limite explícito |
| Busca sem identidade ou cobertura suficientes | Corrigir o percurso antes de concluir |
| Elementos suficientes, distribuídos | Compor a contribuição e preservar papéis e origens |
| Conhecimento não encontrado no recorte examinado | Especificar conteúdo a desenvolver em M04 |
| Autoridades em conflito material | Confrontar e resolver a definição competente |
| Fonte histórica | Conservar função histórica e localizar a aplicável ao caso |

A passagem para desenvolver conteúdo deve explicar contribuição faltante, materiais lidos, fatos sustentados, hipóteses, conceitos ou critérios necessários e resultado que demonstraria suficiência. Uma especificação de conhecimento ainda não é o conteúdo produzido.

## 8. Exemplo e conferência independente

Exemplo ilustrativo: um agente prepara a revisão de uma edição de oficina. O cadastro resolve identidade; o contrato aprovado define condições; o método ensina a revisão; os vínculos identificam recursos associados; os eventos indicam execução no período. A rota localiza a edição, lê o contrato, consulta o cadastro que registra quais recursos estão associados à oficina e confronta eventos pelo mesmo identificador. Se a exportação termina antes do período final, limita a conclusão à cobertura disponível. Não substitui o contrato por uma proposta mais recente nem transforma recursos associados em recursos usados.

Um consumidor deve conseguir partir da entrada normal, descobrir a rota, recuperar a fonte correta e aplicar seu conteúdo sem o construtor, o plugin de autoria ou uma explicação adicional do autor. Confira os riscos materiais do caso: edição, autoridade, vínculo, cobertura, conflito ou indisponibilidade. Não é preciso fabricar todos os riscos em toda consulta.

Preserve fora da fonte operacional a pergunta, os recursos disponíveis, a versão recebida, o percurso, o resultado, a intervenção e o limite. Se falhar, corrija a camada responsável: conteúdo, rota, presença, acesso ou interpretação. A arquitetura está suficiente quando os julgamentos essenciais têm sustentação ou dependência específica e o consumidor consegue usá-la no recorte declarado.

## 9. Aplicação por arquivos: um original, dois consumidores

No [exemplo de conhecimento compartilhado](../Exemplos-Couto-IAS/Conhecimento-Compartilhado/Leia-me.md), a triagem consulta um original e a comunicação usa uma cópia declarada. Ambos aplicam a distinção entre data desejada, estimativa e compromisso, com formatos locais diferentes. O catálogo registra a relação e cada entrada leva à rota que permite descobrir o conteúdo sem a conversa de autoria.

O arranjo usa catálogo, demanda e melhoria já previstos em M02. Uma única demanda recebe as contribuições e aponta para sua entrega; a melhoria liga origem, consumidores e conferência. Se essas funções já estiverem no template ou em outro sistema suficiente, use-as. Não se cria uma quarta base para fontes nem outra situação por agente.

Para manter o original, examine a mudança autorizada na casa competente. Para consulta direta, confira a edição recuperada numa ocorrência nova; para cópia, substitua a parte declarada e releia o destino. Compare personalizações com sua condição anterior. Registre qual ação foi manual e qual mecanismo foi observado. Uma aplicação própria recebe análise de impacto, mesmo que use a mesma origem.

A prova deve separar: caminho alcançável, conteúdo lido, aplicação correta e operação na plataforma. Um ensaio por arquivos pode conferir os primeiros aspectos no contexto em que foi realizado; dois projetos nativos precisam ser abertos e testados pelo mecanismo efetivo de M11. Autorrevisão não é consumo independente. M15 conserva os critérios de aceitação e M13 a pendência de quem ainda não recebeu.