# Bir Kodlama Ajanı Başka Bir Modele Geçince Araç Çağrıları Neden Başarısız Olur? > Araç çağrıları model değişiminden sonra genellikle yeni model protokolü, şema beklentilerini, argüman serileştirmesini, akış olaylarını veya konuşma durumu davranışını değiştirdiği için bozulur. Geçişi model adı değişimi değil, sözleşme değişimi olarak ele alın. İlk yararlı test bir kodlama kıyaslamasından küçüktür: yeni modelden iki zorunlu argümana sahip salt okunur bir işlevi çağırmasını isteyin. Başarısız olursa sorun planlama katmanının altındadır. Başarılı olursa ilk sözleşme kırılması görünene kadar akış, birden fazla araç, durum ve yazma işlemlerini tek tek ekleyin. Model değişimi eski entegrasyonun gizlediği varsayımları açığa çıkarır. Kodlama ajanı yalnızca bir prompt ve model değildir; model çıktısını, akış ayrıştırıcısını, araç kaydını, yürütücüyü ve araç sonuçlarını geri veren döngüyü bağlayan bir durum makinesidir. ## Yeteneği protokolden ayırın Bir model kodlamada güçlü olabilir ancak istemcinin gönderdiği protokol üzerinden kullanılamayabilir. Başka bir model isteği kabul edip bu rotada araç yeteneği sunmayabilir. Model adını değiştirmeden önce yetenek metadatasını kontrol edin. [Atlas Cloud LLM protokol rehberi](https://www.atlascloud.ai/docs/llm-protocols?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=why-tool-calls-fail-after-switching-coding-agent-models), tek base URL üzerinde OpenAI Chat Completions, Responses, Anthropic Messages, Google Gemini ve diğer biçimleri listeler. Her model her protokolü konuşmaz. Modelin `supported_apis` alanını ve araç yeteneğini doğruluk kaynağı olarak kullanın. | Katman | Geçiş sorusu | Hata işareti | |---|---|---| | Endpoint | Model bu protokolü kabul ediyor mu? | 400 yanıtı veya yok sayılan alanlar | | Yetenek | Bu rota araçları destekliyor mu? | Çağrı yerine metin yanıtı | | Şema | Adlar ve JSON Schema geçerli mi? | Eksik ya da hatalı argümanlar | | Akış | Argüman deltaları doğru birleşiyor mu? | Kesilmiş JSON | | Döngü | Araç sonuçları doğru rolle dönüyor mu? | Tekrarlanan çağrı veya takılan tur | ## Araç şemasını tek bir sözleşmeye indirin Kısa adlı, iki zorunlu string alanlı, union içermeyen ve isteğe bağlı iç içe alanı olmayan bir işlevle başlayın. Karmaşık şemalar model ile doğrulayıcı davranışını birbirine karıştırır. ```json { "type": "function", "function": { "name": "read_file", "description": "Read a UTF-8 text file from the workspace.", "parameters": { "type": "object", "properties": { "path": {"type": "string"}, "max_chars": {"type": "integer", "minimum": 1} }, "required": ["path", "max_chars"], "additionalProperties": false } } } ``` Protokol destekliyorsa bu işlevi zorunlu kılın. Zorunlu çağrı, çağrı yapamama ile planlama kararını birbirinden ayırır. ## Önce akışsız test edin Akışsız yanıt son araç nesnesini tek payload içinde gösterir. Akışta ad, çağrı kimliği ve JSON argümanları farklı olaylarda gelebilir. Argümanları yalnızca protokolün final veya done olayından sonra ayrıştırın. Kısmi bir buffer o anda geçerli JSON olduğu için aracı çalıştırmayın; sonraki delta onu uzatabilir. Bufferları çağrı kimliğine göre tutun, çift finali reddedin ve ham olay sırasını kaydedin. | Akış değişmezi | Gerekli davranış | |---|---| | Sabit çağrı kimliği | Tüm deltalar aynı buffera gider | | Sıralı birleştirme | Parçalar olay sırasıyla eklenir | | Açık tamamlanma | Yürütme final olayı bekler | | Tek yürütme | Tamamlanan çağrı en fazla bir kez çalışır | ## Ajan döngüsünü açıkça normalize edin Sağlayıcıya özgü alanları yürütücüye yaymayın. Her yanıtı `assistant_text`, `tool_calls`, `usage` ve `stop_reason` gibi iç biçime dönüştürün; sonuçları bir protokol adaptörüyle geri çevirin. Çağrı kimliklerini opaque değerler olarak koruyun. Argümanları çalıştırmadan önce doğrulayın ve hatalı JSON’u sessizce düzeltmek yerine yapılandırılmış hata döndürün. ## İlk karşılaştırmada durumu sıfırlayın Eski geçmiş öğeleri yeni rotanın kabul etmediği reasoning blokları, araç sonucu rolleri, durum handle’ları veya assistant mesajları içerebilir. Aynı sistem talimatlarıyla yeni konuşma başlatın, sonra kısa ve normalize edilmiş geçmişi oynatın. Durum kısayolları protokole özgüdür. Talimatların taşınıp taşınmadığını varsaymak yerine test edin. ## Bir geçiş merdiveni kurun Aynı fixture’ları şu sırada çalıştırın: * Düz metin yanıtı. * Akışsız, zorunlu bir salt okunur araç. * Akışsız otomatik araç seçimi. * Akışlı zorunlu bir araç. * İki bağımsız araç. * Bir araç hatası ve kurtarma. * Kısa, çok turlu kodlama görevi. İlk hatada durup wire verisini inceleyin. Sağlık kontrolünden otonom repository düzenlemesine atlamayın. ## Tek adaptörün yeterli olup olmadığına karar verin Farklılık yalnızca alan veya olay adlarındaysa ortak adaptör yararlıdır. Modeller farklı protokol, geçmiş gösterimi veya araç sonucu semantiği gerektiriyorsa ayrı adaptör daha güvenlidir. Atlas Cloud tek anahtar ve base URL ile birden fazla biçim ve değişen bir [LLM model kataloğu](https://www.atlascloud.ai/llm-models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=why-tool-calls-fail-after-switching-coding-agent-models) sunduğundan denemeleri kolaylaştırır. Bu kolaylık yetenek kontrolünün yerini tutmaz. Modeli, protokolü, şema sürümünü, akış modunu ve test sonucunu birlikte kaydedin. ## Sonuç Araç çağrıları model değişiminden sonra entegrasyon davranış ve protokol geçişini bir string değişimi gibi gördüğünde bozulur. Rotayı doğrulayın, şemayı küçültün, akışsız zorunlu çağrı testini geçin, akış birleştirmesini doğrulayın ve konuşma durumunu en son ekleyin. Mesaj veya olay semantiği gerçekten farklıysa ayrı adaptör kullanın. ## FAQ ### Yeni model neden araç çağırmak yerine metinle yanıt veriyor? Model seçilen protokolde araçları desteklemiyor, farklı bir tool choice ayarı gerektiriyor veya araç açıklamasını farklı yorumluyor olabilir. Yetenek metadatasını doğrulayın ve tek bir zorunlu çağrıyı test edin. ### OpenAI uyumlu iki model yine de farklı araç çağrısı biçimleri döndürebilir mi? Evet. Dış istek biçimi uyumlu olsa bile akış deltaları, çağrı kimlikleri, argüman tamamlanması ve bitiş nedenleri farklı olabilir. ### Model değişiminden sonra eski konuşmayı yeniden kullanmalı mıyım? Yalnızca yeni model ve protokolün aynı geçmiş öğelerini kabul ettiğini doğruladıktan sonra. Daha güvenli test yeni bir konuşmayla başlar ve durumu kontrollü biçimde geri ekler. ### En hızlı tanılama testi nedir? Küçük bir JSON şemasına sahip deterministik, salt okunur bir aracı zorlayın; akışsız çalıştırın ve tam ajan döngüsünden önce ham istek ile yanıtı kaydedin. ### Atlas Cloud bütün modelleri tek ve özdeş bir araç arayüzüne dönüştürür mü? Hayır. Atlas Cloud birden fazla protokolü destekler ve her model desteklediği API ve yetenekleri yayımlar. İstemci modelin gerçekten desteklediği protokolü seçmelidir. ### İki model için ne zaman ayrı adaptör tutulmalı? Durum nesneleri, akış olayları, araç sonucu mesajları veya hata semantiği tek bir sözleşmeyle güvenle temsil edilemiyorsa ayrı adaptörler kullanın.