OpenAICloudflare Developer Platform2026/06/19 0:00

Durable Objects - Outbound connections keep Durable Objects alive

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

Durable Objects:アウトバウンド接続でオブジェクトが維持される

Key Points

  • アウトバウンド接続で維持
  • 最大15分の延長
  • LLMストリーミング保護

Summary

Durable Objects は、connect() やアウトバウンド WebSocket で作成されたアクティブなアウトバウンド接続が存在する間、オブジェクトを強制的に維持するようになりました。以前は受信トラフィックがないと70〜140秒でエビクションされていましたが、今回の変更でストリーミングや長時間のアウトバウンド接続中に中断されるリスクが軽減されます。

Key Points

  • アウトバウンド接続(connect() またはアウトバウンド WebSocket)がアクティブな間、各接続が Durable Object のエビクションを防止します。
  • すべてのアウトバウンド接続が閉じられると、従来どおり70〜140秒の非アクティブウィンドウ後にエビクションされます。
  • 各アウトバウンド接続による維持効果は最大15分まで(15分経過後は接続自体は継続するがエビクション防止効果は切れます)。
  • 既存のアカウント単位のインスタンス上限は引き続き適用されます。
  • LLMトークンのストリーミングや長時間のアウトバウンド処理を行うエージェントで特に有用です。

Recommendations

  • 長時間ストリーミングを想定する場合は15分を超える処理を分割するか、再接続戦略を実装してください。
  • エビクションやインスタンス上限を監視し、必要に応じてリトライやフォールバックを組み込んでください。
  • 接続状態の検知・ログを充実させ、途中断や15分経過後の振る舞いに対応する設計にしてください。

詳しくは「Lifecycle of a Durable Object」を参照してください。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

Durable Objects — アウトバウンド接続が Durable Objects を存続させる

Durable Objects — アウトバウンド接続が Durable Objects を存続させる

公開日: 2026-06-19

概要

Durable Objects は、connect() またはアウトバウンドの WebSocket により作成されたアクティブなアウトバウンド接続が存在する間、オブジェクトを存続させるようになりました。これにより、アウトバウンド接続を通じて LLM からのストリーミング応答を TCP や WebSocket で受け取るといった一般的なパターンで、接続途中に Durable Object が削除される問題が解消されます。

詳細

  • 変更前: インカミングトラフィックがなくなると、Durable Object は 70–140 秒でエビクション(削除)されていました。アウトバウンド接続が開いたままでもこのエビクションが発生していました。
  • 変更後: 各アクティブなアウトバウンド接続はエビクションを防ぎます。すべてのアウトバウンド接続が閉じられると、標準の 70–140 秒の非アクティブウィンドウが適用され、以降にエビクションが発生します。

Before / After

  • Before: ストリーミング接続がエビクションで途中切断されることがあった
  • After: アクティブなアウトバウンド接続が存在する限り Durable Object は存続する

開発者への影響

Cloudflare 上で agents を構築している場合、この変更は特に重要です。例えば:

  • LLM からトークンをストリーミングしつつ models を呼び出すエージェント
  • アウトバウンド接続を介して長時間実行されるタスク

これらは接続が維持されている間、途中でエビクションされることなく実行を継続できます。

制限事項

  • 各アウトバウンド接続は最大で 15 分 の間、Durable Object のエビクションを防ぎます。
  • 15 分 を経過すると、その接続はエビクション防止の対象ではなくなります(接続自体は引き続き動作します)。
  • Durable Object の既存のアカウントごとのインスタンス上限は引き続き適用されます。

詳細は「Lifecycle of a Durable Object」を参照してください。

参考情報

この変更により、長時間のストリーミングやアウトバウンド中心のワークフローでの安定性が向上します。問題や不明点があれば Cloudflare ドキュメントおよびサポートをご利用ください。