Aracılığıyla paylaş

Veri özetleme API'sine genel bakış (önizleme)

  • Makale

[Bu makale, yayın öncesi belgelerine dahildir ve değiştirilebilir.]

Oluşturucular, üretken yapay zeka kullanan sayfa içeriği özetleme eklemek için özetleme API'sini Power Pages kullanabilir. Bu şekilde, site kullanıcıları tüm sayfayı gözden geçirmek zorunda kalmadan bir sayfanın içeriğine genel bir bakış elde edebilirler. API, sayfalarda kullanılan Dataverse tabloya ait veri özetlemeyi sağlayan Power Pages Web API’nin üzerine kurulmuştur.

Önemli

  • Bu, bir önizleme özelliğidir.
  • Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, ek kullanım koşullarına tabidir ve müşterilerin önceden erişmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.

Önkoşullar

  • Web API'si için site ayarlarını etkinleştirmeniz gerekir.
  • Yalnızca Web API'si Power Pages için desteklenen tablolar özetleme için kullanılabilir. Power Pages Web API hakkında daha fazla bilgi edinmek için Web API genel bakışına bakın.
  • Bu özellik, Government Community Cloud (GCC), Government Community Cloud - High (GCC High) veya Department of Defense (DoD) bölgelerinde kullanılamaz.

Site ayarları

Web API'nizde sayfaları etkinleştirin ve özetleme API'si özelliği için aşağıdaki site ayarlarını yapın.

Site ayarı adı Description
Özetleme/Veri/Etkinleştir Özetleme özelliğini etkinleştirin veya devre dışı bırakın.
Varsayılan: Yanlış
Geçerli değerler: Doğru veya Yanlış
Özetleme/istem/{any_identifier}

Özetleme talimatlarını sağlamak için bu ayarları kullanın.
Tür: dize

Örnek:
Adı: Özetleme/istem/case_summary
Değer: Önemli ayrıntıları ve kritik bilgileri özetleyin
Özetleme/Veri/ContentSizeLimit Özetleme içeriği için giriş boyutu sınırını değiştirin.
Tür: tamsayı
Varsayılan: 100.000

API şeması

Metot URI JSON Örneği
POST [Site URI]/_api/summarization/data/v1.0/tablesetname { "InstructionIdentifier":"", "RecommendationConfig":"" }
Özellik adı Description
InstructionIdentifier Bu özellik isteğe bağlıdır. Özetleme için başka yönergeler iletmek istiyorsanız, istemi eklemek için site ayarlarını kullanın. Site ayarı adını her zaman daha önce tanımlandığı şekilde sağlamanız gerekir.
RecommendationConfig Bu özellik isteğe bağlıdır. Özetleme API'sinin önerdiği istemi iletmek istiyorsanız, iletmek için bu özelliği kullanın. Değer karma hale getirilmeli ve değiştirilmemelidir.

Not

API, Web API'sinin desteklediği standart Açık Veri Protokolü (OData) belirtimlerini Power Pages izler. Özetleme API'si, Power Pages Web API'sinin desteklediği tüm okuma işlemlerini destekler.

Sample

Önemli ayrıntılara ve kritik bilgilere odaklanarak vaka türünü, konusunu, açıklamasını ve vaka geçmişini özetleyin.

İste

POST [Power Pages URL]/_api/summarization/data/v1.0/incidents(aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb)?$select=description,title&$expand=incident_adx_portalcomments($select=description)
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json
{
"InstructionIdentifier": "Summarization/prompt/case_summary"
}

Yanıtla

HTTP/1.1 200 OK
OData-Version: 4.0
{
  "Summary": "The data results provide information…",
  "Recommendations": [
    {
      "Text": "would you like to know about…?",
      "Config": "HSYmaicakjvIwTFYeCIjKOyC7nQ4RTSiDJ+/LBK56r4="
    }
  ]
}

Özetleme yanıtı, özette ince ayar yapmak için önerilen istemler sağlar. Bu önerileri kullanmak istiyorsanız, özellik olmadan InstructionIdentifier istek gövdesindeki yapılandırma değerini geçirin.

Güvenlik

Özetleme API'si, tablo ve sütun izinleri için yapılandırılan rol tabanlı güvenliğe uyar. Yalnızca kullanıcının erişimi olan kayıtlar özetleme için dikkate alınır.

Özetleme API'sinin kimliğini doğrulama

Uygulama oturumu kimlik doğrulama ve yetkilendirmeyi yönettiğinden, kimlik doğrulaması kodu eklemeniz gerekmez. Tüm Web API çağrıları, siteler arası istek sahteciliği (CSRF) belirtecini içermelidir.

Hata kodları ve iletileri

Aşağıdaki tabloda, özetleme API'sini kullanırken karşılaşabileceğiniz farklı hata kodları ve iletileri açıklanmaktadır.

Durum kodu Hata kodu Hata iletisi
400 Kategori 90041001 Üretici AI Özellikleri devre dışı
400 Kategori 90041003 Bu site için veri özetleme devre dışı bırakıldı. Site ayarını kullanarak etkinleştirin.
400 Kategori 90041004 İçerik uzunluğu sınırı aşıyor
400 Kategori 90041005 Özetlenecek kayıt bulunamadı
400 Kategori 90041006 İçerik özetlenirken hata oluştu.

Veri özetleme API'si için SSS