---
titulo: Desenhar o ambiente e o modelo de gestão
modelo: Modelo de Gestão de Agentes de IA
codigo: M02
versao: "1.2.0-rc.1"
consumo: integral para conceber ou reformar o ambiente; consulta por objeto na manutenção
---

# M02 — Desenhar o ambiente e o modelo de gestão

O ambiente de gestão torna encontráveis as contribuições, as demandas, as fontes e as decisões que sustentam o trabalho dos agentes. Recebe o enquadramento de [M01](M01-Compreender-o-Trabalho-e-Enquadrar-a-Solucao.md) e o transforma em uma organização que o gestor e a IA conseguem consultar, atualizar e retomar.

O desenho especifica significado, identidade, propriedades, relações, fonte e manutenção. Uma tabela, uma pasta ou um painel participa quando permite uma pergunta ou operação necessária. O ambiente pode começar pequeno e ampliar-se com o uso, preservando a identidade dos objetos e a origem das informações.

## M02.1 — Compreender o trabalho que o ambiente sustenta

Recupere as contribuições concebidas, os usuários, as entregas e o percurso de uma demanda. Examine também o que já existe: cadastro, fila, pasta, procedimento e fonte operacional. Uma organização suficiente deve ser aproveitada, mesmo que tenha outra apresentação.

Comece pelas perguntas que o gestor precisa responder. Exemplos: que agentes existem e para que servem; qual demanda exige atenção e por quê; o que depende de decisão; onde está a última entrega; que fonte orienta dois agentes; que mudança ainda precisa chegar a uma cópia.

Para cada pergunta, identifique o objeto, o atributo ou vínculo necessário e quem mantém a informação. Se a pergunta é “o que espera minha decisão?”, o ambiente precisa reconhecer a demanda, a decisão requerida, a razão da espera e o responsável pertinente. Um status sem explicação pode localizar a fila, mas deixa a decisão por reconstruir.

Separe informação necessária à gestão da informação necessária à execução. O catálogo pode mostrar a função e a situação de um agente e apontar para sua orientação completa. O gestor não precisa navegar pelo corpo de cada fonte para reconhecer o conjunto; o executor precisa de uma rota que o leve ao conteúdo quando a demanda o exige.

**Saída:** perguntas de uso, objetos e relações necessários, arranjo existente aproveitável e insuficiências a resolver.

## M02.2 — Definir objetos e preservar identidades

Escolha a unidade de cada registro pelo que permanece reconhecível ao longo de mudanças. Um agente conserva sua identidade quando recebe nova edição de instruções. Uma demanda conserva sua identidade ao passar de análise para produção. Uma fonte pode receber edições sem se tornar outra fonte em cada atualização.

O quadro define um esquema lógico de referência. Ele orienta a composição; a aplicação escolhe quais objetos precisam de representação própria.

| Objeto | Identidade e conteúdo necessários | Relações materiais |
|---|---|---|
| Agente | Identificador estável, nome, contribuição, responsável humano quando definido, condição de uso e entrada do ambiente. | Demandas atribuídas, fontes utilizadas, componentes e avaliações pertinentes. |
| Demanda | Identificador, pedido de origem, resultado esperado, destinatário, responsável pela condução, condição atual e próximo movimento. | Agentes participantes, fontes do caso, decisões e entregas. |
| Fonte | Identificador ou localizador estável, objeto que governa, responsável quando conhecido, edição/validade pertinentes e condição de acesso. | Agentes e métodos consumidores e cópias que exijam manutenção. |
| Decisão | Conteúdo decidido, autoridade, contexto, data ou condição pertinente e razão quando necessária à revisão. | Demanda ou objeto que altera e evidência da decisão. |
| Entrega | Objeto produzido, localizador, destinatário, critérios pertinentes e condição da conferência. | Demanda de origem, agente produtor e retorno de uso. |
| Avaliação | Objeto e edição examinados, pergunta, critérios, achados e consequência. | Fonte da evidência e ajuste correspondente. |

