Jagamisviis:

Andmete kokkuvõtte API ülevaade (eelvaade)

[See artikkel kuulub väljalaske-eelsete dokumentide hulka ja seda võidakse muuta.]

Tegijad kasutavad Power Pages kokkuvõtte API-d, et lisada lehe sisu kokkuvõte generatiivse tehisintellekti abil. See funktsioon võimaldab saidi kasutajatel saada ülevaate lehe sisust ilma kogu lehte lugemata. API on üles ehitatud Power Pages veebi API-le, mis pakub lehtedel kasutatavate tabelite Dataverse andmete kokkuvõtet.

Oluline

  • See on eelvaate funktsioon.
  • Eelversioonifunktsioonid ei ole mõeldud kasutamiseks tootmises ja nende funktsioonid võivad olla piiratud. Nendele funktsioonidele kehtivad täiendavad kasutustingimused ja need on saadaval enne ametlikku väljaandmist, et kliendid saaksid varajase juurdepääsu ja tagasisidet anda.

eeltingimused

  • Lubage veebi API saidisätted .
  • Kokkuvõtteks on saadaval ainult veebi API toetatud Power Pages tabelid. Lisateavet veebi API kohta Power Pages leiate veebi API ülevaatest.
  • See funktsioon pole saadaval Government Community Cloudi (GCC), Government Community Cloud – High (GCC High) või kaitseministeeriumi (DoD) piirkondades.

Saidi sätted

Lubage oma veebi API-s lehed ja määrake kokkuvõtte API funktsiooni jaoks järgmised saidisätted.

Saidi sätte nimi Kirjeldus
Kokkuvõte / andmed / luba Lubage või keelake kokkuvõtte tegemise funktsioon.
Vaikimisi: väär
Kehtivad väärtused: tõene,väär
Kokkuvõte / viip /{any_identifier}

Kasutage neid sätteid kokkuvõtte tegemiseks juhiste andmiseks.
Tüüp: string

Näide:
Nimi: Kokkuvõte/viip/case_summary
Väärtus: Võta kokku peamised üksikasjad ja kriitiline teave
Kokkuvõte/Andmed/SisuSuuruse piirang Muutke kokkuvõtte sisu sisendmahu piirangut.
tüüp: täisarv
Vaikimisi: 100000 märki

API-skeem

Meetod URI JSON-i näidis
POSTITUS [Saidi URI]/_api/kokkuvõte/andmed/v1.0/tablesetname { "InstructionIdentifier":"", "RecommendationConfig":"" }
Atribuudi nimi Kirjeldus
InstructionIdentifier See omadus on valikuline. Kokkuvõtte tegemiseks lisajuhiste edastamiseks kasutage viiba lisamiseks saidi sätteid. Sisestage saidisätte nimi alati nii, nagu see oli varem määratletud.
Soovituse konfiguratsioon See omadus on valikuline. Kasutage seda atribuuti kokkuvõtte API soovitatud viiba edastamiseks. Väärtus peab olema räsitud ja jääma muutmata.

Märkus.

API järgib veebi API toetatud Power Pages standardseid Open Data Protocoli (OData) spetsifikatsioone. Kokkuvõtte API toetab kõiki veebi API-s saadaolevaid lugemistoiminguid Power Pages .

Sample

Tehke kokkuvõte teenindusjuhtumi tüübist, teemast, kirjeldusest ja teenindusjuhtumi ajaloost, keskendudes peamistele üksikasjadele ja olulisele teabele.

Taotle

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

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

Kokkuvõtte vastus sisaldab soovitatavaid viipasid kokkuvõtte peenhäälestamiseks. Nende soovituste kasutamiseks edastage konfiguratsiooniväärtus taotluse kehas ilma InstructionIdentifier atribuudita.

Turve

Kokkuvõtte API austab tabeli- ja veeruõiguste jaoks konfigureeritud rollipõhist turvet. See võtab arvesse ainult kirjeid, millele kasutajal on kokkuvõtete tegemiseks juurdepääs.

Kokkuvõtte API autentimine

Te ei pea autentimiskoodi lisama, kuna rakenduse seanss haldab autentimist ja autoriseerimist. Kõik veebi API kutsed peavad sisaldama saitidevahelise päringu võltsimise (CSRF) luba.

Veakoodid ja teated

Järgmises tabelis kirjeldatakse erinevaid tõrkekoode ja teateid, mis võivad kokkuvõtte tegemise API kasutamisel ilmneda.

Olekukood Tõrkekood Tõrketeade
400 90041001 Generatiivsed tehisintellekti funktsioonid on keelatud
400 90041003 Andmete kokkuvõtete tegemine on sellel saidil keelatud. Lubage saidisätte abil.
400 90041004 Sisu pikkus ületab limiidi
400 90041005 Kokkuvõtteks ei leitud kirjeid
400 90041006 Sisu kokkuvõtte tegemisel ilmnes viga.

KKK andmete kokkuvõtte API kohta

  • Last updated on