Mgao wa kiutendaji katika API ya OpenAI

Mgao wa kiutendaji hukuruhusu kuunganisha miundo ya OpenAI na zana na mifumo ya nje. Hii ni muhimu kwa mambo mengi kama vile kuwapa wasaidizi wa AI uwezo, au kujenga miunganisho ya kina kati ya programu zako na LLM.

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

Mnamo Juni 2024, tulizindua Matokeo Yaliyopangwa. Unapoiwasha kwa kuweka strict: true katika ufafanuzi wako wa kitendaji, Matokeo Yaliyopangwa huhakikisha kuwa hoja zinazozalishwa na muundo kwa mwito wa kitendaji zinalingana kikamilifu na JSON Schema uliyotoa katika ufafanuzi wa kitendaji.

Mnamo Oktoba 2024, tulizindua kipengele cha “Tengeneza Chochote”, kinachowaruhusu wasanidi programu kueleza kitendaji, kukibandika moja kwa moja au kubandika msimbo wako na kuzalisha kielezo halali cha kitendaji. Pata maelezo zaidi kuhusu “Tengeneza 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)