Aracılığıyla paylaş

Hata kodlarını anlama

  • Makale

Bir aracı konuşma sırasında bir sorunla karşılaştığında, karşılaşılan belirli sorun için bir hata kodu içeren bir mesajla yanıt verir. Aracının kullanıcıları bu hata kodunu yöneticilerine vermelidir.

Bir aracı oluşturucusu olarak, aracı test etmek için test bölmesini kullanırken bir sorun oluşursa, hata koduna ek olarak sorun hakkında daha fazla bağlam içeren bir mesaj görebilirsiniz. Alternatif olarak, Konu denetleyicisi panelini, aracınızı doğrulamak için kullanabilirsiniz.

Hata listesi

Not

Bazı hata iletilerinde kullanılan diyalog terimi, bir konu'ya işaret eder.

Hata kodu Description
ContentError Konu içeriğinde bir hata oluştu.
DataLossPreventionViolation Veri kaybı önleme ihlali vardır.
FlowActionException Bulut Akışı yürütülürken hata oluştu.
FlowActionBadRequest Bulut akışına yapılan istek yanlış biçimlendirildi.
FlowActionTimedOut Bir bulut akışının çalıştırılması 100 saniyeden uzun sürdü ve zaman aşımına uğrandı.
InvalidContent Kod düzenleyicisine geçersiz içerik eklendi.
InfiniteLoopInBotContent Düğüm birçok kez yürütüldü.
LatestPublishedVersionNotFound Aracının yayımlanmış sürümü alınamıyor.
OutgoingMessageSizeTooBig Aracı tarafından gönerilen bir ileti işlenemeyecek kadar büyük.
OpenAIRateLimitReached Aracının kapasite sınırına ulaşıldı.
RedirectToDisabledDialog Konu, devre dışı bırakılmış bir konuya yeniden yönlendiriyor.
RedirectToNonExistentDialog Konu, artık bulunmayan bir konuya yeniden yönlendiriyor.
SystemError Copilot Studio'ta bir sistem hatası oluştu.

ContentError

Hata iletisi: Bu hata, hatanın bağlamına göre dinamik iletiler üretir.

Çözüm: Bu ileti, aracınızın içeriğiyle ilgili sorunlara yönelik genel bir hatadır. Hata mesajı daha fazla ayrıntı sağlıyor.

Bazı yaygın sorunlar aşağıdakileri içermektedir:

DataLossPreventionViolation

Hata iletisi: "Bu ortam, kullanıcıların aracıyı kullanabilmeleri için oturum açmalarını gerektirir. Yönet > Güvenlik > Kimlik Doğrulaması'na gidin ve kullanıcıların oturum açmasını gerektiren seçeneği belirleyin."

Çözüm:

FlowActionException

Hata iletileri:

  • "Aracı tanımına göre çıkış beklenmesine rağmen, akış {FlowName} ({FlowId}) içinden herhangi bir çıkış alınamadı."
  • "{FlowName} ({FlowId}) akışında {ItemKey} adlı çıkış parametresi, yanıt verilerinde eksik. Akışı yenileyin veya akışın bu değeri döndürdüğünden emin olun."
  • "{FlowName} ({FlowId}) akışında {ItemKey} adlı çıkış parametresi, çıkış şemasında eksik. Lütfen akışı yenileyin."

Çözüm:Akışı hatalara karşı denetleyin.

FlowActionBadRequest

Hata iletileri:

  • "{FlowName} ({FlowId}) akışında {KeyName} adlı parametrenin, {ItemTypeKind} türünde olduğu bildirildi. Bu tür Power Automate çağrılırken desteklenmez. Şu anda yalnızca Metin, Boole ve Rakamlar desteklenmektedir."
  • "{FlowName} ({FlowId}) akışında {ItemKey} adlı parametre, 'Çağrı Akışı' eyleminde eksik."
  • "{FlowName} ({FlowId}) akışında {KeyName} adlı parametre, {ResolveType} türünde değerlendirildi. Beklenen tür {ExpectedType}."
  • "{FlowName} ({FlowId}) akışı, {ResponseCode} yanıt koduyla çalıştırılamadı. Hata kodu: {FlowErrorCode}."

