Recursos: modelos, dados e orçamento|INEMA.CLUB-PRO

Aula 3 · 20 min

Conhecimento da empresa como ativo

Na segunda de manhã a Hora cotou o detergente pelo preço de setembro. Não foi erro do modelo: a tabela nova e a antiga estavam na mesma pasta, e ninguém era dono de nenhuma das duas. O agente sabe o que a empresa escreveu para ele. Nesta aula você organiza esse conhecimento como um ativo: cada documento com dono, versão e validade.

Começar a aula
Mulher organiza fichários com abas coloridas numa estante baixa do escritório, segurando um tablet; um colega trabalha ao fundo.

Nesta aula você vai

  1. 1Os cinco tipos de conhecimento que o agente lê
  2. 2Dono, versão e validade em cada documento
  3. 3Resolver conflito entre fontes antes que o agente escolha
  4. 4O que fica fora do pacote, e por que exemplo não é teste

Objetivo: organizar procedimentos, exemplos e regras que o agente lê num pacote de contexto em que cada documento tem dono, versão e validade.

01O pacote de contexto

Tudo o que o agente lê cabe em cinco caixas. A última é a que mais protege. Clique em cada uma.

Clique em cada bloco do diagrama para ver o que ele faz.

Divisão do módulo 4 do método Gestoria (INEMA): procedimentos, exemplos, regras e conhecimento recuperável, com dono e versão. Horizonte: empresa fictícia de estudo.

02Como transformar documentos em ativo

Quatro regras. Nenhuma exige programar; todas exigem decidir quem cuida de quê.

1. Todo documento tem dono

Para cada documento: dono (quem corrige quando estiver errado), versão, data de validade e onde fica. "A empresa" ou "o comercial" não é dono: quando ninguém é, ninguém atualiza.

O dono avisa quem cuida do agente quando muda o documento. Mudou a tabela, muda a versão em uso no agente no mesmo dia, e a anterior vai para o arquivo.

Na Horizonte (fictício)O preço de setembro saiu porque a pasta tinha "tabela-precos.pdf" e "tabela-precos-NOVA.pdf". Agora: "Tabela de preços · v2026-10 · válida até 31/10 · dona: Patrícia". Uma só em uso.

03Modelos para copiar

O índice do pacote, o procedimento reutilizável e um prompt que procura conflito. A aba ao lado mostra o pacote da Patrícia.

Índice do pacote de contexto
PACOTE DE CONTEXTO · agente <nome> · processo <...> · versão do pacote <...> · data <...>
Responsável pelo pacote: <nome>

| # | Documento | Tipo (regra/referência/procedimento/exemplo) | Dono | Versão | Válido até | Onde fica |
|---|---|---|---|---|---|---|
| 1 | <...> | regra | <nome> | v<...> | <data> | <pasta> |

PRECEDÊNCIA: regra > referência > procedimento > exemplo
CONFLITO ENCONTRADO: o agente não decide; avisa <nome>, que corrige em <prazo>
FORA DO PACOTE: <dados e documentos que o agente não lê>
CASOS DE TESTE: guardados em <pasta que o agente não lê>; nenhum é exemplo
MEMÓRIA: guarda <...> · não guarda <...> · por <prazo> · quem corrige <nome>
REVISÃO DO PACOTE: <periodicidade> e sempre que um dono mudar um documento
Procedimento reutilizável (Skill)
PROCEDIMENTO · <nome> · versão <...> · dono <nome>

USE QUANDO: <gatilho>
NÃO USE QUANDO: <exclusões>
ENTRADAS OBRIGATÓRIAS: <...>
FONTES PERMITIDAS: <documentos do pacote, com versão>
PASSOS (cada um dá para conferir):
1. <...>
2. <...>
3. <...>
SAÍDA: <campos e formato>
CRITÉRIO DE SUCESSO: <como o revisor confere>
FALHA OU DADO FALTANDO: <para quem vai, com o quê>
EXEMPLO BOM / EXEMPLO RUIM: <um de cada, que não esteja nos testes>
Prompt · procurar conflito e lacuna
Você é revisor de documentação operacional. Abaixo estão os documentos
que um agente de IA lê para trabalhar. Não reescreva nada: aponte.

