Thirrja e funksioneve në API-n e OpenAI

Thirrja e funksionit ju lejon të lidhni modelet e OpenAI me mjete dhe sisteme të jashtme. Kjo është e dobishme për shumë qëllime, si pajisja e asistentëve të IA-së me aftësi të reja ose krijimi i integrimeve të thella midis aplikacioneve tuaja dhe LLM-ve.

Mësoni më shumë në udhëzuesin tonë për zhvilluesit mbi thirrjen e funksionit.

Në qershor 2024, prezantuam outputet e strukturuara. Në modelet dhe konfigurimet e mbështetura të kërkesave, kur modeli lëshon një thirrje funksioni, vendosja e strict: true në përkufizimin e funksionit tuaj siguron që argumentet e gjeneruara t’i përmbahen skemës së dhënë, me kusht që skema të përdorë nënbashkësinë e mbështetur të Skemës JSON dhe të përmbushë kërkesat e modalitetit strikt. Kërkesat me skema të pambështetura ose që nuk përputhen me kërkesat refuzohen me një gabim.

Në tetor 2024, prezantuam veçorinë 'Gjenero çfarëdo', e cila u lejon zhvilluesve të përshkruajnë një funksion, ta ngjitin atë drejtpërdrejt ose të ngjitin kodin e tyre dhe të gjenerojnë një skemë të vlefshme funksioni. Mësoni më shumë rreth 'Gjenero çfarëdo' në këtë artikull të qendrës së ndihmës

Si mund të përdor thirrje funksioni?

Thirrje funksioni është e dobishme për një numër të madh rastesh përdorimi, si:

• Mundësimi i asistentëve për të marrë të dhëna:

• Mundësimi i asistentëve për të kryer veprime:

• Mundësimi i asistentëve për të kryer llogaritje:

• Ndërtimi i flukseve të pasura të punës:

• një proces nxjerrjeje të dhënash që merr tekst të papërpunuar, pastaj e konverton në të dhëna të strukturuara dhe e ruan në një bazë të dhënash.

Thirrje funksioni mbështetet në API-në Responses, e cila bashkon aftësi që më parë ishin të ndara mes API i përfundimeve të bisedës dhe API-së Assistants.

Si mund ta përdor modalitetin JSON?

Kur modaliteti JSON është i aktivizuar, outputi i modelit sigurohet të jetë JSON i vlefshëm, përveç disa rasteve skajore që duhet t’i zbuloni dhe t’i trajtoni siç duhet.

Për të kërkuar modalitetin JSON me API i përfundimeve të bisedës, vendosni response_format në { "type": "json_object" } te modelet e mbështetura. Me API-në Responses, vendosni text.format në { "type": "json_object" }, për shembull text: { "format": { "type": "json_object" } }, aty ku zbatohet. Në secilën API, modaliteti JSON funksionon vetëm kur plotësohen parakushtet e modelit/mesazhit/mjetit (për shembull, modeli mbështet json_object, biseda përfshin udhëzime për të prodhuar JSON dhe çdo kufizim mjeti është i përputhshëm). Të paktën një mesazh kërkese ose mesazh hyrës në kontekstin efektiv të inputit duhet të përmbajë json në një formë pa dallim të shkronjave të mëdha e të vogla, si JSON, json ose Json; përndryshe, API-ja kthen një gabim. Në Responses, vetëm fusha e udhëzimeve të nivelit të sipërm nuk e përmbush këtë validim. Kur thirrje funksioni përdoret në modele/rrugë të përputhshme, kufizimet JSON zbatohen automatikisht te argumentet e thirrjes së funksionit; modelet ose kombinimet e papërputhshme mjet/format përgjigjeje mund të refuzohen ose mund të mos përdorin kampionim të kufizuar nga JSON.

Shënime të rëndësishme:

• Kur përdorni modalitetin JSON, duhet gjithmonë ta udhëzoni modelin të prodhojë JSON përmes ndonjë mesazhi në bisedë, për shembull përmes mesazhit tuaj të sistemit. Nëse nuk përfshini një udhëzim të qartë për të gjeneruar JSON, modeli mund të gjenerojë një rrjedhë të pafund hapësirash të bardha dhe kërkesa mund të vazhdojë derisa të arrijë kufirin e tokenëve. Për t’ju ndihmuar të mos harroni, modaliteti JSON i refuzon kërkesat nëse mesazhet ose udhëzimet përkatëse të inputit nuk përmbajnë fjalën json në ndonjë formë, pa dallim shkronjash të mëdha e të vogla.

• Modaliteti JSON nuk garanton që outputi përputhet me ndonjë skemë specifike, por vetëm që është i vlefshëm dhe analizohet pa gabime. Duhet të përdorni outpute të strukturuara për të siguruar që përputhet me skemën tuaj, ose, nëse kjo nuk është e mundur, të përdorni një bibliotekë validimi dhe ndoshta riprovime për të siguruar që outputi përputhet me skemën tuaj të dëshiruar.

• Aplikacioni juaj duhet të zbulojë dhe të trajtojë rastet skajore që mund të bëjnë që outputi i modelit të mos jetë një objekt JSON i plotë (shih më poshtë)