Eiginleikakall í OpenAI API

Eiginleikakall gerir þér kleift að tengja líkön OpenAI við ytri verkfæri og kerfi. Þetta nýtist meðal annars til að bæta nýjum möguleikum við gervigreindaraðstoð eða samþætta forritin þín og stór mállíkön með ítarlegum hætti.

Nánari upplýsingar eru í leiðbeiningum okkar fyrir forritara um eiginleikakall.

Í júní 2024 kynntum við skipulögð úttök. Í studdum líkönum og beiðnastillingum tryggir stillingin strict: true í fallsskilgreiningunni að mynduðu viðföngin fylgi uppgefnu skema þegar líkanið sendir frá sér fallskall, að því gefnu að skemað noti studda hlutmengið úr JSON Schema og uppfylli kröfur strangs hams. Beiðnum með óstuddum skemum eða skemum sem uppfylla ekki kröfur er hafnað með villu.

Í október 2024 kynntum við eiginleikann „Búðu til hvað sem er“. Með honum geta forritarar lýst falli, límt það beint inn eða límt inn kóða og búið til gilt fallsskema. Nánari upplýsingar um „Búðu til hvað sem er“ er að finna í þessari grein í hjálparmiðstöðinni.

Hvernig get ég notað eiginleikakall?

Eiginleikakall nýtist í fjölda notkunartilvika, svo sem:

• Gera aðstoðarmönnum kleift að sækja gögn:

• Gera aðstoðarmönnum kleift að framkvæma aðgerðir:

• Gera aðstoðarmönnum kleift að framkvæma útreikninga:

• Byggja ríkuleg verkflæði:

• gagnaútdráttarrás sem sækir hráan texta, breytir honum síðan í skipulögð gögn og vistar þau í gagnagrunni.

Eiginleikakall er stutt í Responses API, sem sameinar getu sem áður var skipt milli API fyrir spjalllok og Assistants API.

Hvernig get ég notað JSON-ham?

Þegar kveikt er á JSON-ham er tryggt að úttak líkansins sé gilt JSON, nema í nokkrum jaðartilvikum sem þú ættir að greina og meðhöndla á viðeigandi hátt.

Til að biðja um JSON-ham með API fyrir spjalllok skaltu stilla response_format á { "type": "json_object" } í studdum líkönum. Með Responses API skaltu stilla text.format á { "type": "json_object" }, til dæmis text: { "format": { "type": "json_object" } }, þar sem það á við. Í hvoru API sem er virkar JSON-hamur aðeins þegar forsendur líkans/skilaboða/verkfæris eru uppfylltar (til dæmis að líkanið styðji json_object, samtalið innihaldi fyrirmæli um að framleiða JSON og allar verkfæratakmarkanir séu samhæfar). Að minnsta kosti ein beiðnisskilaboð eða inntaksskilaboð í virka inntakssamhenginu verða að innihalda json á formi án tillits til há-/lágstafa, svo sem JSON, json eða Json; annars skilar API villu. Í Responses uppfyllir efsta stigs fyrirmælasvæðið eitt og sér ekki þessa sannprófun. Þegar eiginleikakall er notað með samhæfum líkönum/slóðum eru JSON-takmarkanir sjálfkrafa notaðar á frumbreytur eiginleikakalls; ósamhæfum líkönum eða samsetningum verkfæris/svarssniðs kann að vera hafnað eða þær nota mögulega ekki sýnatöku með JSON-takmörkunum.

Mikilvæg atriði:

• Þegar JSON-hamur er notaður verðurðu alltaf að gefa líkaninu fyrirmæli um að framleiða JSON í einhverjum skilaboðum í samtalinu, til dæmis í kerfisskilaboðunum þínum. Ef þú lætur ekki fylgja skýr fyrirmæli um að búa til JSON gæti líkanið búið til endalausan straum af auðum stöfum og beiðnin gæti keyrt áfram þar til hún nær tókamörkunum. Til að hjálpa til við að tryggja að þú gleymir því ekki hafnar JSON-hamur beiðnum nema viðeigandi inntaksskilaboð eða fyrirmæli innihaldi orðið json á einhverju formi, án tillits til há-/lágstafa.

• JSON-hamur tryggir ekki að úttakið passi við tiltekið skema, heldur aðeins að það sé gilt og þáttist án villna. Þú ættir að nota skipulögð úttök til að tryggja að það passi við skemað þitt, eða, ef það er ekki mögulegt, nota sannprófunarsafn og hugsanlega endurtilraunir til að tryggja að úttakið passi við æskilegt skema.

• Forritið þitt verður að greina og meðhöndla jaðartilvik sem geta valdið því að úttak líkansins sé ekki heilt JSON-hlut (sjá hér að neðan)