Mgao wa kiutendaji katika API ya OpenAI

Mgao wa kiutendaji hukuwezesha kuunganisha miundo ya OpenAI na zana na mifumo ya nje. Hii ni muhimu kwa mambo mengi, kama vile kuwawezesha wasaidizi wa AI kutekeleza majukumu mbalimbali au kujenga miunganisho ya kina kati ya programu zako na LLM.

Pata maelezo zaidi katika mwongozo wetu wa wasanidi kuhusu mgao wa kiutendaji.

Mnamo Juni 2024, tulizindua matokeo yaliyopangwa. Kwa miundo na usanidi wa maombi unaotumika, muundo unapotoa wito wa kitendaji, kuweka strict: true katika ufafanuzi wa utendaji wako huhakikisha kuwa hoja zinazozalishwa zinafuata kielezo kilichotolewa, mradi kielezo hicho kitumie sehemu ndogo inayotumika ya Kielezo cha JSON na kikidhi masharti ya hali madhubuti. Maombi yenye vielezo visivyotumika au visivyokidhi masharti hukataliwa na kurudisha hitilafu.

Mnamo Oktoba 2024, tulizindua kipengele cha 'Zalisha Chochote', kinachowaruhusu wasanidi kueleza utendaji, kuubandika moja kwa moja au kubandika msimbo wao na kuzalisha kielezo halali cha utendaji. Pata maelezo zaidi kuhusu 'Zalisha Chochote' katika makala haya ya kituo cha usaidizi.

Ninawezaje kutumia mgao wa kiutendaji?

Mgao wa kiutendaji ni muhimu kwa matumizi mengi, kama vile:

• Kuwezesha wasaidizi kuchota data:

• Kuwezesha wasaidizi kuchukua hatua:

• Kuwezesha wasaidizi kufanya ukokotoaji:

• Kujenga mitiririko kazi tajiri:

• mfereji wa uchimbaji data unaochota maandishi ghafi, kisha kuyabadilisha kuwa data iliyopangwa na kuyahifadhi katika hifadhidata.

Mgao wa kiutendaji unaauniwa katika Responses API, ambayo huunganisha uwezo uliokuwa umegawanywa awali kati ya API ya Majibu ya Mazungumzo na Assistants API.

Ninawezaje kutumia hali ya JSON?

Hali ya JSON inapowashwa, matokeo ya muundo yanahakikishwa kuwa JSON halali, isipokuwa katika visa maalum vya pembeni ambavyo unapaswa kuvitambua na kuvishughulikia ipasavyo.

Ili kuomba hali ya JSON kwa API ya Majibu ya Mazungumzo, weka response_format kuwa { "type": "json_object" } kwenye miundo inayotumika. Kwa Responses API, weka text.format kuwa { "type": "json_object" }, kwa mfano text: { "format": { "type": "json_object" } }, pale inapofaa. Katika API yoyote kati ya hizo, hali ya JSON hufanya kazi tu wakati masharti ya awali ya muundo/ujumbe/zana yametimizwa (kwa mfano, muundo unaauni json_object, mazungumzo yana maagizo ya kutoa JSON, na vikwazo vyovyote vya zana vinaendana). Angalau ujumbe mmoja wa ombi au ujumbe wa ingizo katika muktadha halisi wa ingizo lazima uwe na json katika umbo lisilojali herufi kubwa au ndogo, kama vile JSON, json, au Json; vinginevyo, API hurejesha hitilafu. Katika Responses, uga wa maagizo wa kiwango cha juu pekee hautoshelezi uthibitishaji huu. Mgao wa kiutendaji unapotumiwa kwenye miundo/njia zinazooana, vikwazo vya JSON hutumika kiotomatiki kwa hoja za mwito wa kitendaji; miundo isiyooana au michanganyiko ya zana/umbizo la jibu inaweza kukataliwa au huenda isitumie uchukuaji sampuli uliowekewa vikwazo vya JSON.

Vidokezo muhimu:

• Unapotumia hali ya JSON, lazima kila wakati uagize muundo utoe JSON kupitia ujumbe fulani katika mazungumzo, kwa mfano kupitia ujumbe wako wa mfumo. Usipojumuisha agizo wazi la kuzalisha JSON, muundo unaweza kuzalisha mtiririko usioisha wa nafasi tupu na ombi linaweza kuendelea kuendeshwa hadi lifikie kikomo cha tokeni. Ili kusaidia kuhakikisha husahau, hali ya JSON hukataa maombi isipokuwa ujumbe au maagizo husika ya ingizo yawe na neno json katika umbo fulani, bila kujali herufi kubwa au ndogo.

• Hali ya JSON haitahakikisha kuwa matokeo yanalingana na kielezo chochote mahususi, bali tu kwamba ni halali na yanachanganuliwa bila hitilafu. Unapaswa kutumia Matokeo Yaliyopangwa ili kuhakikisha yanalingana na kielezo chako, au ikiwa hilo haliwezekani, unapaswa kutumia maktaba ya uthibitishaji na huenda ujaribu tena ili kuhakikisha kuwa matokeo yanalingana na kielezo unachotaka.

• Programu yako lazima itambue na kushughulikia visa maalum vya pembeni vinavyoweza kusababisha matokeo ya muundo yasiwe kitu kamili cha JSON (tazama hapa chini)