Çözüm: Akışa geçirdiğiniz değişkenlerin temel türünün parametrenin türüyle eşleşip eşleşmediğini denetleyin.

FlowActionTimedOut

Hata iletisi: "{FlowId} kimliğiyle akış, zaman aşımına uğradı. Hata Kodu: {FlowErrorCode}"

Çözüm:Akışta hatalar olup olmadığını kontrol edin ve bulut akışının aracınıza geri dönmesinin 100 saniyeden uzun sürmesinin nedenini anlayın. Sorguyu ve arka uç sisteminden dönen verileri iyileştirmeye çalışın. Sonuç aracıya gönderildikten sonra bulut akış mantığının bir kısmı çalışmaya devam edebiliyorsa, bu eylemleri bulut akışınızdaki 'Değeri Copilot Studio'e döndür' adımının sonrasına yerleştirin.

InvalidContent

Hata mesajı: "Aracıda toplam {TotalComponents} bileşen mevcut, ancak hiçbiri geçerli değil."

Çözüm:Kod düzenleyicisini açarak içerikle ilgili sorunları gözden geçirin.

InfiniteLoopInBotContent

Hata iletisi: "{DialogId}.{TriggerId}.{ActionId} eylemi bir satırda {MaxTurnCount} defadan fazla yürütüldü. Bu, diyaloğun yürütülmesinde bir döngü olduğunu belirtir ve bu nedenle diyalog yürütme sonlandırılır."

Çözüm: Konunun düzgün şekilde sonlandırıldığından ve düzgün şekilde sonlandırılan Aktar sistem konusu gibi diğer konulara bağlandığından emin olun.

LatestPublishedVersionNotFound

Hata iletisi: "Aracının en son yayımlanan sürümü alınamıyor."

Çözüm:Aracı yayınlayın.

OutgoingMessageSizeTooBig

Hata iletisi: "Giden iletinin boyutu çok büyük."

Çözüm: Hiçbirinin JSON.stringify() statik yöntemi gibi büyük miktarda metin içeren bir değişken kullanmadığından emin olmak için düğümlerinizi gözden geçirin. Bu yöntemi veya büyük miktarda metin içeren bir değişkeni kullanırsanız, düğümü metnin yalnızca gerekli olan bölümünü geçirecek şekilde değiştirin. Örneğin, başka bir konuya veri geçirmek için Uyarlamalı Kart kullanıyorsanız değişkeni yalnızca gerekli özelliği iletecek şekilde güncelleştirin.

Daha fazla bilgi için bkz. Çok Yönlü Kanalda Copilot Studio kullanırken maksimum kanal veri iletisi boyutu sınırları.

OpenAIRateLimitReached

Hata iletisi Bir hata oluştu.

Çözüm: Aracınız üretken yanıtların maksimum sayısına ulaştı. İleti kapasitenizi gözden geçirin ve üretici yanıtlar oranı sınırınızı artırmak için bir destek isteği açın.

RedirectToDisabledDialog

Hata iletisi: "{DialogId} kimlikli Diyalog, tanımda devre dışı bırakıldı. Kullanmadan önce lütfen Diyaloğu etkinleştirin."

Çözüm:Konuyu yeniden etkinleştirin veya yeniden yönlendirme düğümünü kaldırın.

RedirectToNonExistentDialog

Hata iletisi: "{DialogId} kimlikli Diyalog, tanımda bulunamadı. Lütfen Diyaloğun bulunup bulunmadığını ve Kimliğin doğru olup olmadığını denetleyin."

Çözüm:Yeni bir konu oluşturarak yeniden yönlendirin veya yeniden yönlendirme düğümünü kaldırın.

SystemError

Hata iletisi: Bu hata, hata iletisi üretmez.

Çözüm:Müşteri desteğine başvurun.