Deli putem

Pregled API-ja za sumiranje podataka (pregled)

[Ovaj članak predstavlja preliminarnu dokumentaciju i može se promeniti.]

Proizvođači koriste Power Pages API za sumiranje da bi dodali sumiranje sadržaja stranice pomoću generativne AI. Ova funkcija omogućava korisnicima sajta da dobiju pregled sadržaja stranice bez čitanja cele stranice. API je izgrađen na Veb API-ju Power Pages , koji obezbeđuje sumiranje podataka za tabele koje Dataverse se koriste na stranicama.

Važno

  • Ovo je preliminarna funkcija.
  • Funkcije verzije za pregled nisu namenjene za korišćenje u proizvodnji i možda imaju ograničene funkcionalnosti. Ove funkcije podležu dodatnim uslovima korišćenja i dostupne su pre zvaničnog izdanja, tako da korisnici mogu dobiti rani pristup i pružiti povratne informacije.

Preduslovi

  • Omogućite postavke sajta za Veb API.
  • Samo tabele podržane od strane Power Pages Veb API-ja su dostupne za sumiranje. Saznajte više o Veb API-ju Power Pages u pregledu Veb API-ja.
  • Ova funkcija nije dostupna u regionima Government Community Cloud (GCC), Government Community Cloud - High (GCC High) ili Department of Defense (DoD).

Postavke lokacije

Omogućite stranice u vašem veb API-ju i podesite sledeća podešavanja sajta za funkciju API-ja za sumiranje.

Naziv podešavanja lokacije Opis
Sumizacija/Podaci/Omogući Omogućite ili onemogućite funkciju sumiranja.
Podrazumevano: false
Validne vrednosti: istina, laž
Sumiranje/upit/{any_identifier}

Koristite ova podešavanja da biste pružili uputstva za sumiranje.
Tip: string

Primer:
Ime: Sumiranje / prompt / case_summary
Vrednost: Sumirajte ključne detalje i kritične informacije
Summarization/Data/ContentSizeLimit Izmenite ograničenje veličine ulaza za sadržaj sumiranja.
Tip: ceo broj
Podrazumevano: 100,000

API šema

Način URI JSON uzorak
POST [URI sajta] / _api / summarization / data / vKSNUMKS / tablesetname { "InstructionIdentifier":"", "RecommendationConfig":"" }
Naziv svojstva Opis
InstrukcijaIdentifikator Ova osobina je opciona. Da biste preneli dodatna uputstva za sumiranje, koristite postavke sajta da biste dodali upit. Uvek navedite ime podešavanja sajta kao što je prethodno definisano.
PreporukaConfig Ova osobina je opciona. Koristite ovu osobinu da biste preneli upit koji preporučuje API za sumiranje. Vrednost mora biti heširana i ostati nemodifikovana.

Belešku

API prati standardne Open Data Protocol (OData) specifikacije podržane od strane Power Pages Veb API-ja. API za sumiranje podržava sve operacije čitanja dostupne u Veb API-ju Power Pages .

Sample

Sumirajte tip slučaja, predmet, opis i istoriju slučaja fokusirajući se na ključne detalje i važne informacije.

Request

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"
}

Response

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="
    }
  ]
}

Odgovor na sumiranje pruža preporučene upute za fino podešavanje sažetka. Da biste koristili ove preporuke, prosledite vrednost konfiguracije u telu zahteva bez osobine InstructionIdentifier .

Bezbednost

API za sumiranje poštuje bezbednost zasnovanu na ulozi konfigurisanu za dozvole tabele i kolone. On uzima u obzir samo zapise kojima korisnik može pristupiti za sumiranje.

Autentifikacija API-ja za sumiranje

Ne morate da uključite kod za autentifikaciju jer sesija aplikacije upravlja autentifikacijom i autorizacijom. Svi pozivi Veb API-ja moraju sadržavati token falsifikovanja zahteva za unakrsnelokacije (CSRF).

Kodovi grešaka i poruke

Sledeća tabela opisuje različite kodove grešaka i poruke na koje možete naići kada koristite API za sumiranje.

Šifra statusa Kôd greške Poruka o grešci
400 90041001 Generativne AI funkcije su onemogućene
400 90041003 Sumiranje podataka onemogućeno za ovaj sajt. Omogućite korišćenje podešavanja sajta.
400 90041004 Dužina sadržaja prelazi granicu
400 90041005 Nema zapisa koji bi rezimirali
400 90041006 Došlo je do greške prilikom sumiranja sadržaja.

Često postavljana pitanja za API za sumiranje podataka