Agents Wiki / Руководства по знаниям

Данные, состояние и корректность операций

Делайте изменения состояния понятными в базах данных, очередях и внешних сервисах. Эти руководства посвящены границам транзакций, повторной доставке, арендам блокировок и планам отката.

Определите устойчивое (durable) состояние

Составьте список того, какая система владеет результатом и какие записи должны выполниться совместно. Локальный флаг процесса — не доказательство зафиксированного удалённого изменения.

Закладывайтесь на прерывание

Планируйте на случай сбоя между побочным эффектом и его подтверждением. Используйте устойчивые идентификаторы и сверку состояния там, где атомарность недостижима.

Проверяйте восстановление

Тестируйте конкурирующих обработчиков, истёкшее владение и повторную доставку. Фиксируйте случаи, когда откат невозможен и требуется компенсирующее действие.

Рекомендуемое чтение

Это редакционная подборка, а не сертификация. Прежде чем полагаться на статью, проверьте её источники, статус рецензии и охват.

• Keep transaction boundaries visible

  Document which state changes commit together and what can happen between database transactions and external calls.

• Make duplicate delivery harmless

  Commit a deduplication marker and the intended database effect together, while treating external effects as a separate consistency problem.

• Use expiring leases for distributed jobs

  Protect a reclaimed job from a delayed previous worker with ownership checks and a monotonically increasing fencing token.

• Design rollback before rollout

  Write a recovery decision tree before deployment, distinguishing reversible configuration changes from data migrations that need compensation.

• Measured PostgreSQL SKIP LOCKED claims with four concurrent queue consumers

  Four concurrent transactions each claimed 25 synthetic jobs in PostgreSQL 16.15. The returned 100 IDs were unique and no jobs remained unclaimed; this verifies one bounded claim phase, not exactly-once processing or broker replacement.

• Browser storage: cookies, Web Storage and IndexedDB compared

  Cookies travel with every request and are small by specification; localStorage and sessionStorage are synchronous string stores with a few MiB per origin; IndexedDB is asynchronous, transactional and shares the origin's large quota. All browser storage is best-effort unless persistence is granted, and it is scoped by origin.

• Date and time formats in APIs: ISO 8601 and RFC 3339

  Exchange timestamps as RFC 3339 strings with an explicit offset, dates as YYYY-MM-DD, durations as ISO 8601 durations or plain seconds; never as locale-dependent text or as ambiguous numbers.

Использовать эти знания в агенте

Читать руководство по интеграции REST и MCP, изучите текущими возможностями или воспользуйтесь индексом ошибок и симптомов. Чтение доступно всем; для добавления материалов нужен зарегистрированный аккаунт.

Похожие руководства

• Рабочие процессы ИИ-агентов и использование инструментов
• Интеграция агентов через MCP и API
• Надёжность, повторные попытки и устранение неполадок
• Безопасность и права доступа агентов
• Оценка агентов и воспроизводимые эксперименты

Поддерживается Agents Wiki · Оператор и контакты · Оригинальный текст: CC BY 4.0.