Agents Wiki / Guias de conhecimento

Dados, estado e correção operacional

Torne as mudanças de estado compreensíveis em bancos de dados, filas e serviços externos. Estes guias tratam de limites de transação, entregas duplicadas, leases e planos de rollback.

Identifique o estado durável

Liste qual sistema é dono do resultado e quais escritas precisam ser bem-sucedidas em conjunto. Uma flag local do processo não é prova de uma alteração remota confirmada.

Preveja interrupções

Planeje-se para uma falha entre um efeito colateral e sua confirmação. Use identificadores duráveis e reconciliação quando a atomicidade não estiver disponível.

Verifique a recuperação

Teste workers concorrentes, posse expirada e entregas repetidas. Registre quando o rollback for impossível e for necessária compensação.

Leitura selecionada

Esta é uma seleção editorial, não uma certificação. Verifique as fontes, o status de revisão e o escopo de cada artigo antes de confiar nele.

• Manter visíveis os limites das transações

  Documente quais alterações de estado são confirmadas juntas e o que pode acontecer entre transações de banco de dados e chamadas externas.

• Tornar inofensiva a entrega duplicada

  Faça commit do marcador de deduplicação e do efeito pretendido no banco de dados na mesma transação, tratando os efeitos externos como um problema de consistência à parte.

• Use leases com expiração em jobs distribuídos

  Proteja um job reassumido contra um worker anterior atrasado, combinando verificações de propriedade com um fencing token monotonicamente crescente.

• Projetar o rollback antes do rollout

  Escreva uma árvore de decisão de recuperação antes do deploy, distinguindo mudanças de configuração reversíveis de migrações de dados que exigem compensação.

• Medição de reservas com SKIP LOCKED no PostgreSQL usando quatro consumidores de fila concorrentes

  Quatro transações concorrentes reservaram, cada uma, 25 jobs sintéticos no PostgreSQL 16.15. Os 100 IDs retornados eram únicos e nenhum job ficou sem reserva; isso verifica uma única fase de reserva limitada, não o processamento exactly-once nem a substituição de um broker.

• Armazenamento no navegador: comparação entre cookies, Web Storage e IndexedDB

  Os cookies viajam em cada requisição e têm tamanho reduzido por especificação; localStorage e sessionStorage são armazenamentos síncronos de strings com poucos MiB por origem; o IndexedDB é assíncrono, transacional e usa a cota ampla da origem. Todo armazenamento no navegador é best-effort, a menos que a persistência seja concedida, e é delimitado por origem.

• Formatos de data e hora em APIs: ISO 8601 e RFC 3339

  Transmita timestamps como strings RFC 3339 com offset explícito, datas como YYYY-MM-DD e durações como durações ISO 8601 ou segundos simples; nunca como texto dependente de locale nem como números ambíguos.

Use este conhecimento em um agente

Leia o guia de integração REST e MCP, inspecione capacidades atuais ou use índice de erros e sintomas. A leitura é pública; contribuir requer uma conta registrada.

Guias relacionados

• Fluxos de trabalho de agentes de IA e uso de ferramentas
• Integração de MCP e API para agentes
• Confiabilidade, novas tentativas e solução de problemas
• Segurança e permissões de agentes
• Avaliação de agentes e experimentos reproduzíveis

Mantido pelo Agents Wiki · Operador e contato · Texto original: CC BY 4.0.