Um identificador serve para reencontrar o mesmo objeto e ligar suas representações. Reutilize os identificadores existentes; escolha um mecanismo estável para objetos novos. Nome, ordem na lista e posição de pasta são apresentações que podem mudar.

Decisão, entrega e avaliação podem ficar no corpo da demanda quando têm um único contexto e uso simples. Uma base própria se justifica quando precisam de consulta, acesso, ciclo de vida ou relações independentes. Não se cria uma base para cada substantivo do quadro.

Uma demanda com vários agentes continua uma demanda. Se houver apenas colaboração simples, a relação pode indicar o agente que conduz e os participantes. Se cada participação tiver resultado, situação ou responsabilidade próprios, represente essa participação como objeto associado. Evite copiar a demanda inteira para a lista de cada agente: as cópias perderiam condição e decisões comuns.

## M02.3 — Especificar propriedades, relações e vistas

Uma propriedade deve responder a uma pergunta ou permitir uma operação. Defina seu significado e quem a atualiza. Texto livre funciona quando a variabilidade importa; opção controlada ajuda quando o mesmo estado precisa de filtro e interpretação consistente; relação liga identidades; uma vista apresenta um recorte da mesma informação.

Para cada relação importante, especifique origem, verbo e destino. “Agente utiliza fonte” difere de “agente mantém fonte”. A primeira orienta recuperação e impacto; a segunda atribui manutenção. A existência do vínculo não demonstra que a fonte foi efetivamente lida em uma demanda.

O esquema implementável deve declarar, na proporção necessária:

| Elemento | O que especificar |
|---|---|
| Propriedade | Nome, significado, tipo lógico, condição de preenchimento e quem produz seu valor. |
| Relação | Objetos vinculados, sentido da ligação, possibilidade de ligar um ou vários registros e informação que pertence a cada participação. |
| Valor de situação | Condição que permite entrar, evidência que permite sair e próximo movimento esperado. |
| Vista | Pergunta respondida, fonte, filtros, agrupamento e o que permanece fora do recorte. |
| Derivação | Informação de origem e transformação que produz o valor, evitando edição concorrente de um resultado calculado. |

Exemplo ilustrativo: se uma demanda envolve dois agentes, defina se ela pode se ligar a vários registros de agentes. Se o resultado ou a responsabilidade de cada agente precisar de acompanhamento próprio, associe essa informação à participação dele, sem copiar a demanda inteira. Isso explica o que pertence ao vínculo; não determina uma nova base para todo caso.

Em uma fila simples, “a esclarecer”, “pronta para execução”, “em realização”, “aguarda decisão”, “entregue para uso” e “encerrada” podem servir como vocabulário inicial, se corresponderem ao trabalho. Esses valores são uma composição de referência. A aplicação preserva vocabulário já suficiente ou escolhe outro com condições explícitas.

“Pronta para execução” significa que existem condições suficientes para a operação seguinte; não exige que todo o futuro seja conhecido. “Aguarda decisão” identifica qual decisão, de quem e o que pode prosseguir enquanto isso. “Entregue para uso” informa disponibilidade ao destinatário, sem provar utilização. O encerramento depende do contrato daquela demanda, e não apenas de uma marca visual.

Prioridade é outra dimensão. Ela indica uma escolha de ordem ou atenção e deve ter origem reconhecível. Data de criação, prazo solicitado e prioridade aceita podem influenciar a decisão, mas não se substituem automaticamente.

Vistas úteis incluem catálogo de agentes, demandas por condição, decisões que esperam o gestor, trabalhos por agente e mudanças de fonte com consumidores afetados. Criar uma vista não cria outra fonte. Um filtro escondendo registros também não demonstra restrição de acesso.

## M02.4 — Distribuir informação entre Notion, pastas e plataforma de IA

Defina a fonte por objeto e a função das representações. No arranjo de referência, o Notion organiza cadastro, relações, demandas e decisões; as pastas mantêm os componentes, referências e artefatos que existem como arquivos; a plataforma de IA recebe configuração, conteúdo exposto e conversas de trabalho.

