Artefatos
Artefatos são resultados gerados que merecem ser abertos, revisados ou baixados como objetos próprios.
O que um card mostra
- Nome e tipo do resultado.
- Preview quando ele realmente ajuda.
- Ações de abrir, baixar ou continuar trabalhando.
Relação com a conversa
O artefato continua ligado ao pedido que o produziu, preservando o contexto de por que aquele arquivo existe.
Artefato como handoff
Um artefato bom é algo que outra pessoa consegue abrir, revisar e usar sem reconstruir o raciocínio que o gerou.
- Prefira entregas com estrutura, nome claro e estado final verificável em vez de apenas colar conteúdo no chat.
Primeira decisão
Imagine uma tarefa real em que Artefatos deixa de ser uma opção de menu e passa a decidir a qualidade da entrega. Faça uma primeira passagem curta, observe o retorno do sistema e só então aumente escopo, quantidade de arquivos ou duração da sessão.
No app principal, preserve continuidade entre conversa, projeto, arquivo e ação para que o usuário não precise reconstruir o contexto a cada tela.
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
- revise a saída no mesmo ambiente em que ela será usada
- confirme o estado antes de iniciar a próxima ação
Como manter o contexto
Se o comportamento divergir do esperado, separe falha visual, falha de dados e falha de execução. O objetivo é descobrir em qual etapa de Artefatos o estado deixou de corresponder ao que a interface prometia.
Use Artefatos como uma referência de operação, não como uma tela isolada. A própria proposta da página é: Artefatos são resultados gerados que merecem ser abertos, revisados ou baixados como objetos próprios. O ganho aparece quando isso se conecta ao que vem antes e ao que precisa acontecer depois.
Falhas recuperáveis
Considere o fluxo concluído quando o resultado pode ser reaberto, revisado e entendido sem depender da memória de quem executou a tarefa. Isso é especialmente importante em Artefatos, onde o contexto pode atravessar mais de uma etapa.
Comece por “O que um card mostra”, confirme o estado visível e avance para “Relação com a conversa” apenas quando a etapa anterior estiver estável. Em Artefatos, pular contexto costuma gerar mais retrabalho do que velocidade.
- confirme o estado antes de iniciar a próxima ação
- mantenha arquivos, sessão e contexto ligados ao mesmo objetivo
- trate mensagens de erro como dados de diagnóstico, não como detalhe visual
Resultado esperado
Nem todo caso precisa da configuração mais avançada. Prefira o caminho mínimo que resolve o objetivo e aumente complexidade somente quando Artefatos realmente exigir mais contexto, controle ou verificação.
Contrato desta superfície: Artefatos
Nesta página, a referência completa cobre criação, preview, validação, download e reabertura. O objetivo não é decorar nomes de controles; é entender entradas, estado, efeitos colaterais, falhas recuperáveis e a evidência que confirma a conclusão.
- confirme o estado inicial antes de executar a ação
- identifique quais dados ou arquivos a superfície realmente possui
- trate loading, vazio, erro, retry e reentrada como comportamento principal
- verifique o resultado no mesmo contrato que o usuário consegue observar
Casos de borda de Artefatos
A versão robusta desta função continua coerente quando a rede atrasa, a sessão muda, o conteúdo está vazio, o usuário repete a ação, o viewport encolhe ou uma dependência externa deixa de responder. Esses estados fazem parte da documentação porque também fazem parte do produto.
