--- titulo: Organização e recuperação do conhecimento versao: "1.0.1" aplica: "Modelo de Gestão de Agentes de IA 1.2.0-rc.1; M02 e M05" consumo: integral ao organizar fontes e rotas; seletivo em consulta ou manutenção --- # Organização e recuperação do conhecimento Organize informação para responder às perguntas do trabalho e permitir ação. Pasta, tabela, nota e sistema são meios; identidade, significado, fonte competente e percurso tornam o conteúdo recuperável. O Couto-IAS usa essa inteligência para construir um ambiente suficiente na realidade da pessoa, sem exigir uma ferramenta específica ou um cadastro completo antes de começar. ## Partir da pergunta e resolver a identidade Uma consulta pode pedir atributo, relação, definição, condição atual ou evidência de execução. Reconheça essa diferença antes de buscar. Um cadastro pode resolver identidade e vínculos; a fonte integral explica significado e condições; o sistema produtor informa dado atual; o Estado correspondente conserva a condição do trabalho. Desambigue objetos parecidos por identificador, contexto, edição e finalidade. Nome novo pode preservar a mesma identidade; arquivo com nome igual pode ser outro objeto. Data de modificação sozinha não confere autoridade ou vigência. Quando houver versões incompatíveis, compare objeto, período, alcance e autoridade antes de compor a resposta. ## Definir uma casa competente por objeto Separe método, política e decisão do contexto; dados atuais; condição da demanda; artefatos; evidência. Uma fonte pode desempenhar mais de um papel, desde que cada afirmação conserve seu alcance. Uma cópia útil não substitui o original apenas por estar mais acessível. A pessoa pode começar com arquivos e uma lista simples. Se já usa uma fonte de condição suficiente, preserve-a. Outro ambiente só é pertinente quando resolver uma contribuição ausente, como consulta por relação, manutenção compartilhada ou acesso que os meios atuais não sustentam. Evite criar propriedades que ninguém consulta ou consegue manter. Conhecimento compartilhado tem fonte e consumidores identificáveis. O agente recebe conteúdo ou percurso suficiente para consultá-lo. Um vínculo documentado mostra associação; não demonstra que a contribuição foi usada nem que é indispensável ao funcionamento. ## Representar relações com significado Nomeie o que liga os objetos: agente usa fonte, demanda solicita entrega, versão substitui versão, operação produz efeito. A inversa precisa conservar o verbo e seu sentido. “Relacionado a” pode servir como pista, mas costuma ser insuficiente para decidir responsabilidade ou uso. Uma relação pode estar registrada apenas de um lado. Consulte o lado que a armazena antes de declarar que falta. Se o ambiente permitir consulta conjunta, ela pode reduzir etapas; leituras sequenciais são alternativa. Confira esquema, filtro e paginação atuais, sem supor a mesma capacidade em toda integração. ## Construir percursos por necessidade Uma rota utilizável contém ocasião, ponto de entrada, sequência necessária, papel da fonte, condição de interpretação, alternativa e conferência. Ela não precisa copiar todo o conteúdo nem a condição do dia. Exemplo ilustrativo: para “o que mudou na orientação deste agente?”, resolva identidade e edição em uso, recupere a origem anterior e a vigente, compare diferenças materiais e confronte adaptações locais. Ler apenas a fonte nova não mostra o que mudou para aquele consumidor. Se a versão anterior não estiver recuperável, delimite essa comparação. O percurso deve funcionar para outra sessão com os acessos previstos, sem depender de um plugin privado ou da memória do construtor. Um endereço serve quando chega ao objeto competente; um link cujo título parece certo não demonstra isso. Caminhos locais relativos favorecem a cópia da pasta; acesso online usa os identificadores da instalação da pessoa, sem transportar IDs privados da autoria. ## Buscar, interpretar e concluir Comece pela fonte conhecida ou pelo menor conjunto de candidatos pertinentes. Leia a contribuição necessária com condições e exceções. Se a primeira rota falhar, procure por identidade, fonte de referência ou mecanismo alternativo autorizado. Expandir a busca deve responder a uma lacuna real, e não ao simples fato de haver mais material. Resultado vazio informa o recorte consultado; falha informa o acesso que não ocorreu. Recuperação em trechos pode exigir leitura do contexto para preservar uma regra. Uma associação não prova execução. A resposta combina somente o que a evidência sustenta e explicita a limitação que muda o uso. Encerre quando houver sustentação suficiente para o destino da pergunta ou uma dependência material precisa. O leitor precisa receber a conclusão e seu fundamento, sem reconciliar sozinho uma coleção de links. ## Manter fontes e percursos Mudança de conteúdo, identidade, endereço, edição, esquema ou acesso pode afetar consumidores diferentes. Preserve o identificador quando editar no lugar; se uma fonte for recriada ou substituída, examine quem aponta para a anterior. A cópia literal acompanha o original; a aplicação recebe análise de impacto. Atualizar um índice não demonstra que o consumidor recebeu e aplicou a mudança. Falhas recorrentes ajudam a distinguir informação ausente, relação mal definida, referência velha, acesso insuficiente, recuperação parcial e interpretação inadequada. Corrija a causa. Se o problema for um fato técnico do ambiente, atualize o saber correspondente; se for condição transitória material, use o Estado competente. ## Produzir a arquitetura utilizável Entregue fontes e relações suficientes para a demanda: objetos/identidades, casa, conteúdo ou lacuna, percurso, acesso e condição de atualização. Incorpore conhecimento necessário ao pacote quando a consulta externa não fizer parte do ambiente previsto. Fatos e decisões próprios do usuário continuam insumos legítimos. Confirme com uma consulta realista por outro consumidor: ele encontra a fonte certa, interpreta seu alcance e produz a resposta? A conferência de caminho e a qualidade da interpretação têm provas diferentes. Preserve a pergunta, condições, fontes utilizadas e limite fora das Rotas operacionais; use o retorno para melhorar o percurso afetado. ## Fazer uma referência comum chegar a dois agentes Escolha o mecanismo pelo acesso real. Se ambos recuperam o mesmo original, as rotas apontam para ele e a nova ocorrência confere a edição lida. Se um ambiente precisa de cópia, declare origem, conteúdo copiado, edição recebida e quem realiza a substituição. Guarde personalizações em peça própria ou declare sua variação para que a atualização não as apague. Um link não executa sincronização nem garante releitura numa sessão aberta. Aproveite o catálogo existente para registrar, em cada consumidor, a fonte, a pergunta atendida, a relação e a forma de atualização. O endereço idêntico permite localizar os consumidores conhecidos sem criar uma base de fontes. A busca deve cobrir também instruções ou cópias que se saiba estarem fora do catálogo; sua conclusão nomeia o universo examinado. Quando houver mudança, percorra entrada do agente → rota → conteúdo recebido → caso afetado → resultado salvo. Para consulta direta, ler a edição atual é a conferência de chegada. Para cópia, compare o conteúdo que deveria coincidir e examine a aplicação local em separado. Se a origem mudou mas a cópia não chegou, o consumidor continua com pendência; não marque o conjunto como atualizado. O [exemplo de conhecimento compartilhado](../Exemplos-Couto-IAS/Conhecimento-Compartilhado/Leia-me.md) contém os dois mecanismos, rotas com alternativa e uma demanda única. Seus caminhos são relativos à pasta do exemplo; a instalação deve resolver o acesso efetivo, conforme M11.