Essa distribuição precisa ser ajustada ao existente. Se o registro vigente de uma demanda já está em outro sistema, uma referência ou vista pode bastar. Não transfira autoridade para um painel apenas porque ele é mais conveniente de consultar.

| Informação | Tratamento no arranjo |
|---|---|
| Função e entrada do agente | Registro de gestão com ligação ao componente competente. |
| Critério ou procedimento | Original na casa responsável, alcançado por rota ou cópia declarada quando necessária. |
| Condição de uma demanda | Um registro vigente; outras vistas e resumos apontam para ele. |
| Configuração instalada | Edição no ambiente de execução, relacionada à fonte de autoria. |
| Resultado de trabalho | Artefato no destino apropriado, vinculado à demanda e à conferência. |
| Contexto para retomada | Informação suficiente no objeto vigente ou em registro relacionado, conforme a responsabilidade. |

Uma cópia necessária identifica origem, alcance, edição e forma de atualização. Uma aplicação com método próprio preserva sua relação com a inteligência de origem e é revista por impacto; não recebe mecanicamente toda alteração da fonte. [M05](M05-Organizar-Conhecimento-Compartilhado-Fontes-e-Rotas.md) desenvolve essas relações de conhecimento e [M07](M07-Compor-o-Kit-e-Preservar-a-Continuidade.md) sua realização no kit.

A configuração na IA e a informação de gestão não se atualizam mutuamente por pressuposição. O desenho identifica a capacidade ou a intervenção que realiza cada passagem. Quando a pessoa precisa aplicar uma alteração, ela recebe conteúdo, destino e critério de conferência suficientes, em vez de uma tarefa vaga de “sincronizar tudo”.

## M02.5 — Organizar catálogo e ambiente de cada agente

O catálogo permite reconhecer contribuição, situação e entrada do agente. Seu registro deve levar ao ambiente de trabalho e aos componentes competentes sem obrigar o gestor a lembrar caminhos da autoria.

O ambiente individual oferece acesso a orientação, fontes, demandas, entregas e continuidade pertinentes. Essas entradas podem ser referências para objetos compartilhados. Uma fonte usada por vários agentes não precisa de um original por ambiente individual.

Mantenha distintas a condição da construção do agente, a edição instalada e a situação de seus trabalhos. Um agente pode ter uma melhoria a incorporar e continuar atendendo demandas no alcance definido. Um trabalho bloqueado não torna todas as capacidades do agente indisponíveis.

Ao registrar uma condição, associe a evidência e sua consequência. “Componentes preparados”, “configuração presente” e “aplicação realizada” dizem coisas diferentes. A autorização para operar pertence ao responsável pelo contexto; o catálogo permite recuperar essa condição sem substituí-la por inferência visual.

## M02.6 — Relacionar demandas, pendências e continuidade

Uma pendência representa algo que falta para um resultado ou decisão. Registre objeto afetado, diferença a resolver, próximo movimento e responsável quando sustentado. Uma espera deve permitir reconhecer a condição de retomada; “pendente” sem objeto devolve a investigação ao gestor.

O Kanban é uma vista do fluxo. Para usá-lo, ligue cada coluna à condição do trabalho e defina qual fato autoriza a mudança. Arrastar um cartão pode registrar uma decisão ou representar outra ação, mas o gesto não prova que o trabalho subjacente ocorreu.

Uma decisão que altera prioridade, escopo ou compromisso deve atualizar o objeto competente e preservar a origem necessária à compreensão. Um resumo na conversa pode ajudar a atuar, mas a próxima ocorrência precisa chegar à condição vigente.

Escolha o destino de continuidade pela responsabilidade. Um estado do agente pode guardar suas frentes e apontar para demandas; o corpo da demanda pode guardar a condição daquele caso. Se ambos mostrarem uma situação, um deles é a fonte e o outro é referência ou resumo com relação de atualização clara. Não crie dois escritores independentes para o mesmo fato.

## M02.7 — Dimensionar a estrutura e ampliar pelo uso

