---
title: "Uzun süren yapay zekâ ajanı: zaman aşımı, yeniden deneme"
description: "Bir LLM ajanını saatlerce ayakta tutun: çağrı başına zaman aşımı, takılmaları gösteren akış, güvenli yeniden deneme, idempotent araçlar ve adım adım kayıt."
url: https://broadrouter.com/tr/blog/long-running-agents-timeouts-retries/
lang: tr
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/blog/long-running-agents-timeouts-retries/) (güncelleme: 2026-11-16).

# Uzun süren ajanlar: zaman aşımı, yeniden deneme ve kontrol noktası

BroadNet Inference ekibi · 4 dk okuma · Yayımlandı 2026-11-14 · Güncellendi 2026-11-16

Her model çağrısını gözden çıkarılabilir, ajanın durumunu kalıcı sayın. Çağrı başına zaman aşımı koyun, takılmaları görmek için akış kullanın, 429, 5xx ve kopan akışları sınırlı geri çekilmeyle yeniden deneyin ve yan etkisi olan her araca bir idempotency anahtarı verin. Mesaj listesini her adımdan sonra kaydedin; çökme olursa ajan baştan değil, son kontrol noktasından devam eder.

## Öne çıkanlar

-   OpenAI Python SDK varsayılan olarak 10 dakikada zaman aşımına uğrar ve iki kez yeniden dener. Ajanlarda ikisini de açıkça ayarlayın.
-   data \[DONE\] satırından önce biten bir akış eksik bir yanıttır. Onu yeniden denemek yeni bir çıkarımdır ve kullandıkça öde modelinde yeniden faturalanır.
-   Model çağrılarını yeniden denemek güvenlidir. Araçların yan etkileri ise bir idempotency anahtarı taşımadıkça güvenli değildir.
-   Tamamlanan her adımdan sonra kontrol noktası alın: mesaj listesi, adım numarası ve biten yan etkilerin kimlikleri.
-   Bir plan oturumunda yeniden denemeler ek ücret getirmez, ama çalıştıkları sürece tek istek yuvasını işgal eder.

**Bu sayfada**

1.  Bir ajan saatlerce çalışınca ne bozulur?
2.  1\. Bir çağrının ne kadar sürmesine izin verilmeli?
3.  2\. Uzun süren bir ajanda neden akış kullanılır?
4.  3\. Neyi yeniden denemelisiniz?
5.  4\. Araç çağrılarını nasıl idempotent yaparsınız?
6.  5\. Bir ajan için nasıl kontrol noktası alırsınız?
7.  Gece boyu bir çalıştırmadan önce kontrol listesi
8.  BroadNet Inference’ın yeri

Beş dakika çalışan bir ajan hataları görmezden gelebilir. Beş saat çalışan bir ajan ise bir zaman aşımı, bir 429, kopan bir akış ve büyük olasılıkla bir yeniden başlatma görecektir. Uzun süren ajanlar üzerine rehberlerin çoğu bir iş akışı motoru satar. Belki buna ihtiyacınız yoktur. Bu yazı, sade bir ajan döngüsünü saatlerce ayakta tutan beş alışkanlığı OpenAI Python SDK koduyla anlatıyor.

## Bir ajan saatlerce çalışınca ne bozulur?

| Hata | Nasıl görünür | Bunu karşılayan alışkanlık |
| --- | --- | --- |
| Takılan veya yavaş çağrı | Dakikalarca yanıt yok | Çağrı başına zaman aşımı, akış |
| Hız sınırı veya aşırı yük | 429, 5xx | Geri çekilmeli, sınırlı yeniden deneme |
| Kopan akış | Bağlantı `[DONE]` gelmeden kapanır | Eksik sayın, çağrıyı yeniden deneyin |
| Yinelenen yan etki | Yeniden denemeden sonra araç iki kez çalışır | Idempotency anahtarları |
| Süreç çökmesi veya dağıtım | Ajan 1. adımdan yeniden başlar | Her adımda kontrol noktası |

## 1\. Bir çağrının ne kadar sürmesine izin verilmeli?

OpenAI Python SDK’nın README dosyası, isteklerin varsayılan olarak 10 dakika sonra zaman aşımına uğradığını ve belirli hataların iki kez yeniden denendiğini söylüyor. Bir ajanda davranışın siz farkında olmadan değişmemesi için ikisini de kendiniz ayarlayın:

