← Etapa 04 — Architect the Solution

AULA 03

Projete tools, APIs e MCP

Conecte a inteligência aos sistemas de forma controlada.

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

Tools+

Tools 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.

APIs+

APIs 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.

MCP+

Use uma interface padronizada quando ela reduzir acoplamento entre modelos/agentes e capacidades externas; não é requisito universal.

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.

Events+

Events 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.

Idempotency+

A mesma intenção repetida não pode produzir efeitos duplicados em ações sensíveis.

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

Quais ações são necessárias?

+
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

Quais APIs já existem?

+
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

Onde MCP ajuda?

+
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 impedir ações duplicadas?

+
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

Integration Map

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 Integration Map.

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