OpenAI
Kaca iki diterjemahake nganggo mesin. Deleng artikel asli basa Inggris.

Nelpon Fungsi ing OpenAI API

Apa iku nelpon fungsi lan kepriye cara kerjane ing OpenAI API?

Pembaruan: 28 days ago

Wiwit 11 Maret 2025, kami wis ngrilis blok bangunan saka platform agen anyar kami. Kanggo rincian, delengen dokumen API kanggo Responses API, Tools kalebu Web Search, File Search, lan Computer Use, lan Agents SDK karo Tracing.

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

Sinau luwih lengkap ing pandhuan pangembang nelpon fungsi kita.

Ing Juni 2024, kita ngluncurake Keluaran Terstruktur. Nalika sampeyan nguripake kanthi nyetel strict: true, ing definisi fungsi sampeyan, Keluaran Terstruktur njamin yen argumen sing digawe model kanggo panggilan fungsi pas cocog karo JSON Schema sing sampeyan wenehake ing definisi fungsi.

Ing Oktober 2024, kita ngluncurake fitur 'Generate Anything', sing ngidini pangembang njlentrehake sawijining fungsi, nempelake langsung utawa nempelake kode sampeyan lan ngasilake skema fungsi sing valid. Sinau luwih lengkap babagan 'Generate Anything' ing artikel pusat bantuan ing kene

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)

Apa artikel iki migunani kanggo sampeyan?