← Etapa 04 — Architect the Solution

AULA 02

Projete contexto, RAG e memória

Defina como a solução obtém conhecimento e mantém estado.

POR QUE IMPORTA PARA UM FDE

Arquitetura é uma consequência do workflow e do risco.

O FDE escolhe padrões e componentes somente depois de entender tarefas, contexto, ações e controles. Nem todo problema precisa de agente; nem todo agente precisa de memória, RAG ou múltiplos modelos.

Anti-padrão

Anti-padrão: começar por um framework de agentes e procurar um problema que caiba nele.

FRAMEWORK

O que dominar — e como usar

Context engineering+

Projete deliberadamente instruções, dados, histórico, tools e restrições que entram na janela de contexto.

Decisão que suporta

Use o conceito para reduzir uma incerteza que altera escopo, workflow, arquitetura, controle ou prioridade.

Evidências mínimas
  • um caso real
  • uma fonte ou métrica
  • uma exceção relevante
Teste de qualidade

Outra pessoa deve conseguir revisar a conclusão e chegar à mesma interpretação usando as evidências registradas.

Embeddings+

Embeddings deve ser ligado a uma decisão concreta do workflow. Defina owner, evidência, exceções e o que mudaria a decisão.

Decisão que suporta

Use o conceito para reduzir uma incerteza que altera escopo, workflow, arquitetura, controle ou prioridade.

Evidências mínimas
  • um caso real
  • uma fonte ou métrica
  • uma exceção relevante
Teste de qualidade

Outra pessoa deve conseguir revisar a conclusão e chegar à mesma interpretação usando as evidências registradas.

Retrieval+

Retrieval deve ser ligado a uma decisão concreta do workflow. Defina owner, evidência, exceções e o que mudaria a decisão.

Decisão que suporta

Use o conceito para reduzir uma incerteza que altera escopo, workflow, arquitetura, controle ou prioridade.

Evidências mínimas
  • um caso real
  • uma fonte ou métrica
  • uma exceção relevante
Teste de qualidade

Outra pessoa deve conseguir revisar a conclusão e chegar à mesma interpretação usando as evidências registradas.

Short-term memory+

Short-term memory deve ser ligado a uma decisão concreta do workflow. Defina owner, evidência, exceções e o que mudaria a decisão.

Decisão que suporta

Use o conceito para reduzir uma incerteza que altera escopo, workflow, arquitetura, controle ou prioridade.

Evidências mínimas
  • um caso real
  • uma fonte ou métrica
  • uma exceção relevante
Teste de qualidade

Outra pessoa deve conseguir revisar a conclusão e chegar à mesma interpretação usando as evidências registradas.

Long-term memory+

Persista somente informação útil, permitida e com política de atualização, expiração e exclusão.

Decisão que suporta

Use o conceito para reduzir uma incerteza que altera escopo, workflow, arquitetura, controle ou prioridade.

Evidências mínimas
  • um caso real
  • uma fonte ou métrica
  • uma exceção relevante
Teste de qualidade

Outra pessoa deve conseguir revisar a conclusão e chegar à mesma interpretação usando as evidências registradas.

EXEMPLO ENTERPRISE

Veja o conceito dentro do trabalho real

Uma consulta a política interna pode exigir RAG com citações; uma decisão de risco pode exigir regras determinísticas e aprovação; uma ação em ERP pode exigir tool com idempotência e least privilege.

Contexto→Evidência→Decisão→Impacto

PERGUNTAS DE DISCOVERY

Pergunte até chegar à evidência

01

Qual conhecimento é necessário?

+
Como aprofundar

Peça o último exemplo concreto. Depois pergunte frequência, impacto, variações, owner e qual dado poderia confirmar a resposta. Compare o caso normal com uma exceção.

Sinal de boa resposta

A resposta deixa de ser “normalmente” ou “acho que” e passa a conter caso, número, fonte, responsável e consequência.

02

Qual deve ser recuperado?

+
Como aprofundar

Peça o último exemplo concreto. Depois pergunte frequência, impacto, variações, owner e qual dado poderia confirmar a resposta. Compare o caso normal com uma exceção.

Sinal de boa resposta

A resposta deixa de ser “normalmente” ou “acho que” e passa a conter caso, número, fonte, responsável e consequência.

03

O que pode ser lembrado?

+
Como aprofundar

Peça o último exemplo concreto. Depois pergunte frequência, impacto, variações, owner e qual dado poderia confirmar a resposta. Compare o caso normal com uma exceção.

Sinal de boa resposta

A resposta deixa de ser “normalmente” ou “acho que” e passa a conter caso, número, fonte, responsável e consequência.

04

Como evitar contexto obsoleto?

+
Como aprofundar

Peça o último exemplo concreto. Depois pergunte frequência, impacto, variações, owner e qual dado poderia confirmar a resposta. Compare o caso normal com uma exceção.

Sinal de boa resposta

A resposta deixa de ser “normalmente” ou “acho que” e passa a conter caso, número, fonte, responsável e consequência.

LAB DE CAMPO

Produza evidência em vez de anotações

Para cada etapa do target workflow, escreva: informação necessária, decisão, ação, risco e padrão técnico mínimo.

Definition of done
  • decisões arquiteturais ligadas a requisitos
  • boundary de dados explícito
  • integrações e identidade definidas

FDE DELIVERABLE

Context Architecture

Entregue um artefato executivo que possa ser usado na próxima decisão, não um documento de aula. Inclua contexto, evidências, decisão ou hipótese, riscos, pontos em aberto e owner. Mantenha links para fontes e registre assumptions separadamente de fatos.

Critério FDE

Se o artefato não mudar ou sustentar uma decisão real, ele ainda não está pronto.

WORKBOOK

Exercício aplicado

Use seu caso real. Registre evidências, decisões e dúvidas que alimentarão o Context Architecture.

Evidência registrada

KNOWLEDGE CHECK

Valide sua compreensão

3 perguntas · aprovação com 2 acertos · você pode refazer

01O que esta aula deve permitir que o FDE faça principalmente?
02Qual artefato representa a evidência esperada de conclusão desta aula?
03Quando uma tarefa exige consultar políticas internas e citar a fonte, qual decisão arquitetural é mais defensável?

CHECKPOINT DA AULA

Conclua quando houver evidência

○ Workbook com evidência○ Knowledge Check

A conclusão é liberada quando o exercício contém evidência e o Knowledge Check foi aprovado.

← Voltar à etapa