Nelpon Fungsi ing OpenAI API

Nelpon fungsi ngidini sampeyan nyambungake model OpenAI menyang piranti lan sistem eksternal. Iki migunani kanggo akeh perkara, kayata menehi kemampuan marang asisten AI utawa nggawe integrasi jero antarane aplikasi sampeyan lan LLM.

Sinau luwih lengkap ing pandhuan pangembang kanggo nelpon fungsi.

Ing Juni 2024, kita ngluncurake Keluaran Terstruktur. Ing model lan konfigurasi panjaluk sing didhukung, nalika model ngasilake panggilan fungsi, nyetel strict: true ing definisi fungsi sampeyan njamin yen argumen sing digawe manut skema sing diwenehake, anggere skema kasebut nggunakake subkumpulan Skema JSON sing didhukung lan nyukupi syarat mode ketat. Panjaluk sing nggunakake skema sing ora didhukung utawa ora cocog bakal ditolak lan ngasilake kasalahan.

Ing Oktober 2024, kita ngluncurake fitur 'Gawe Apa Wae', sing ngidini pangembang njlentrehake fungsi lan langsung nempelake katrangan kasebut, utawa nempelake kode sampeyan, banjur ngasilake skema fungsi sing valid. Sinau luwih lengkap babagan 'Gawe Apa Wae' ing artikel pusat bantuan iki

Kepiye carane aku bisa nganggo nelpon fungsi?

Nelpon fungsi migunani kanggo akeh kasus panggunaan, kayata:

• Ngaktifake asisten kanggo njupuk data:

• Ngaktifake asisten kanggo nindakake tumindak:

• Ngaktifake asisten kanggo nindakake komputasi:

• Mbangun alur kerja sugih:

• pipeline ekstraksi data sing njupuk teks mentah, banjur ngowahi dadi data terstruktur lan nyimpen ing basis data.

Nelpon fungsi didhukung ing Responses API, sing nyawijikake kapabilitas sing sadurunge dipisah ing Chat Completions API lan Assistants API.

Kepiye carane aku bisa nganggo mode JSON?

Nalika mode JSON diuripake, keluaran model dijamin dadi JSON sing valid, kajaba ing sawetara kasus pinggir sing kudu kokdeteksi lan tangani kanthi trep.

Kanggo njaluk mode JSON nganggo Chat Completions API, setel response_format dadi { "type": "json_object" } ing model sing didhukung. Kanthi Responses API, setel text.format dadi { "type": "json_object" }, contone text: { "format": { "type": "json_object" } }, yen cocog. Ing API endi wae, mode JSON mung bisa mlaku yen prasyarat model/pesen/tool wis ketemu (contone, model ndhukung json_object, pacelathon ngemot instruksi kanggo ngasilake JSON, lan watesan tool apa wae kompatibel). Paling ora siji pesen panjaluk utawa pesen input ing konteks input efektif kudu ngemot json ing wujud sing ora mbedakake huruf gedhe-cilik, kayata JSON, json, utawa Json; yen ora, API bakal mbalekake kasalahan. Ing Responses, kolom instruksi tingkat paling dhuwur wae ora nyukupi validasi iki. Nalika nelpon fungsi digunakake ing model/jalur sing kompatibel, watesan JSON ditrapake kanthi otomatis marang argumen panggilan fungsi; model utawa kombinasi tool/format tanggapan sing ora kompatibel bisa ditolak utawa bisa uga ora nganggo sampling sing diwatesi JSON.

Cathetan penting:

• Nalika nganggo mode JSON, sampeyan kudu tansah mrentah model supaya ngasilake JSON liwat salah siji pesen ing pacelathon, contone liwat pesen sistem sampeyan. Yen sampeyan ora nyakup instruksi eksplisit kanggo ngasilake JSON, model bisa ngasilake aliran spasi putih tanpa entek lan panjaluk bisa terus mlaku nganti tekan wates token. Kanggo mbantu mesthekake sampeyan ora lali, mode JSON nolak panjaluk kajaba pesen input utawa instruksi sing relevan ngemot tembung json ing sawetara wujud, tanpa mbedakake huruf gedhe-cilik.

• Mode JSON ora bakal njamin keluaran cocog karo skema tartamtu, mung njamin iku valid lan bisa diurai tanpa kasalahan. Sampeyan kudu nganggo Keluaran Terstruktur kanggo mesthekake iku cocog karo skema sampeyan, utawa yen ora bisa, sampeyan kudu nganggo pustaka validasi lan bisa uga nyoba maneh kanggo mesthekake yen keluaran cocog karo skema sing dikarepake.

• Aplikasi sampeyan kudu ndeteksi lan nangani kasus pinggir sing bisa nyebabake keluaran model ora dadi obyek JSON sing lengkap (delengen ing ngisor)