Datuen laburpenaren APIaren ikuspegi orokorra (aurrebista)

[Aurre-argitaratutako dokumentazioaren parte da artikulu hau, eta baliteke aldaketak jasatea.]

Egileek laburpen APIa erabiltzen dute orrialdeen edukiaren laburpena gehitzeko IA sortzailearekin. Power Pages Ezaugarri honek guneko erabiltzaileei orrialde baten edukiaren ikuspegi orokorra ematen die orrialde osoa irakurri gabe. APIa Web APIan oinarrituta dago, eta honek orrialdeetan erabiltzen diren taulen datuen laburpena eskaintzen du. Power Pages Dataverse

Garrantzitsua

  • Hau aurreikuspen-eginbidea da.
  • Aurreargitalpen-eginbideak ez daude ekoizpenerako diseinatuta, eta baliteke funtzionalitate murriztua izatea. Ezaugarri hauek erabilera baldintza osagarrien< / c0> mende daude eta kaleratze ofizial baten aurretik eskuragarri daude, bezeroek access goiztiarra jaso eta iritziak eman ditzaten.

Aurrebaldintzak

  • Gaitu Web APIrako gunearen ezarpenak. ...
  • *Web API*-ak onartzen dituen taulak bakarrik daude laburbiltzeko erabilgarri. Power Pages Ikasi gehiago Web APIari buruz Web APIaren ikuspegi orokorra atalean. Power Pages

Gunearen ezarpenak

Gaitu orrialdeak zure web APIan eta ezarri gunearen ezarpen hauek laburpen API funtziorako.

Web-ezarpenaren orria Deskribapenak
Laburpena/Datuak/Gaitu Gaitu edo desgaitu laburpen funtzioa.
Lehenetsia: faltsua
Balio baliodunak: egia, gezurra
Laburpena/galdera/{any_identifier}

Erabili ezarpen hauek laburpenerako argibideak emateko.
Mota: katea

Adibidea:
Izena: Laburpena/galdera/kasuaren_laburpena
Balioa: Xehetasun nagusiak eta informazio kritikoa laburbildu

Laburpena/Datuak/EdukiarenTamainaMuga Aldatu laburpen-edukiaren sarrera-tamainaren muga.
Idatzi: zenbaki osoa
Lehenetsia: 100000 karaktere

API eskema

Metodoa URI JSOn Lagina
POST [Gunearen URIa]/_api/summarization/data/v1.0/tablesetname { "InstructionIdentifier":"", "RecommendationConfig":"" }
Propietatearen izena Deskribapenak
Instrukzio-identifikatzailea Propietate hau aukerakoa da. Laburpenerako argibide gehigarriak pasatzeko, erabili gunearen ezarpenak gonbita gehitzeko. Eman beti gunearen ezarpenaren izena aurretik definitu zen bezala.
Gomendio-konfigurazioa Propietate hau aukerakoa da. Erabili propietate hau laburpen APIak gomendatutako gonbita pasatzeko. Balioa hash bidez aplikatu behar da eta aldatu gabe mantendu.

Oharra

APIak Web APIak onartzen dituen Open Data Protocol (OData) protokolo estandarraren zehaztapenak jarraitzen ditu. Power Pages Laburpen APIak Web APIan eskuragarri dauden irakurketa eragiketa guztiak onartzen ditu. Power Pages

Sample

Laburbildu kasu mota, gaia, deskribapena eta kasuaren historia, xehetasun nagusietan eta informazio garrantzitsuetan arreta jarriz.

Eskatu

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

Erantzuna

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

Laburpen-erantzunak laburpena doitzeko gomendatutako galderak ematen ditu. Gomendio hauek erabiltzeko, pasa konfigurazio-balioa eskaeraren gorputzean InstructionIdentifier propietatea gabe.

Segurtasuna

Laburpen APIak taula eta zutabe baimenetarako konfiguratutako roletan oinarritutako segurtasuna errespetatzen du. Erabiltzaileak laburpenerako atzi ditzakeen erregistroak bakarrik hartzen ditu kontuan.

Laburpen APIa autentifikatzea

Ez duzu autentifikazio-koderik sartu beharrik, aplikazio-saioak autentifikazioa eta baimena kudeatzen baititu. Web API dei guztiek gune arteko eskaera faltsutzearen (CSRF) token bat izan behar dute.

Errore kodeak eta mezuak

Hurrengo taulan laburpen APIa erabiltzean aurki ditzakezun errore kode eta mezu desberdinak deskribatzen dira.

Egoera-kodea Errore-kodea Errore-mezua
400 90041001 IA sortzailearen funtzioak desgaituta daude
400 90041003 Datuen laburpena desgaituta dago gune honetarako. Gaitu gunearen ezarpena erabiliz.
400 90041004 Edukiaren luzerak muga gainditzen du
400 90041005 Ez da erregistrorik aurkitu laburbiltzeko
400 90041006 Errorea gertatu da edukia laburbiltzean.

Datuen laburpen APIari buruzko maiz egiten diren galderak