```python
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"],
                timeout=300, max_retries=4)
```

Zaman aşımını veriye bakarak seçin. Bir gün boyunca her çağrının süresini günlüğe yazın; zaman aşımını en yavaş başarılı çağrının epey üstüne koyun. Büyük istemlerin başlaması daha uzun sürer, [akıl yürütme modelleri](https://broadrouter.com/tr/glossary/reasoning-tokens/) de yazmadan önce düşünür. saniyede yaklaşık 100 token hızda 8.000 çıktı token’ı tek başına bir dakikadan fazla sürer. Durmadan devam eden bir döngünün bütün gece çalışmaması için her **görev** başına ayrı bir duvar saati bütçesi ekleyin.

## 2\. Uzun süren bir ajanda neden akış kullanılır?

[Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/), model çalışırken size bir sinyal verir. Akış olmadan yavaş bir çağrıyla ölü bir bağlantı, zaman aşımı tetiklenene kadar aynı görünür. Akışla parçaların geldiğini görürsünüz ve token kullanımını da son parçada alırsınız.

BroadNet’in akış kuralları: birebir `data: [DONE]` satırına kadar okuyun. Bağlantı bundan önce kapanırsa yanıt eksiktir. `X-Request-ID` değerini kaydedin, sonra yeni bir istek yapıp yapmayacağınıza karar verin. [Akış rehberinin tamamı](https://broadrouter.com/tr/guides/streaming-chat-completions/).

```python
def call_streaming(messages, tools=None):
    parts, done = [], False
    stream = client.chat.completions.create(
        model="broadnet/glm-5.3", messages=messages, tools=tools, stream=True,
        stream_options={"include_usage": True}, max_tokens=8000)
    for chunk in stream:
        if chunk.choices and chunk.choices[0].finish_reason:
            done = True
        if chunk.choices and chunk.choices[0].delta.content:
            parts.append(chunk.choices[0].delta.content)
    if not done:
        raise IncompleteStream()   # retry the whole call
    return "".join(parts)
```

Bu taslak yalnızca metni topluyor. Araç çağrılarını da akışla alıyorsanız `delta.tool_calls` değerlerini de indekse göre biriktirin.

## 3\. Neyi yeniden denemelisiniz?

SDK bağlantı hatalarını, 408, 409, 429 ve 5xx yanıtlarını zaten yeniden dener. Kendi yeniden deneme katmanınızı yalnızca SDK’nın göremediği durumlar, örneğin eksik bir akış için ekleyin:

1.  **Yeniden deneyin:** bağlantı hataları, 429, 5xx, eksik akışlar. Rastgele sapma (jitter) ve üst sınır içeren [üstel geri çekilme](https://broadrouter.com/tr/glossary/exponential-backoff/) kullanın; örneğin 4 deneme.
2.  **Yeniden denemeyin, düzeltin:** 400, 401, 402, 403, 413, 422. Bunlar her seferinde aynı şekilde başarısız olur. Bkz. [hata kodları ve ne zaman yeniden denenir](https://broadrouter.com/tr/guides/errors-and-retries/).
3.  **Yeniden denemeler için yalnızca çağrı başına değil, görev başına bütçe koyun.** Her biri dört kez yeniden denenen on adım, kırk ek çağrı demektir.
4.  **Yeniden denemeler tükenince yedeğe geçin.** Bir çalıştırmanın sağlayıcı kesintisini atlatması gerekiyorsa bağlantı hatalarını, 5xx yanıtlarını ve hız sınırı 429’larını ikinci bir sağlayıcıya yönlendirin. [LLM API yedekleme](https://broadrouter.com/tr/blog/llm-api-failover-fallback/) yazısı istemci kodunu ve bir devre kesiciyi gösteriyor.

Kullandıkça öde modelinde her yeniden deneme yeni bir çıkarımdır ve yeniden faturalanır. Kullandıkça öde anahtarı ayrıca dakikada 30 isteğe ve aynı anda 4 uçuştaki isteğe izin verir; bu yüzden yeniden deneme fırtınaları [hız sınırına](https://broadrouter.com/tr/glossary/rate-limit/) çabuk takılır. Ajanınızın ne kadar payı olduğunu [hız sınırı hesaplayıcısı](https://broadrouter.com/tools/llm-rate-limit-calculator/) gösteriyor. Geri çekilmeyi ayrıntılı olarak [429 yönetimi yazısı](https://broadrouter.com/tr/blog/handle-llm-api-429-rate-limits/) anlatıyor. [Sınırsız bir planda](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/) yeniden denemeler ek ücret getirmez, ama çalıştıkları sürece oturumun tek istek yuvasını işgal eder.

## 4\. Araç çağrılarını nasıl idempotent yaparsınız?

Bir model çağrısının yan etkisi yoktur. Bir araç çağrısının olabilir. Ajan, `send_invoice` çalıştıktan sonra ama adım kaydedilmeden önce çökerse yeniden başlayan ajan faturayı tekrar gönderir.

Yan etkisi olan her çağrıya görevden ve adımdan türetilmiş bir [idempotency anahtarı](https://broadrouter.com/tr/glossary/idempotency-key/) verin, harekete geçmeden önce kontrol edin ve zaten kaydedilmişse çağrıyı atlayın:

```python
def run_side_effect(task_id, step, call, store):
    key = f"{task_id}:{step}:{call.id}"
    if store.done(key):
        return store.result(key)       # already ran: return the saved result
    result = execute(call)             # pass key to the API if it supports one
    store.save(key, result)
    return result
```

Birçok ödeme ve mesajlaşma API’si bir idempotency anahtarı başlığı kabul eder. Kabul ettiklerinde kendi anahtarınızı onlara iletin.

## 5\. Bir ajan için nasıl kontrol noktası alırsınız?

Tamamlanan her adımdan sonra kaydedin: mesaj listesi, adım numarası ve yan etki anahtarları. Başlangıçta varsa en son kontrol noktasını yükleyin.

```python
def save_checkpoint(path, step, messages):
    tmp = path + ".tmp"
    with open(tmp, "w") as f:
        json.dump({"step": step, "messages": messages}, f)
    os.replace(tmp, path)   # atomic on the same filesystem
```

Önce geçici bir dosyaya yazıp sonra yeniden adlandırmak, yazma ortasındaki bir çökmenin asla yarım bir kontrol noktası bırakmaması demektir. Çok uzun oturumlarda bir **özet** de kaydedin: eski turları kısa bir özetle değiştirin ki devam eden ajan devasa bir geçmişi yeniden yüklemesin. Bu, [DeepSeek V4.1 Flash](https://broadrouter.com/tr/models/deepseek-v4.1-flash/) üzerindeki 1.048.576 token’lık [bağlam penceresinde](https://broadrouter.com/tr/glossary/context-window/) bile sınır içinde kalmanızı sağlar.

## Gece boyu bir çalıştırmadan önce kontrol listesi

1.  İstemcide zaman aşımı ve `max_retries` açıkça ayarlanmış.
2.  Akış açık, `include_usage` ile birlikte; eksik akışlar yeniden deneniyor.
3.  Görev başına bir yeniden deneme bütçesi ve duvar saati limiti.
4.  Yazan, gönderen veya ödeme yapan her araçta idempotency anahtarları.
5.  Her adımdan sonra atomik olarak yazılan bir kontrol noktası.
6.  Adım numarası, süre, token’lar ve `X-Request-ID` içeren günlükler.

Birden çok ajanı yan yana çalıştırıyorsanız [sabit ücretle paralel kodlama ajanları çalıştırma](https://broadrouter.com/tr/blog/run-parallel-coding-agents-flat-rate/) ve [çoklu ajan kurulumlarının maliyeti](https://broadrouter.com/tr/blog/multi-agent-cost/) yazılarını okuyun.

## BroadNet Inference’ın yeri

BroadNet Inference standart chat completions akışını kullanır, günlüğe yazabileceğiniz bir `X-Request-ID` başlığı döndürür ve hangi hataların yeniden deneneceğini belgeler; yani yukarıdaki kalıplar yazıldığı gibi çalışır. Gün boyu çalışan ajanlar için sınırsız planlar, oturum başına aylık $60 karşılığında DeepSeek V4.1 Flash’taki token sayacını kaldırır; bu da yeniden denemeleri ücretsiz yapar. Şunu unutmayın: bir Meteor saati satın almadan bir saat sonra, bir Orbit haftası yedi gün sonra biter; dolayısıyla uzun bir iş bu süre içinde bitmeli ya da yenilenen bir Full Moon oturumuna taşınmalı. Planlar [inference.broadnet.ai/plans](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-long-running-agents-timeouts-retries&utm_content=body) adresinde.

Bu konu için ücretsiz araçlar (İngilizce)

-   [Agent run cost estimator](https://broadrouter.com/tools/agent-run-cost-estimator/) Context growth per step, total tokens and cost of one agent run, with a DeepSeek session comparison.
-   [LLM batch job planner](https://broadrouter.com/tools/llm-batch-job-planner/) Run time, binding limit, cost per model and the flat sessions needed to finish a big job by a deadline.
-   [Flat-rate vs per-token LLM cost calculator](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) Break-even between an unlimited plan and paying per token, per agent.
-   [LLM rate limit and concurrency calculator](https://broadrouter.com/tools/llm-rate-limit-calculator/) Which limit binds first: RPM, TPM or concurrency, with Little's law.

[Ücretsiz araçlar (İngilizce)](https://broadrouter.com/tools/)

## Bu yazıdaki terimler

[Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/)

Akış (streaming), bir dil modeli yanıtını sonda tek parça halinde değil, hâlâ üretilirken küçük parçalar halinde döndürme yöntemidir. OpenAI uyumlu API'ler, istekte stream değeri true olduğunda server-sent events (SSE) üzerinden akış yapar.

[Token](https://broadrouter.com/tr/glossary/token/)

Token, bir dil modelinin okuduğu ve yazdığı metin birimidir: modelin tokenizer'ının ürettiği bir kelime, kelime parçası, noktalama işareti veya bayt dizisi. LLM API'leri kullanımı token cinsinden sayar, sınırlar ve genellikle faturalandırır.

[Hız sınırı (rate limit)](https://broadrouter.com/tr/glossary/rate-limit/)

Hız sınırı (rate limit), bir API'nin bir istemcinin belirli bir zaman aralığındaki kullanımına koyduğu üst sınırdır; örneğin dakika başına istek veya dakika başına token. Sınırı aşan istekler, kullanım tekrar sınırın altına inene kadar genellikle HTTP 429 Too Many Requests ile reddedilir.

[İstek zaman aşımı (request timeout)](https://broadrouter.com/tr/glossary/request-timeout/)

İstek zaman aşımı (request timeout), bir HTTP istemcisinin isteği bırakmadan önce sunucuyu bekleyeceği en uzun süredir. İstemciler bunu genellikle bağlantıyı açmak için bir bağlantı zaman aşımına ve veri beklemek için bir okuma zaman aşımına ayırır. LLM çağrıları cömert okuma zaman aşımları gerektirir, çünkü uzun yanıtlar zaman alır.

[Kullandıkça öde (pay-as-you-go)](https://broadrouter.com/tr/glossary/pay-as-you-go/)

Kullandıkça öde, abonelik veya asgari taahhüt olmadan yalnızca kullandığınız kadar ödediğiniz, token, istek veya ses dakikası gibi birimler üzerinden ölçülen bir fiyatlandırma modelidir. LLM API'lerinin çoğu bu şekilde, ön ödemeli bir bakiyeden veya dönemsel faturayla ücretlendirir.

[Eşzamanlılık (concurrency)](https://broadrouter.com/tr/glossary/concurrency/)

Eşzamanlılık (concurrency), bir istemcinin aynı anda işlemde olan istek sayısıdır. LLM API'leri bunu genellikle dakikadaki istek sayısından ayrı olarak anahtar veya plan başına sınırlar, çünkü açık her istek yanıtı bitene kadar GPU kapasitesi tutar.

[Idempotency anahtarı (idempotency key)](https://broadrouter.com/tr/glossary/idempotency-key/)

Idempotency anahtarı, istemcinin ödeme veya satın alma gibi durum değiştiren bir isteğe eklediği, genellikle UUID gibi rastgele bir kimlik olan benzersiz bir değerdir. Aynı istek aynı anahtarla yeniden gönderilirse sunucu işlemi ikinci kez yapmak yerine ilk sonucu döndürür.

[Araç çağırma (tool calling)](https://broadrouter.com/tr/glossary/tool-calling/)

Araç çağırma (tool calling), fonksiyon çağırma (function calling) olarak da bilinir; modelin, geliştiricinin tanımladığı bir fonksiyonu çalıştırmak için JSON argümanlı yapılandırılmış bir istek döndürdüğü bir LLM API özelliğidir. Fonksiyonu uygulama çalıştırır ve sonucu geri gönderir; model hiçbir zaman kodu kendisi çalıştırmaz.

## Sık sorulan sorular

### Bir ajanda LLM API çağrıları için ne kadar zaman aşımı koymalıyım?

En yavaş meşru çağrıya yetecek kadar uzun, takılan bir çağrıyı yakalayacak kadar kısa. OpenAI Python SDK varsayılan olarak 10 dakika kullanır. Birçok ajan akışla birlikte çağrı başına 2 ila 5 dakika ve görev başına ayrı bir duvar saati limiti kullanır.

### Bir ajan hangi LLM API hatalarını yeniden denemeli?

Bağlantı hatalarını, 429 ve 5xx yanıtlarını sınırlı üstel geri çekilme ve rastgele sapmayla (jitter) yeniden deneyin. 400, 401, 402, 403, 413 ve 422 hatalarını yeniden denemek yerine düzeltin. BroadNet'te ayrıca her hata için X-Request-ID başlığını günlüğe yazın.

### Bir chat completion isteğini yeniden denemek güvenli mi?

Model çağrısının kendisinin yan etkisi yoktur, yani evet; ama bu yeni bir çıkarımdır ve kullandıkça öde modelinde yeniden faturalanır. Tehlike araçlardadır. Araç bir idempotency anahtarı kullanmıyorsa yeniden denenen bir adım aynı e-postayı iki kez gönderebilir.

### Bir çökmeden sonra ajanı nasıl kaldığı yerden devam ettiririm?

Tamamlanan her adımdan sonra mesaj listesini ve adım numarasını kaydedin, harekete geçmeden önce yan etki kimliklerini yazın ve başlangıçta bunları yeniden yükleyin. Ajan son kaydedilen adımdan devam eder.

### Uzun süren ajanlar için sınırsız plan şart mı?

Hayır, ama kullandıkça öde modelinde yeniden denemeler ve uzun bağlamlar birikir. BroadNet'in sınırsız planlarında DeepSeek V4.1 Flash için token sayacı yoktur, bu yüzden yeniden denemeler ek ücret getirmez; yine de her oturum aynı anda tek istek çalıştırır.

## Okumaya devam edin

-   [Açık modellerle araç çağırma: şema, paralel çağrı, yeniden deneme](https://broadrouter.com/tr/blog/tool-calling-open-models/)
-   [Çoklu ajan maliyeti: token başına mı, sabit oturum mu?](https://broadrouter.com/tr/blog/multi-agent-cost/)
-   [Sabit fiyatlı LLM API ile paralel kodlama ajanları nasıl çalıştırılır?](https://broadrouter.com/tr/blog/run-parallel-coding-agents-flat-rate/)
-   [Sınırsız LLM API planında "sınırsız" gerçekte ne demek?](https://broadrouter.com/tr/blog/what-unlimited-llm-api-really-means/)
-   [LLM API failover: kendi kodunuzda ikinci bir sağlayıcıya geçiş](https://broadrouter.com/tr/blog/llm-api-failover-fallback/)
-   [Bir yapay zeka kodlama ajanı çalıştırması ne kadar tutar?](https://broadrouter.com/tr/blog/ai-coding-agent-run-cost/)
-   [Claude Code ile açık modeller: proxy, yerel uç noktalar ve sınırlar](https://broadrouter.com/tr/blog/claude-code-with-openai-compatible-models/)
-   [Rehber: BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)
-   [Rehber: Chat completions akışı ve kopan bağlantıları ele alma](https://broadrouter.com/tr/guides/streaming-chat-completions/)
-   [Rehber: Ajanlar için sınırsız LLM API planları nasıl çalışır?](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/)
-   [Rehber: OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-long-running-agents-timeouts-retries&utm_content=page-cta) ·

**Kaynaklar**

-   [OpenAI Python SDK README, yeniden denemeler ve zaman aşımları (kontrol tarihi 2026-11-14)](https://github.com/openai/openai-python)
-   [BroadNet Inference API başvurusu, hatalar ve yeniden denemeler (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-long-running-agents-timeouts-retries&utm_content=sources#errors)
-   [BroadNet Inference API başvurusu, akış ve limitler (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-long-running-agents-timeouts-retries&utm_content=sources#requests)
-   [BroadNet Inference sınırsız planlar (İngilizce)](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-long-running-agents-timeouts-retries&utm_content=sources)