1. Dois documentos dizem coisas diferentes sobre o mesmo assunto?
   Cite os dois trechos.
2. Algum documento não tem dono, versão ou validade?
3. Há dado que a tarefa não precisa (documento pessoal, dados de
   outros clientes, versão vencida)?
4. Que pergunta frequente do cliente nenhum documento responde?

Documentos:
"""<cole>"""
Simulação: exemplo ilustrativo

Pacote · Hora · v3 · Horizonte, empresa fictícia de estudo · responsável: Patrícia

  1. Política comercial · regra · dono: Carlos · v1.2 · revisão trimestral.
  2. Constituição da Hora · regra · dona: Patrícia · v2.0 (G3).
  3. Tabela de preços · referência · dona: Patrícia · v2026-10 · válida até 31/10.
  4. Catálogo (produtos, embalagem, caixa = 6 galões) · referência · dona: Patrícia · v2026-10.
  5. FAQ de entrega (cidades, dias, pedido mínimo) · referência · dona: Juliana · v4 · conflito com a política corrigido.
  6. Procedimentos "montar pedido de reposição" e "responder prazo de entrega" · dona: Patrícia · v1.
  7. Exemplos: 10 conversas boas e 5 ruins com a correção · dona: Patrícia · nenhuma entre os 20 casos de teste.

Fora: CPF, a planilha inteira de clientes, conversas de outros clientes, tabela de setembro (arquivada).

04Prática

O pacote da Patrícia para treinar; o da sua área para valer.

1 · O pacote da Patrícia

30 min

Abra o prompt da Hora no laboratório e marque o que nele é regra, referência, procedimento ou exemplo (está tudo misturado num texto só). Monte o índice do pacote com o modelo, escreva um procedimento completo e a lista do que fica fora. Inclua a planilha de clientes do laboratório na lista de fora e diga por quê.

Pronto quando: o índice tem pelo menos 6 documentos, cada um com tipo, dono com nome, versão e validade; a ordem de precedência está escrita; há um procedimento com as 9 partes do modelo; a lista de fora tem pelo menos 3 itens, entre eles a planilha de clientes.

2 · O pacote da sua área

60 min

Liste tudo o que o agente do seu processo lê hoje (ou o que você daria a uma pessoa nova). Classifique, dê dono e versão, resolva os conflitos e escreva um procedimento da tarefa mais frequente. Rode o prompt de conflito e marque cada ponto como corrigido ou com dono e prazo.

Pronto quando: o índice está salvo com dono, versão e validade em todos os documentos, nenhum documento em duas versões em uso, cada conflito apontado tem dono e prazo, um procedimento está escrito e os casos de teste estão numa pasta separada dos exemplos.

Peças de origem: configuração e prompt da Hora e planilha de clientes (o que não deve entrar no pacote).

05Teste rápido

4 perguntas. A explicação aparece depois da sua tentativa.

Pergunta 1 de 4

A Hora cotou um preço vencido. A primeira correção de gestão é:

06Resumo

Cinco caixasRegras, referência, procedimentos, exemplos e o que fica fora.
Dono, versão, validadeEm cada documento. Uma versão em uso.
Precedência escritaConflito não é decidido pelo agente: vai para o dono, com prazo.
Exemplo não é testeCasos de teste numa pasta que o agente não lê.

Para ir além

Laboratório Horizonte: o prompt e a configuração da Hora (empresa fictícia de estudo)Kit do Arquiteto de Agentes: especificação e contexto de um agenteGestão de IA: o plano do curso (módulo 4, contexto e Skills)
Aula anteriorPróxima aula