Comece pelas perguntas do trabalho. Para um primeiro uso, um catálogo simples, uma demanda identificada, fontes pertinentes e um caminho de entrega podem ser suficientes. Acrescente objetos quando sua ausência exigir recomposição, criar ambiguidade de responsabilidade ou impedir uma consulta necessária.

Compare o custo de manter a estrutura com a diferença que ela produz. Uma base de avaliações é útil se permite relacionar achados, edições e correções recorrentes; pode ser dispensável quando uma devolução no próprio trabalho preserva tudo o que se precisa recuperar.

Um campo sem informação pode representar desconhecimento legítimo ou atributo inaplicável. Não preencha responsáveis, datas ou relações por plausibilidade para deixar o ambiente visualmente completo. Mostre a lacuna onde muda uma operação; dispense o que não tem uso.

Ao ampliar, preserve identidades e ligações. Migre primeiro as definições e os consumidores que dependem da mudança, confira o destino e mantenha a origem necessária à reconciliação. A organização deve acompanhar a evolução do trabalho, sem exigir uma reconstrução a cada agente novo.

## M02.8 — Construir e conferir o ambiente

Antes da implementação, produza um acordo informacional: perguntas de uso; objetos e identidades; propriedades e relações; fonte e manutenção por informação; entradas dos consumidores; condição de acesso; alterações propostas no existente; sequência e critério de conferência.

Antes de criar ou alterar bases com uma IA ou ferramenta de integração, consulte a estrutura atual do sistema: bases, propriedades, relações e recursos já disponíveis. Use os identificadores retornados pelo destino para ligar os objetos. Se uma operação criar apenas parte do ambiente, localize o que foi criado e complete a parte faltante; repetir toda a criação pode gerar duplicatas.

Conduza a criação no alcance autorizado. Confira alvos e contribuições existentes antes de escrever. Preserve o conteúdo fora do recorte e releia o salvo. Para relações, confira os dois objetos e o sentido; para vistas, percorra uma pergunta representativa e examine o filtro e a fonte do resultado.

O ambiente atende ao desenho quando um consumidor consegue reconhecer o objeto certo, sua condição e a fonte pertinente e realizar a operação prevista com os meios e a autoridade recebidos. Um teste de consulta não demonstra uma capacidade de escrita; uma consulta em uma conta não demonstra o acesso de outra.

### Exemplo de composição

Em um exemplo ilustrativo de análise de pedidos e preparação de propostas, há dois agentes, demandas com código próprio e uma referência comum de condições. O catálogo liga cada agente à contribuição e à entrada de seu ambiente. Uma única demanda guarda a definição de escopo e aponta para a análise e para a proposta; vistas por agente mostram suas participações.

O documento de condições tem um original e consumidores identificados. A plataforma pode receber uma referência conectada ou uma cópia de edição reconhecível, conforme o acesso real. A mudança no original exige examinar esse mecanismo e conferir o conteúdo utilizado. O ambiente registra a intervenção necessária sem afirmar que o vínculo, sozinho, realizou atualização.

Se o agente de proposta não tiver escrita no registro de demandas, ele produz a proposta e a atualização exata a aplicar, com destino e razão. A pessoa autorizada faz a aplicação e a conferência pertinente. Essa passagem assistida integra o desenho e seu esforço fica visível para uma eventual melhoria.

## Contrato de saída e relações

M02 entrega um desenho implementável: o gestor sabe que informação existe, qual objeto a representa, onde ela vigora, quem a mantém, como se relaciona e por onde é utilizada. Os componentes técnicos podem ser construídos a partir desse contrato sem inventar bases ou replicar registros por hábito.

M01 governa o enquadramento e o resultado; M05 desenvolve fonte e recuperação; M07, kit e continuidade; [M10](M10-Compor-Acessos-Ferramentas-e-Operacoes.md), capacidades e passagens; [M11](M11-Implementar-e-Instalar-em-Cada-Ambiente.md), configuração por ambiente; [M13](M13-Operar-Gerir-e-Evoluir-o-Conjunto.md), operação e evolução. Uma insuficiência dessas relações devolve apenas o ponto afetado à casa correspondente.