Գործառույթի կանչ OpenAI API-ում

Գործառույթի կանչը թույլ է տալիս OpenAI-ի մոդելները միացնել արտաքին գործիքներին և համակարգերին։ Սա օգտակար է բազմաթիվ բաների համար, օրինակ՝ AI օգնականներին հնարավորություններով հզորացնելու կամ ձեր հավելվածների և LLM-ների միջև խոր ինտեգրումներ կառուցելու համար։

Ավելին իմացեք մեր գործառույթի կանչի մշակողի ուղեցույցում։

2024 թվականի հունիսին մենք գործարկեցինք Կառուցվածքային արդյունքները։ Երբ այն միացնում եք՝ ձեր գործառույթի սահմանման մեջ սահմանելով strict: true, Կառուցվածքային արդյունքները երաշխավորում են, որ մոդելի կողմից գործառույթի կանչի համար գեներացված արգումենտները ճշգրտորեն համապատասխանում են գործառույթի սահմանման մեջ ձեր տրամադրած JSON սխեմային։

2024 թվականի հոկտեմբերին մենք գործարկեցինք «Գեներացնել ամեն ինչ» գործառույթը, որը մշակողներին թույլ է տալիս նկարագրել գործառույթ, ուղղակիորեն տեղադրել այն կամ տեղադրել իրենց կոդը և գեներացնել վավեր գործառույթի սխեմա։ Ավելին իմացեք «Գեներացնել ամեն ինչ»-ի մասին օգնության կենտրոնի այս հոդվածում

Ինչպե՞ս կարող եմ օգտագործել գործառույթի կանչը։

Գործառույթի կանչը օգտակար է բազմաթիվ կիրառությունների համար, օրինակ՝

• Օգնականներին տվյալներ ստանալու հնարավորություն տալը․

• Օգնականներին գործողություններ կատարելու հնարավորություն տալը․

• Օգնականներին հաշվարկներ կատարելու հնարավորություն տալը․

• Հարուստ աշխատանքային հոսքերի կառուցում․

• տվյալների արդյունահանման խողովակաշար, որը ստանում է հում տեքստը, ապա այն փոխակերպում կառուցվածքային տվյալների և պահպանում տվյալների բազայում։

Գործառույթի կանչն աջակցվում է Responses API-ում, որը միավորում է այն հնարավորությունները, որոնք նախկինում բաժանված էին զրույցի ավարտման API-ի և Assistants API-ի միջև։

Ինչպե՞ս կարող եմ օգտագործել JSON ռեժիմը։

Երբ JSON ռեժիմը միացված է, ապահովվում է, որ մոդելի արդյունքը վավեր JSON լինի՝ բացառությամբ որոշ եզրային դեպքերի, որոնք պետք է հայտնաբերեք և պատշաճ կերպով մշակեք։

Զրույցի ավարտման API-ով JSON ռեժիմ պահանջելու համար աջակցվող մոդելներում response_format-ը սահմանեք որպես { "type": "json_object" }։ Responses API-ում text.format-ը սահմանեք որպես { "type": "json_object" }, օրինակ՝ text: { "format": { "type": "json_object" } }, որտեղ կիրառելի է։ Երկու API-ներում էլ JSON ռեժիմն աշխատում է միայն այն դեպքում, երբ բավարարված են մոդելի/հաղորդագրության/գործիքի նախապայմանները (օրինակ՝ մոդելն աջակցում է json_object-ը, զրույցը պարունակում է JSON ստեղծելու հրահանգներ, և գործիքի բոլոր սահմանափակումները համատեղելի են)։ Արդյունավետ մուտքային համատեքստում առնվազն մեկ հարցման հաղորդագրություն կամ մուտքային հաղորդագրություն պետք է պարունակի json՝ ռեգիստրից անկախ ձևով, օրինակ՝ JSON, json կամ Json, հակառակ դեպքում API-ն սխալ է վերադարձնում։ Responses-ում միայն վերին մակարդակի instructions դաշտը չի բավարարում այս վավերացումը։ Երբ համատեղելի մոդելներում/ուղիներում օգտագործվում է գործառույթի կանչ, JSON սահմանափակումները ավտոմատ կերպով կիրառվում են գործառույթի կանչի արգումենտների վրա․ անհամատեղելի մոդելները կամ գործիք/պատասխանի ձևաչափ համադրությունները կարող են մերժվել կամ չօգտագործել JSON-ով սահմանափակված նմուշառում։

Կարևոր նշումներ․

• JSON ռեժիմն օգտագործելիս միշտ պետք է մոդելին հրահանգեք ստեղծել JSON՝ զրույցի որևէ հաղորդագրության միջոցով, օրինակ՝ ձեր համակարգային հաղորդագրության միջոցով։ Եթե JSON գեներացնելու հստակ հրահանգ չներառեք, մոդելը կարող է ստեղծել բացատային նիշերի անվերջ հոսք, և հարցումը կարող է շարունակվել մինչև թոքենի սահմանաչափին հասնելը։ Որպեսզի չմոռանաք, JSON ռեժիմը մերժում է հարցումները, եթե համապատասխան մուտքային հաղորդագրությունները կամ հրահանգները չեն պարունակում json բառը որևէ ձևով՝ ռեգիստրից անկախ։

• JSON ռեժիմը չի երաշխավորում, որ արդյունքը կհամապատասխանի որևէ կոնկրետ սխեմայի․ այն միայն երաշխավորում է, որ այն վավեր է և վերլուծվում է առանց սխալների։ Պետք է օգտագործեք Կառուցվածքային արդյունքներ՝ ապահովելու համար, որ այն համապատասխանի ձեր սխեմային, կամ, եթե դա հնարավոր չէ, պետք է օգտագործեք վավերացման գրադարան և հնարավոր է՝ կրկնափորձեր՝ ապահովելու համար, որ արդյունքը համապատասխանի ձեր ցանկալի սխեմային։

• Ձեր հավելվածը պետք է հայտնաբերի և մշակի այն եզրային դեպքերը, որոնց պատճառով մոդելի արդյունքը կարող է չլինել ամբողջական JSON օբյեկտ (տե՛ս ստորև)