Artefato e Contrato
O arquivo estruturado que cada etapa da pipeline produz e que a etapa seguinte é obrigada a ler. É o que substitui copiar e colar do chat.
O que é um artefato
Artefato é o resultado produzido pela interação com a IA, geralmente um arquivo. Não é o texto que aparece na tela do chat: é um arquivo salvo, estruturado, que outro agente vai conseguir ler depois.
A mudança de hábito é simples e muda tudo: pare de copiar texto do chat. Toda vez que uma etapa produz uma saída, ela produz um arquivo.
Por que JSON
Porque é um formato estruturado, com regras a seguir. Agentes performam melhor com estrutura, já que são muito bons em seguir ordens quando elas estão bem definidas.
Um roteiro vira roteiro.json. Uma pesquisa vira pesquisa.json. Uma pauta vira intake.json.
O artefato como contrato
Esse arquivo é o contrato entre as etapas da sua pipeline:
Você não pode produzir um roteiro sem ter feito a pesquisa antes, porque o roteiro precisa ler
pesquisa.jsonpara existir. Se o arquivo não está lá, a etapa não roda.
É isso que impede a bagunça em que cada etapa inventa o próprio ponto de partida.
Um exemplo real de estrutura
Um pesquisa.json bem feito separa:
- Fatos confirmados, cada um com a fonte e o tipo da fonte (paper, documentação oficial, artigo)
- Alegações não confirmadas, com a explicação de por que não passaram
- Ângulos propostos
- Riscos editoriais, ou seja, por que aquele vídeo pode dar errado ou perder monetização
- Riscos legais
Num caso real, o gancho da pauta prometia que “a pipeline completa roda em 7 segundos”. O agente não encontrou fonte, marcou como alegação não confirmada e explicou que o número vinha do próprio gancho, criado para prender o espectador. O sistema barrou a promessa falsa antes de ela virar vídeo.