Eiginleikakall í OpenAI API

Eiginleikakall gerir þér kleift að tengja OpenAI-líkön við ytri verkfæri og kerfi. Þetta er gagnlegt fyrir margt, svo sem að efla AI-aðstoðarmenn með getu eða byggja djúpar samþættingar milli forrita þinna og LLM.

Frekari upplýsingar eru í þróunarleiðarvísi okkar um eiginleikakall.

Í júní 2024 settum við skipulögð úttök á markað. Þegar þú kveikir á því með því að stilla strict: true í eiginleikaskilgreiningunni þinni tryggja skipulögð úttök að frumsemdirnar sem líkanið býr til fyrir eiginleikakall passi nákvæmlega við JSON-skemað sem þú gafst upp í eiginleikaskilgreiningunni.

Í október 2024 settum við á markað eiginleikann „Búa til hvað sem er“, sem gerir þróunaraðilum kleift að lýsa eiginleika, líma hann beint inn eða líma inn kóðann þinn og búa til gilt eiginleikaskema. Frekari upplýsingar um „Búa til hvað sem er“ eru í þessari hjálparmiðstöðvargrein

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)