Ajanınızı hata ayıklamak için etkinlik izini kullanın

Microsoft Copilot Studio'daki GitHub Copilot demetiyle desteklenen ajanlarda faaliyet izi, ajanınızın her mesajı tam olarak nasıl işlediğini gösterir. Bunu; aracınızın düşünce zinciri mantığını anlamak, bilgi kaynağı atıflarını doğrulamak, araç yürütme işlemlerini onaylamak ve hataları gidermek için kullanın.

Note

Bu makaledeki özellikler, Copilot kredileri kullanarak kullanıma dayalı faturalandırma kullanan GitHub Copilot demetiyle desteklenmektedir. GitHub Copilot demetiyle çalışan ajanlar için faturalandırma genel bakalımında Copilot Kredileri hakkında daha fazla bilgi edinin.

Kullanıma dayalı faturalandırma, ajanların kullanımı, oluşturulması, test edilmesi ve değerlendirilmesi için geçerlidir. Bu işlemler Copilot Kredileri tüketebilir.

Prerequisites

  • GitHub Copilot kostum ile oluşturulan bir ajan
  • Önizleme sekmesinde en az bir test konuşması

Etkinlik izini açma

  1. Aracınızı Copilot Studio'da açın ve Önizleme sekmesini seçin.

  2. Son kullanıcı önizlemesi geçişinin kapalı olduğundan (varsayılan oluşturucu görünümü) emin olun. Etkinlik izi, her ileti için işlem ayrıntılarını göstererek sohbet bölmesinin yanında görünür.

  3. Aracınıza bir ileti gönderin. Aracı iletiyi işlerken izleme gerçek zamanlı olarak güncelleştirilir.

İzleri Anlamak

Etkinlik izleme, aracınızın işlem sürecine dair bir düşünce zinciri (CoT) görünümü sunar. İzleme içindeki her adım, aracının ne yaptığını ve neden yaptığını gösteren bir düğüm olarak görünür.

Düğüm türleri

İzleme, aşağıdaki düğüm türlerini içerebilir:

Düğüm türü Ne gösterir
Kullanıcı iletisi Aracıya gönderdiğiniz ileti
Aracı yanıtı Aracının oluşturduğu yanıt
Bilgi Aracının temellendirme için başvurduğu bir bilgi kaynağı. Erişilen her bilgi kaynağı için kaynakları ve mevcut olduğunda alıntı bağlantılarını gösteren, "Aranan bilgi" şeklinde genişletilebilir bir kart olarak oluşturulur.
Eylem çalıştırıldı Bağlayıcıyı, doldurulmuş giriş parametrelerini ve teslimat süresini gösteren, daraltılabilir bir kart olarak oluşturulan bağlayıcı veya araç çağrısı
Araç Aracının bir eylem gerçekleştirmek veya veri almak için kullandığı bir araç
Bağlayıcı Aracının dış verilere erişmek için kullandığı bir bağlayıcı
Akış Tetiklenen bir aracı akışı
Beceri Yürütülen bir beceri
Error İşleme sırasında bir hata oluştu
Tamamla Tüm araç çağrıları tamamlandığında izlemenin altında gösterilen yeşil onay işareti göstergesi

Düğüm ayrıntılarını görüntüleyin

  1. Ayrıntılarını genişletmek için izleme içindeki herhangi bir düğümü seçin.

  2. Aşağıda gösterilen ve şunları içerebilen bilgileri gözden geçirin:

    • Aracının adıma gönderdiği giriş
    • Döndürülen çıktı veya sonuç
    • İşlem süresi ve ölçümler
    • Adım başarısız olursa hata ayrıntıları

Bilgi kaynağı sorunlarında hata ayıklama

Aracınız bir soruyu yanıtlamak için bilgileri kullandığında, izleme kaydı hangi kaynaklara başvurulduğunu gösterir:

  1. İzleme içindeki Bilgi düğümünü bulun.

  2. Hangi bilgi kaynaklarına erişildiğini görmek için kaynağı gözden geçirin.

  3. Alınan belirli içeriği görmek için bir kaynak seçin.

  4. Aracının doğru kaynağı kullanıp kullanmadığını ve alınan içeriğin ilgili olup olmadığını doğrulayın.

Aracı yanlış kaynağı kullandıysa veya hatalı bilgi verdiyse Oluştur sekmesindeki bilgi yapılandırmanızı kontrol edin.

Hata ayıklama aracı yürütme

Aracınız bir aracı çağırdığında, izleme kaydı yürütme ayrıntılarını gösterir:

  1. İzleme bölümünde Araç, Bağlayıcı, Akış veya Beceri düğümünü bulun.

  2. Giriş parametreleri ve çıktı sonuçları da dahil olmak üzere yürütme ayrıntılarını gözden geçirin.

  3. Doğru aracın çağrıldığını ve sonuçların beklendiği gibi olduğunu doğrulayın.

  4. Bir araç yürütme işlemi başarısız olursa düğümdeki hata ayrıntılarını gözden geçirin.

Bir aracı yeniden yapılandırmak için Oluştur sekmesini açın ve aracı, aracınızın yapılandırmasında bulun.

Hataları giderme

İşleme sırasında hatalar oluştuğunda, izleme bunları vurgular:

  1. İzleme içinde hata göstergesiyle işaretlenmiş düğümleri arayın.

  2. Hata iletisini ve bağlamı içeren hata ayrıntılarını görüntülemek için hata düğümünü seçin.

  3. Sık karşılaşılan sorunlar şunlardır:

    • Araçlar veya bağlayıcılar için kimlik doğrulama hataları
    • Bilgi kaynağı erişim hataları
    • Uzun süren aracı çağrıları için zaman aşımı hataları
    • İçerik denetleme işaretleri

  4. Temel nedeni Oluştur sekmesinde veya Ayarlar bölümünde giderin ve ardından yeniden test edin.

Etkinlik izlemesi, hızlı düzenleme için Oluştur sekmesiyle tümleşir.

  1. İz içindeki herhangi bir kaynağı, aracı veya bileşeni seçin.

  2. Copilot Studio, Oluştur sekmesindeki ilgili bileşene gider.

  3. Değişikliklerinizi yapın ve yeniden test etmek için Önizleme sekmesine dönün.

  • Last updated on