Herkese açık bir web sitesini bilgi kaynağı olarak ekleme

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Genel web sitelerini aracı düzeyinde bilgi kaynağı olarak eklediğinizde, temsilcinizin erişimini geliştirmek için genel kullanıma açık bilgileri kullanırsınız.

Genel web sitesi ekleme

Genel web sitesini bilgi kaynağı olarak eklemek için aşağıdaki adımları tamamlayın:

1. Aracıyı açın.

2. Genel Bakış veya Bilgi sayfalarından Bilgi ekle'yi ya da bir üretken yanıtlar düğümününÖzellikleri'ni seçin.

3. Ortak web sitelerini seçin.

   

4. Herkese açık web sitesinin URL adresini Herkese açık web sitesi bağlantısı alanına girin. Statik URL yerine değişken kullanmak için, URL alanının yanındaki değişken seçici simgesini (x) seçin ve Özel, Sistem veya Ortam değişkenini seçin. Listeye bağlantıyı eklemek için Ekle seçeneğini seçin.

5. İsteğe bağlı olarak Ad alanını düzenleyebilirsiniz (varsayılan olarak web sitesinin URL'si kullanılır).

6. İsteğe bağlı olarak Açıklama alanını düzenleyebilirsiniz. Bir açıklama varsayılan olarak otomatik olarak doldurulur. Özellikle üretken yapay zeka etkinleştirilmişse, ayrıntılı bir açıklama sağlamak son derece faydalıdır, çünkü açıklama üretici düzenlemeye yardımcı olur.

   

7. Bilgi kaynağını eklemeyi tamamlamak için Aracıya ekle'yi seçin.

   

8. Web sitenizdeki içerikle ilgili sorulara ne kadar iyi yanıt verdiğini görmek için aracınızı sınayın. Daha kapsayıcı olmak için denetimi azaltmanıza gerek olup olmadığını belirlemek amacıyla uç senaryo sorularını test etmek isteyebilirsiniz.

URL konusunda dikkat edilmesi gerekenler

Aracınızda kullandığınız URL, yanıt oluşturmak için içeriğin kapsamını temsil eder. Bazı URL'lerin gereksinimleri ve kısıtlamaları vardır.

Note

• Bir URL belirttiğinizde, bilgi kaynağı web'den bilgi döndürmek için Bing Arama ile Topraklama'yı kullanır.
• Oluşturucu yanıt düğümü özelliklerindeki Klasik veri seçenekleri, bir Power Fx formülü kullanarak dinamik olarak biçimlendirilmiş URL'ler belirtmenize olanak sağlar. Daha fazla bilgi için bkz. Üretken yanıt düğümleri için özel veri kaynağı kullanma.
• Ayrıca üretken yanıtlar düğümü özelliklerinin Klasik veri seçeneklerinde Bing Özel Arama belirtebilirsiniz. Genel verilerde arama veya üretken yanıtlar için Bing Özel Arama'yı kullanma konusunda daha fazla bilgi edinin.

Arama sorgusu uzunluğu

Aracı, yanıtı herkese açık bir web sitesinden verdiğinde Grounding with Bing Search kullanır ve Bing’e web isteği olarak bir arama sorgusu gönderir. Bu talebin toplam uzunluğu, arama sorgusu dahil, 2.048 karakteri geçemez. Sorgu isteği bu sınırı aşacak kadar uzun olursa, ajan bu aramayı atlar ve web sitesinden sonuç döndürmez.

Kamuya açık web siteleri için, arama sorgusu kullanıcının tam sorusuna dayanır ve konuşmadan ilgili bağlamı içerecek şekilde yeniden ifade edilir. Bu sorguyu sınıra ulaşacak kadar uzun kılabilecek birkaç faktör vardır:

• Uzun kullanıcı soruları.
• Uzun veya karmaşık konuşmalar, çünkü sorgu, önceki turlardan ilgili bağlamı içerir.
• Çok baytlı karakterler kullanan diller, örneğin Japonca, Çince ve Korece, çünkü her karakter istekte kodlandığında birkaç karaktere kadar genişler.

Tip

Bu sınıra ulaşma ihtimalini azaltmak için soruları kısa tutun ve sohbetleri odaklı tutun.

URL türü ve yapısı

• URL'de en fazla iki derinlik düzeyi olabilir ve alt yollar eğik çizgiyle /gösterilir. Ancak, sondaki öne eğik çizgiye izin verilir.

  Valid	Geçerli değil
  www.contoso.com www.fabrikam.com/engines/rotary www.fabrikam.com/engines/rotary/	www.fabrikam.com/engines/rotary/dual-shaft

• Bir URL başka bir üst düzey siteye yönlendirme yapıyorsa içerik sonuçlara dahil edilmez:

  Örneğin, www.fabrikam.com adresinden www.contoso.fabrikam.com adresine yönlendirilirse, aracınız her iki URL'deki içerikten yanıtlar oluşturmaz.

• Kimlik doğrulaması gerektiren bir web sitesine işaret eden veya Bing tarafından dizine alınmayan URL'ler desteklenmez.

  Örneğin, wiki'ler ve SharePoint siteleri kimlik doğrulaması gerektirdiği için bunları kullanamazsınız:

  • fabrikam.visualstudio.com/project/_wiki
  • fabrikam.sharepoint.com

URL etki alanı yapısı

Temsilciniz, içerik oluşturmak için üst düzey etki alanı altındaki alt etki alanları da dahil olmak üzere belirttiğiniz URL'de genel olarak görüntülenebilir tüm içeriği kullanır.

Examples:

• Eğer www.fabrikam.com/engines/rotary kullanıyorsanız, aracı yanıt oluşturmak için www.fabrikam.com/engines/rotary/dual-shaft üzerindeki içeriği de kullanır.

  Aracı, www.fabrikam.com/tools üzerinde içerik kullanmaz çünkü araçlar bir rotary alt etki alanı değildir.

• Kullanıyorsanız www.fabrikam.com (www mevcut), haber. üst düzey etki alanı fabrikam.com altında bir alt etki alanı olduğundan, aracı news.fabrikam.com (www yok) üzerindeki içeriği kullanmaz.

• fabrikam.com kullanıyorsanız, aracı üst düzey etki alanı www.fabrikam.com altında yer aldıkları için ve news.fabrikam.com üzerindeki içerikleri kullanır.

Sosyal ağlar ve forum URL'leri

URL'niz olarak bir forum veya sosyal ağ sitesi kullanıyorsanız, temsilciniz saçma, alakasız veya uygunsuz yanıtlar üretebilir. Bu nedenle, sosyal ağlardaki topluluk içeriği çoğu zaman daha fazla yanıtın reddedilme riskini artırır.

Daha fazla bilgi edinmek için Üretken yanıtlarla ilgili SSS bölümüne bakın. AI, kötü niyetli ve saldırgan yanıtlar üretmekten kaçınmak üzere eğitilmiştir.

Arama motoru URL'leri

Arama motorlarının URL'lerini (bing.com gibi) kullanmaktan kaçının çünkü bunlar yararlı yanıtlar sağlamazlar.

Değişkenleri URL olarak kullanma

Aracınızın kullandığı içeriğin kapsamını dinamik olarak denetlemek için genel web sitesinde veya SharePoint bilgi kaynağı URL'lerinde değişkenleri kullanın.

Farklı senaryolar için birden çok bilgi kaynağı oluşturmak yerine, tek bir bilgi kaynağı tanımlayın ve URL'ye bir değişken ekleyin. çalışma zamanı esnasında Copilot Studio değişkeni çözümler ve bağlama oturtma için elde edilen URL'yi kullanır.

Değişken desteği

Genel web sitesi veya SharePoint bilgi kaynağı URL'si eklediğinizde veya düzenlediğinizde, URL alanına bir değişken ekleyebilirsiniz.

Değişken kullanarak:

• Temel URL'ye yol ekleme

  https://www.contoso.com/{variable}

• URL'nin tamamını değiştirme

  {variable}

Çalışma zamanında değişken bir dize değerine çözümlenir. Bilgi kaynağının kapsamı çözümlenen URL'ye göre belirlenmiştir.

Note

Bir değişken kullanılması, hangi URL'nin topraklama için kullanıldığını değiştirir. Genel web siteleri için URL yapısı gereksinimlerini veya derinlik sınırlamalarını değiştirmez.

Değişken oluşturma ve ayarlama

Bir değişkeni genel web sitesinde veya SharePoint bilgi kaynağında kullanmak için:

1. Genel kapsamlı bir dize değişkeni oluşturun.

2. Değişken değerini aşağıdaki seçeneklerden birini kullanarak ayarlayın:

   • Konu girişleri
   • Dil gibi kullanıcı profili özellikleri
   • Ortam değişkenleri
   • Ajan akışları veya konnektörler

3. {x} (Değişken ekle) öğesini seçerek değişkeni URL alanına ekleyin.

4. Değişkenin beklenen URL'ye çözümlendiğinden emin olmak için aracıyı test edin.

Örnek: Ürüne göre kapsam

Kullanıcının sorgusuna göre bilgileri farklı ürün alanlarıyla kapsamlandırabilirsiniz.

1. Ürün adını bir Product değişkeni olarak yakalamak için konu girdisini kullanın.

2. Tetikleyici düğümünden sonra bir Set değişken değeri düğümü ekleyin ve adlı ProductTableyeni bir değişken oluşturun.

3. Ürün adlarını tanımlamak ve URL yollarına eşlemek için bir Power Fx formülü kullanın.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Başka bir Set değişken değeri düğümü ekleyin ve adlı GlobalProductURLyeni bir dize türü genel değişkeni oluşturmak için kullanın.

5. Değer ayarında Formül'e tıklayın ve aşağıdaki gibi giriş değişkeninin Productdeğerine Topic.Product göre tabloda arama yapmak için bir Power Fx işlevi kullanın:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Bilgi kaynağı URL'sindeki değişkeni kullanın:

   https://www.microsoft.com/en-us/{GlobalProductURL}

Aracı, çalışma zamanında web sitesinin yalnızca belirlenmiş bölümünü sorgular.

Yaygın senaryolar

Aşağıdakiler için genel web sitesi bilgi kaynaklarında değişkenleri kullanın:

• Ürün tabanlı yönlendirme: Belirli ürün belgelerine yönelik kapsam sorguları.

• Bölge veya dil filtreleme: User.Language değerini yerelleştirilmiş URL'lere (örneğin, en-us, it-it) eşleyin.

• Ortama özgü URL'ler: Geliştirme, test ve üretim siteleri arasında geçiş yapma.

Considerations

• Genel web sitesi bilgi kaynakları Bing aramasını kullanır ve dizine alınan içeriğe güvenir.
• Değişkenleri kullandığınızda URL derinlik sınırları uygulanmaya devam eder.
• Değişkenler yalnızca hedef URL'yi değiştirir. İçeriğin dizine eklenme veya geri getiriliş şeklini etkilemez.

Important

Değişkenin, genel web sitesi bilgi kaynaklarının gereksinimlerini karşılayan geçerli bir genel URL'ye çözümlenmesi gerekir. Geçersiz veya desteklenmeyen URL'ler sonuç döndürmeyebilir.