← Etapa 09 — Build the Agent

AULA 01

Defina o contrato do agente

Converta o problema, workflow e arquitetura em um contrato implementável: objetivo, entradas, saídas, autonomia, limites e critérios de sucesso.

POR QUE IMPORTA PARA UM FDE

Descubra o problema real, não o pedido inicial.

Pedidos chegam em formato de solução: “queremos um chatbot”, “automatize esta etapa”, “coloque IA aqui”. O FDE precisa voltar ao trabalho real, observar evidências e definir qual problema merece ser resolvido.

Anti-padrão

Anti-padrão: transformar a primeira descrição do stakeholder em backlog sem observar o workflow.

FRAMEWORK

O que dominar — e como usar

Agent contract+

Agent contract 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.

System instructions+

System instructions 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.

Inputs & outputs+

Inputs & outputs 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.

Autonomy+

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

Acceptance criteria+

Acceptance criteria 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.

EXEMPLO ENTERPRISE

Veja o conceito dentro do trabalho real

Uma área pede um agente para responder chamados. O shadowing revela que 40% do tempo não está na resposta, mas na busca de contexto em três sistemas e na correção de cadastros incompletos. O problema muda — e a solução também.

Contexto→Evidência→Decisão→Impacto

PERGUNTAS DE DISCOVERY

Pergunte até chegar à evidência

01

Qual objetivo o agente deve cumprir?

+
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 entradas recebe?

+
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

Quais ações pode executar?

+
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

Quando deve escalar para humano?

+
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

Acompanhe três casos reais, incluindo uma exceção. Cronometre espera, execução e retrabalho e compare com o processo oficial.

Definition of done
  • casos reais observados
  • baseline mensurável
  • causa separada de sintoma

FDE DELIVERABLE

Agent Contract

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 Agent Contract.

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?
03O agente funciona na demo, mas ainda não possui evals, guardrails nem fallback. Qual deve ser a decisão do FDE?

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