Funkcijas izsaukšana OpenAI API

Funkcijas izsaukšana ļauj savienot OpenAI modeļus ar ārējiem rīkiem un sistēmām. Tas ir noderīgi daudzām lietām, piemēram, AI asistentu iespēju paplašināšanai vai dziļu integrāciju veidošanai starp jūsu lietojumprogrammām un LVM.

Uzziniet vairāk mūsu funkcijas izsaukšanas izstrādātāja ceļvedī.

2024. gada jūnijā mēs ieviesām strukturētos rezultātus. Kad to ieslēdzat, funkcijas definīcijā iestatot strict: true, strukturētie rezultāti garantē, ka argumenti, ko modelis ģenerē funkcijas izsaukumam, precīzi atbilst JSON shēmai, ko norādījāt funkcijas definīcijā.

2024. gada oktobrī mēs ieviesām funkciju „Ģenerēt jebko”, kas ļauj izstrādātājiem aprakstīt funkciju, ielīmēt to tieši vai ielīmēt savu kodu un ģenerēt derīgu funkcijas shēmu. Uzziniet vairāk par „Ģenerēt jebko” šajā palīdzības centra rakstā

Kā varu izmantot funkcijas izsaukšanu?

Funkcijas izsaukšana ir noderīga daudziem lietošanas gadījumiem, piemēram:

• Ļaut asistentiem iegūt datus:

• Ļaut asistentiem veikt darbības:

• Ļaut asistentiem veikt aprēķinus:

• Bagātīgu darbplūsmu veidošana:

• datu izgūšanas konveijers, kas iegūst neapstrādātu tekstu, pēc tam pārvērš to strukturētos datos un saglabā datubāzē.

Funkcijas izsaukšana tiek atbalstīta Responses API, kas apvieno iespējas, kas iepriekš bija sadalītas starp tērzēšanas pabeigšanas API un Assistants API.

Kā varu izmantot JSON režīmu?

Kad JSON režīms ir ieslēgts, tiek nodrošināts, ka modeļa rezultāts ir derīgs JSON, izņemot dažus robežgadījumus, kas jums atbilstoši jāatpazīst un jāapstrādā.

Lai pieprasītu JSON režīmu ar tērzēšanas pabeigšanas API, atbalstītajos modeļos iestatiet response_format uz { "type": "json_object" }. Izmantojot Responses API, iestatiet text.format uz { "type": "json_object" }, piemēram, text: { "format": { "type": "json_object" } }, kur tas ir piemērojams. Jebkurā no API JSON režīms darbojas tikai tad, ja ir izpildīti modeļa/ziņojuma/rīka priekšnosacījumi (piemēram, modelis atbalsta json_object, sarunā ir iekļautas instrukcijas izveidot JSON, un visi rīka ierobežojumi ir saderīgi). Vismaz vienam pieprasījuma ziņojumam vai ievades ziņojumam faktiskajā ievades kontekstā ir jāietver json reģistrnejutīgā formā, piemēram, JSON, json vai Json; pretējā gadījumā API atgriež kļūdu. Responses gadījumā ar augstākā līmeņa instrukciju lauku vien nepietiek, lai izpildītu šo validāciju. Ja funkcijas izsaukšana tiek izmantota saderīgos modeļos/ceļos, JSON ierobežojumi tiek automātiski piemēroti funkcijas izsaukuma argumentiem; nesaderīgi modeļi vai rīka/atbildes formāta kombinācijas var tikt noraidītas vai neizmantot JSON ierobežotu paraugošanu.

Svarīgas piezīmes:

• Izmantojot JSON režīmu, jums vienmēr jānorāda modelim izveidot JSON, izmantojot kādu ziņojumu sarunā, piemēram, sistēmas ziņojumu. Ja neiekļausiet skaidru instrukciju ģenerēt JSON, modelis var ģenerēt nebeidzamu atstarpju plūsmu, un pieprasījums var turpināt darboties, līdz sasniedz tekstvienību limitu. Lai palīdzētu nodrošināt, ka to neaizmirstat, JSON režīms noraida pieprasījumus, ja vien attiecīgie ievades ziņojumi vai instrukcijas reģistrnejutīgi nesatur vārdu json kādā formā.

• JSON režīms negarantē, ka rezultāts atbilst kādai konkrētai shēmai, bet tikai to, ka tas ir derīgs un parsējas bez kļūdām. Jums jāizmanto strukturētie rezultāti, lai nodrošinātu atbilstību savai shēmai, vai, ja tas nav iespējams, jāizmanto validācijas bibliotēka un, iespējams, atkārtoti mēģinājumi, lai nodrošinātu, ka rezultāts atbilst vēlamajai shēmai.

• Jūsu lietojumprogrammai jāatpazīst un jāapstrādā robežgadījumi, kuru dēļ modeļa rezultāts var nebūt pilnīgs JSON objekts (skatiet tālāk)