Priklic funkcij v OpenAI API

Priklic funkcij omogoča povezovanje modelov OpenAI z zunanjimi orodji in sistemi. To je uporabno za številne namene, na primer za razširitev zmogljivosti pomočnikov z umetno inteligenco ali vzpostavitev tesnih integracij med aplikacijami in velikimi jezikovnimi modeli.

Več preberite v našem vodniku za razvijalce o priklicu funkcij.

Junija 2024 smo predstavili strukturirane izhode. Pri podprtih modelih in konfiguracijah zahtev nastavitev strict: true v definiciji funkcije zagotavlja, da so argumenti, ustvarjeni ob priklicu funkcije, skladni s predloženo shemo, če ta uporablja podprto podmnožico sheme JSON in izpolnjuje zahteve strogega načina. Zahteve z nepodprtimi ali neskladnimi shemami so zavrnjene z napako.

Oktobra 2024 smo predstavili funkcijo »Ustvari kar koli«, ki razvijalcem omogoča, da opišejo funkcijo ali neposredno prilepijo njeno definicijo oziroma svojo kodo ter ustvarijo veljavno funkcijsko shemo. Več o funkciji »Ustvari kar koli« preberite v tem članku centra za pomoč.

Kako lahko uporabim priklic funkcij?

Priklic funkcij je uporaben v številnih primerih uporabe, na primer za:

• Omogočanje pomočnikom, da pridobivajo podatke:

• Omogočanje pomočnikom, da izvajajo dejanja:

• Omogočanje pomočnikom, da izvajajo izračune:

• Gradnja bogatih potekov dela:

• cevovod za pridobivanje podatkov, ki pridobi neobdelano besedilo, ga nato pretvori v strukturirane podatke in shrani v zbirko podatkov.

Priklic funkcij je podprt v API-ju Responses, ki združuje zmogljivosti, ki so bile prej razdeljene med API za dopolnitve klepeta in API Assistants.

Kako lahko uporabim način JSON?

Ko je način JSON vklopljen, je zagotovljeno, da je izhod modela veljaven JSON, razen v nekaterih robnih primerih, ki jih morate zaznati in ustrezno obravnavati.

Če želite zahtevati način JSON z API-jem za dopolnitve klepeta, pri podprtih modelih nastavite response_format na { "type": "json_object" }. Z API-jem Responses nastavite text.format na { "type": "json_object" }, na primer text: { "format": { "type": "json_object" } }, kjer je primerno. V obeh API-jih način JSON deluje le, če so izpolnjeni predpogoji za model, sporočila in orodja (na primer, model podpira json_object, pogovor vključuje navodila za ustvarjanje JSON-a, morebitne omejitve orodij pa so združljive). Vsaj eno sporočilo zahteve ali vhodno sporočilo v dejanskem vhodnem kontekstu mora vsebovati json v obliki, ki ni občutljiva na velikost črk, na primer JSON, json ali Json; sicer API vrne napako. V Responses samo polje navodil na najvišji ravni ne izpolnjuje tega preverjanja. Ko se priklic funkcij uporablja pri združljivih modelih/poteh, se omejitve JSON samodejno uporabijo za argumente priklica funkcije; nezdružljivi modeli ali kombinacije orodij in oblik odziva se lahko zavrnejo ali pa ne uporabljajo vzorčenja, omejenega z JSON.

Pomembne opombe:

• Pri uporabi načina JSON morate modelu vedno naročiti, naj ustvari JSON, in sicer prek katerega od sporočil v pogovoru, na primer prek sistemskega sporočila. Če ne vključite izrecnega navodila za ustvarjanje JSON-a, lahko model ustvarja neskončen tok presledkov, zahteva pa se lahko izvaja neprekinjeno, dokler ne doseže omejitve žetonov. Da tega ne bi pozabili, način JSON zavrne zahteve, razen če ustrezna vhodna sporočila ali navodila vsebujejo besedo json v neki obliki, ne glede na velikost črk.

• Način JSON ne zagotavlja, da se izhod ujema s katero koli določeno shemo, temveč le, da je veljaven in se razčleni brez napak. Uporabite strukturirane izhode, da zagotovite ujemanje s svojo shemo; če to ni mogoče, uporabite knjižnico za preverjanje veljavnosti in po potrebi ponovne poskuse, da zagotovite ujemanje izhoda z želeno shemo.

• Vaša aplikacija mora zaznati in obravnavati robne primere, zaradi katerih izhod modela morda ni popoln objekt JSON (glejte spodaj)