İptal İsteklerini Ele Alma

Uzun süren bir araç çalışırken kullanıcı sohbeti kapatabilir veya fikrini değiştirebilir. MCP, boşa giden işin durması için istemcinin bir iptal göndermesine olanak tanır.

İstemci bunu, durdurmak istediği requestId'yi belirten bir notifications/cancelled iletisiyle bildirir. Bu, yanıt gerektirmeyen, gönderilip unutulan bir iletidir.

Yalnızca hâlihazırda devam eden bir istek, kendi requestId değeriyle eşleştirilerek iptal edilebilir. Kimliği olmayan bildirimler hiçbir zaman iptal edilemez.

İptal, zorla sonlandırma değil, nazik bir istektir. İşiniz zaten tamamlanıyor olabilir; bu nedenle iptali durma yönünde bir en iyi çaba ipucu olarak değerlendirin.

Python SDK'sında iptal, bekleyen aracınızın içinde oluşturulan bir asyncio.CancelledError olarak gelir. Genellikle bir bayrağı kendiniz yoklamanız gerekmez.

En basit doğru davranış, CancelledError hatasının yukarı doğru iletilmesine izin vermektir. Çerçeve daha sonra görevi durdurur ve normal bir sonuç göndermeyi atlar.

Aracınız bir dosya veya kilit tutuyorsa iptal durumunda kaynakları yine serbest bırakacak şekilde sarmalayın. Bir try/finally yapısı, çıkış sırasında temizliğin çalışmasını garanti eder.

CancelledError hatasını asla yakalayıp sessizce çalışmaya devam etmeyin. Bu, iptalin amacını ortadan kaldırır ve istemcinin işin durdurulduğunu sanmasına neden olur.

Bir istek iptal edildiğinde onun için sonuç veya hata göndermeyin. İstemci yoluna devam etmiştir ve geç gelen herhangi bir yanıt basitçe yok sayılır.

İptale hızlıca uymak CPU'yu, ağı ve model belirteçlerini serbest bırakır. Hızla duran bir sunucu, yoğun çalışan bir aracı ortamında iyi bir yurttaştır.

Bekleme noktası olmayan sıkı CPU döngülerinde, iptalin yinelemeler arasında gerçekleşebilmesi için kısa bir await asyncio.sleep(0) ekleyin.

cancelled bildirimini, iptallerin neden en iyi çabayla gerçekleştiğini ve temizleme işlemini yaparken CancelledError hatasının nasıl yukarı iletileceğini gördünüz. Aferin!