Deli putem

Pregled API-ja za sumiranje podataka (verzija za pregled)

  • Članak

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

Proizvođači mogu koristiti Power Pages API za sumiranje da dodaju sumiranje sadržaja stranice koja koristi generativnu AI. Na ovaj način, korisnici sajta mogu dobiti pregled sadržaja stranice bez potrebe da prolaze kroz celu stranicu. API je izgrađen na vrhu Veb API-ja Power Pages koji obezbeđuje sumiranje podataka na tabelama Dataverse koje 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

  • Morate da omogućite postavke sajta za Veb API.
  • Samo tabele koje su podržane Power Pages za Veb API su dostupne za sumiranje. Saznajte više o Veb API-ju Power Pages u pregledu Veb API-ja.
  • Ova funkcija nije dostupna u Vladinoj zajednici Cloud (GCC), Vladinoj zajednici Cloud - High (GCC High) ili Ministarstvu odbrane (DoD) regionima.

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: Lažno
Važeće 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. Ako želite da prođete bilo koja druga uputstva za sumiranje, koristite postavke sajta da biste dodali upit. Uvek treba da navedete ime podešavanja sajta kao što je prethodno definisano.
PreporukaConfig Ova osobina je opciona. Ako želite da prođete upit koji preporučuje API za sumiranje, koristite ovu osobinu da biste je preneli. Vrednost treba da bude heširana, a ne modifikovana.

Belešku

API prati standardne Open Data Protocol (OData) specifikacije koje Veb Power Pages API podržava. API za sumiranje podržava sve operacije čitanja koje Veb Power Pages API podržava.

Sample

Sumirajte tip slučaja, predmet, opis i istoriju slučaja fokusirajući se na ključne detalje i kritič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="
    }
  ]
}

Sumiranje odgovor daje preporučene upite za fino podešavanje rezimea. Ako želite da koristite ove preporuke, prosledite vrednost konfiguracije u telu zahteva, bez osobine InstructionIdentifier .

Bezbednost

API za sumiranje poštuje bezbednost zasnovanu na ulozi koja je konfigurisana za dozvole tabele i kolone. Samo zapisi kojima korisnik ima pristup se uzimaju u obzir 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