Сіз пайдаланушының хабарын GPT API-іне жібересіз, ал табиғи тілдегі жауаптың орнына модель дәл қай функцияны қандай аргументтермен шақыру керегін көрсететін құрылымдалған JSON нысанын қайтарады. Бұл — функцияларды шақыру (function calling), және ол ҮТМ-дермен (үлкен тілдік модельдермен) құра алатын қолданбалар түрін өзгертеді.
Көптеген әзірлеушілер "function calling" сөзін естіп, модель олардың атынан код орындайды деп ойлайды. Олай емес.
Function calling қолданылғанда, ҮТМ функцияны өзі орындамайды. Оның орнына ол сәйкес функцияны анықтап, барлық қажет параметрлерді жинайды да, ақпаратты құрылымдалған JSON форматында ұсынады.
Нақты логиканы орындау әлі де сіздің қолданбаңыздың міндеті. Модель тек қай нәрсені қандай кірістермен орындау керегін айтады.
Бұл айырмашылық естігендей қарапайым емес — ол интеграцияны қалай жобалайтыныңыздан бастап қауіпсіздікке дейінгі бәріне әсер етеді.
Функцияларды шақыру шын мәнінде не — және адамдар нені қате түсінеді
Function calling (құралдарды шақыру деп те аталады) OpenAI модельдерінің сыртқы жүйелермен интерфейстесуіне және оқу деректерінен тыс деректерге қол жеткізуіне қуатты әрі икемді жол береді.
Атауы — алғашқы түсінбеушіліктің көзі. Адамдар модель бірдеңе орындайды деп ойлайды. Олай емес.
Function calling туралы атаулар мен түсіндірулер көп, бірақ бәрі бір сөйлемге саяды: "function calling — бұл үлкен тілдік модельдің құрылымдалған нәтиже шығару қабілетінің бір түрі." ҮТМ-дер өздері ешқандай функция шақырмайды; сіз промптта берген алдын ала анықталған функциялар арасынан қайсысын шақыру керегін ұсынады.
Екінші түсінбеушілік — ескі API беткейіне қатысты.
functions және function_call параметрлері API-дің 2023-12-01-preview нұсқасы шыққалы бері ескіртілген. functions орнына tools параметрі келді.
Егер сіз ескі functions параметрін қолданатын нұсқаулықты ұстанып жүрсеңіз, сіз қазірдің өзінде ескірген синтаксиспен жұмыс істеп отырсыз. Оның орнына tools және tool_choice қолданыңыз.
Функция — бұл JSON schema арқылы анықталатын құралдың нақты түрі. Функцияның анықтамасы модельге сіздің қолданбаңызға деректер беруге мүмкіндік береді, ал сіздің кодыңыз модель ұсынған әрекеттерді орындау немесе деректерге қол жеткізу үшін оны пайдалана алады.
Осы схема function calling-тің жай промптқа қарағанда сенімділік артықшылығын береді — сіз модельдің дұрыс форматта шығарады деп үміттенбейсіз, құрылым мәжбүрлеуі API деңгейінде жүреді.
OpenAI API-де функцияларды шақыру қалай жұмыс істейді — қадам-қадаммен
Құралдарды шақыру — бұл сіздің қолданбаңыз бен модельдің арасында OpenAI API арқылы өтетін көпқадамды диалог. Құралдарды шақыру ағынында бес жоғары деңгейлі қадам бар: модельге шақыра алатын құралдарымен бірге сұрау жіберу...
Практикада әр қадам мынандай көрінеді.
1-қадам: Функция схемаларын анықтаңыз. Әр қолжетімді функцияны tools параметрінің ішіндегі JSON нысаны ретінде сипаттайсыз. Схемаға функцияның атауы, модель оны қашан шақыру керегін шешу үшін қолданатын табиғи тілдегі сипаттама және JSON Schema конвенцияларына сай parameters бөлігі кіреді.
Сіздің description қаншалықты нақтылы болған сайын — функцияны қашан және қандай жағдайларда шақыру керегі тұрғысынан — соғұрлым жақсы. Назар аударыңыз: функция сипаттамалары да промпттың бір бөлігі және токендер жұмсайды.
2-қадам: Сұрауды жіберіңіз. Пайдаланушы хабарын және tools тізіміңізді қосып, Chat Completions API-ін шақырасыз. Модель екеуін де көреді.
3-қадам: Модель функцияны шақыру-қаламауды шешеді.
Функция шақыру — бұл модель промптты қарап, нұсқауды орындау үшін қолжетімді құралдардың бірін шақыру қажет деп шешкенде алатын арнайы жауап түрі. Мысалы, модель "Париждегі ауа райы қандай?" деген промпт алса, get_weather құралына Парижді орналасу аргументі ретінде беріп, шақыру ұсына алады.
4-қадам: Сіздің кодыңыз функцияны орындайды. Модель жауаптарын талдап, функция атауы мен аргументтерін шығарып алып, нақты кодты өз орындау ортаңызда іске қосасыз. API құрылымдалған JSON қайтарады — әрі қарай не істеу керегін сіз шешесіз.
5-қадам: Нәтижені кері жіберіңіз.
Соңында функция анықтамаларының бәрін, бастапқы промптты, модельдің құрал шақыруын және құралдың шығаруын қайтадан модельге жіберіп, мәтіндік жауап аласыз
— мысалы, "Бүгін Парижде ауа райы 25°C."
Көп нұсқаулықтар өткізіп кететін бір жайт:
функция анықтамаңызда strict: true орнатсаңыз, Structured Outputs модель тудырған функция аргументтері сіз берген JSON Schema-ға дәл сәйкес келетінін кепілдейді.
strict мәнін true ету функция шақыруларының схеманы "ең үздік әрекет" ретінде емес, сенімді түрде ұстануын қамтамасыз етеді. OpenAI әрқашан strict режимін қосуды ұсынады.
Әрқашан. Қоспауға жақсы себеп жоқ.
Сонымен қатар параллель функция шақыру да бар.
Пайдаланушы сұрауына байланысты, 2023 жылғы 6 қарашада немесе одан кейін шығарылған ең жаңа модельдерді қолдансаңыз, модель параллель функция шақыруды жүзеге асыра алады.
Бұл "Лондонда және Токиода ауа райы қандай?" сияқты бір сұраудың тізбекті түрде емес, екі құрал шақыруын бір уақытта тудыруы мүмкін дегенді білдіреді.
Функцияларды шақырудың нақты қолданылу сценарийлері
Ауа райы мысалы бәр жерде бар, өйткені ол таза. Өндірістік қолданбалар бұдан күрделірек әрі қызығырақ.
Тікелей деректермен тұтынушы қолдау құбырлары
Function calling көптеген жағдайларда пайдалы — мысалы, қолданушы "менің соңғы тапсырыстарым қандай?" деп сұрағанда жауап бермес бұрын ішкі жүйеден ең соңғы тұтынушы деректерін алу керек болатын AI ассистент.
Модель ниетті анықтайды, контексттен тұтынушы ID-ін шығарады және сіздің CRM ішкі API-ін шақырады. Осал регулярлы өрнектер жоқ. Алма-кезек үзіліп қалатын промпт үлгілері жоқ.
Құрылымдалған деректерді ауқымды түрде шығарып алу
Шикі мәтінді алып, оны құрылымдалған деректерге түрлендіріп, дерекқорға сақтайтын деректерді шығару құбыры — тағы да мықты қолдану. Мыңдаған құжат бойынша тұрақты схемаларға қол жеткізесіз, әр құжат түріне бөлек талдау логикасын қолдан-қолға баптамай.
Табиғи тілден API-ге түрлендіру
Деректерді шығару және тегтеу, табиғи тілден API шақыруларына немесе жарамды дерекқор сұрауларына көмектесетін қолданбалар, және білім базасымен өзара әрекеттесетін диалогтық іздеу жүйелері — мұның бәрі function calling-тің шығыс форматына қойылатын кепілдіктерінен пайда көреді. Нәтиже төменгі жүйелерді жүргізуі тиіс болғанда, вариативтілікке төзім жоқ.
Бірнеше құралмен агенттік жұмыс процестері
Әзірлеушілер үшін function calling оқу тоқтауы шектеулерін тірі деректермен жабуға мүмкіндік береді — акция бағаларын, ауа райын немесе соңғы дерекқор жазбаларын алу. Сондай-ақ әрекеттерді орындауға мүмкіндік береді — ҮТМ-ді пассивті бақылаушыдан күйді өзгертуге қабілетті белсенді қатысушыға айналдырады, мысалы, хат жіберу, CRM жаңарту немесе кодты жариялау.
Жәй чатботтан басты айырмашылығы: модель жай мәтін тудырмайды, ол сіздің жүйелеріңіз бойынша нақты операцияларды үйлестіреді.
Функцияларды шақырудың үздік тәжірибелері — әзірлеушілер жиі қателесетін тұстар
Бұл бөлімді көп нұсқаулықтар мүлде аттап өтеді, сондықтан командалар түнгі 2-де өндірістегі түсініксіз ақауларды жөндеп жүреді.
Сипаттамаларды тым жалпылама жазу. Модель функцияны қашан шақыру керегін сіздің сипаттамаңызға қарап шешеді. Егер сипаттамаңыз "пайдаланушы сұрауларын өңдейді" сияқты жалпы болса, модельде оны қашан триггерлеу керегіне сенімді белгі болмайды. Триггер шарттары мен күтілетін кірістер пішіні туралы нақты болыңыз. Сипаттаманы ярлык емес, келісімшарт деп қараңыз.
Бірден тым көп функцияны ашу
Функция сипаттамалары кіріс промпттағы токендердің едәуір бөлігін тұтына алады.
Жүйелік промптқа 50+ құралдың анықтамасын жүктеу екі мәселе тудырады: құн мен кідіріс, өйткені құрал анықтамалары кіріс токендерін жейді; және дәлдіктің төмендеуі, өйткені құрал опциялары көбейген сайын модельдің дұрысын таңдау қабілеті төмендейді.
Ісіңізге шын мәнінде қажет ең шағын жиыннан бастаңыз.
Модель параметр ойдан шығармайды деп ойлау. Шығарады.
Модель параметрлерді ойдан құрастыра алады
— әсіресе enum арқылы айқын шектелмеген міндетті емес өрістер үшін. Дәл осы себептен strict: true маңызды: ол модельге схемаңыздан тыс өрістерді ойлап табуды шектейді.
Көпбұрылымды циклді елемеу. Әзірлеушілер көбіне бақытты жолды ғана салады — қолданушы сұрайды, модель функция шақырады, болды.
Модель сіз анықтаған схемаға сәйкес келмейтін функция шақыруларын тудыруы немесе қосылмаған функцияны шақырғысы келуі мүмкін. Егер модель күтпеген функция шақыруларын тудырып жатса, жүйелік хабарға "Саған берілген функцияларды ғана қолдан" деген бір сөйлем қосып көріңіз.
Шеткі жағдайларға дайын болыңыз.
Жазу операциялары алдында растау қадамын өткізіп жіберу.
Код орындау, дерекқорларды жаңарту немесе хабарламалар жіберу сияқты әрекеттерге триггер беретін функция шақыруларының нақты әлемдік әсерін ескеріңіз. Әрекет жасайтын функциялар үшін орындаудан бұрын пайдаланушыдан растауды талап ететін қадам енгізу қатаң ұсынылады.
Егер функция шақыруы деректерді өшіру, ақша жіберу немесе сыртқы күйді өзгертуі мүмкін болса, алдымен адам бекітуі тиіс.
Қауіпсіздік және сенімділік қарастырулары
Function calling ҮТМ-нің мүмкіндіктерін кеңейтеді. Сол сияқты шабуылдаушы жасай алатын нәрселерді де кеңейтеді.
Негізгі қауіп — промпт-инъекция.
Промпт-инъекцияның мақсаттары әртүрлі болуы мүмкін, бірақ жеке деректерді төменгі құрал шақырулары арқылы сыртқа шығару, сәйкессіз әрекеттер жасау, немесе модель мінез-құлқын күтпеген түрде өзгерту кіреді.
Функцияларыңыз хат жібере, дерекқорларды сұрай немесе вебхуктарды триггерлей алатын болса, инъекция шабуыл — жай чатботтың сценарийден ауытқуы емес, бұл ықтимал бұзу.
AI жүйелері чаттан шығып, құралдарды шақыра бастаса және әрекет етсе, промпт-инъекция әлдеқайда күрделі мәселе болады. Веб-бетте, құжатта немесе сыртқы құралда жасырылған зиянды нұсқаулар жүйеге үстемелеп, сезімтал ақпаратты ашуға немесе модель ешқашан жасамауы тиіс әрекеттерді триггерлеуге тырысуы мүмкін.
Азайтудың нақты қабаттары бар.
Сенімсіз деректер ешқашан агент мінез-құлқын тікелей басқармайтындай етіп жұмыс ағындарын жобалаңыз. Түйіндер арасында инъекция қаупінің өтуін шектеу үшін сыртқы кірістерден тек нақты құрылымдалған өрістерді — мысалы, enum-дар немесе валидтелген JSON — ғана шығарыңыз.
Оған қоса,
модель тудырған функция шақыруларын әрдайым тексеріңіз. Бұл параметрлерді, шақырылатын функцияны және шақырудың көзделген әрекетке сәйкестігін тексеруді қамтиды.
Ыңғайсыз шындық:
"Промпт-инъекция, дәл вебтегі алаяқтық пен әлеуметтік инженерия сияқты, ешқашан толық 'шешілмейді.'"
Бұл — OpenAI-дің өз бағасы. Практикалық салдары — агенттік function calling жүйелерін модель әрқашан ойлағандай әрекет етеді деген болжаммен жобаламау керек. Көп деңгейлі қорғаныс — валидация, шектелген рұқсаттар, разрушающий операциялар үшін адам араласуы — жалғыз ақылға қонымды тәсіл.
Функцияларды шақыру vs. промпт-инжиниринг — қашан қайсысын қолдану
Бұл салыстыру жиі туындайды. Қысқа жауап: олар әртүрлі мәселелерді шешеді, ал екеуін шатастыру function calling жеткілікті жерде артық күрделендірілген промпттарға, немесе жай промптпен оңайырақ болатын жерде сынғыш функция схемаларына әкеледі.
Промпт-инжиниринг модельдің ішкі ойлауын бағыттайтын мәтіндік кірістерді құрастыруды қамтиды — мысалы, одан "қадам-қадам ойлауын" сұрау.
Ол модельдің ойлауын пішіндейді. Ал функцияларды шақыру модель шығаратын нәтижені пішіндейді және оны тікелей сіздің жүйеңізге бағыттайды.
Құралдарды шақыру — ҮТМ-нің сыртқы жүйелермен өзара әрекеттесуіне мүмкіндік беретін қабілет. Модель қай құралды қолдану керегін шешуі үшін промпт-инжинирингті пайдаланғанмен, құралдарды шақыру — әрекетті шынымен орындайтын тетік. Екеуі де қажет болуы мүмкін, бірақ мақсаттары бөлек.
Функцияларды шақырудың промптқа негізделген құрылымдалған нәтижеден техникалық артықшылығы:
құралдарды шақыру ұғымы модельдің өзіне "тігілген". Модельге белгілі бір форматты қайтаруы керек екенін түсіндіруге токендер мен күш жұмсаудың қажеті жоқ.
"Жауабыңды X, Y, Z өрістері бар JSON ретінде қайтар" деп промпт құрастырғанда, сіз модель кейде орындауы мүмкін нұсқауларға токен жұмсайсыз. Function calling-де схема мәжбүрлеуі API деңгейінде іске асады.
Қазір көптеген ҮТМ платформаларында нативті қолдау тапқан функция шақыру API-лері қатаң дерек валидациясы мен бағдарламалық жұмыс ағындарымен интеграцияға мүмкіндік беретін формалды, схемаға негізделген интерфейс береді.
Өндірісте төменгі жүйелерге ағатын деректер үшін промпт-инжинирингтен гөрі мұны таңдаудың нақты себебі — сенімділік өндірісте міндетті.
| Өлшем | Промпт-инжиниринг | Функцияларды шақыру |
|---|---|---|
| Негізгі мақсат | Модель ойлауын және тонды пішіндеу | Жүйелік интеграцияға арналған құрылымдалған нәтиже шығару |
| Шығыс форматы | Еркін мәтін (немесе мәтін тәрізді JSON) | Мәжбүрленген JSON schema |
| Схема сенімділігі | Үздік-әрекет; ауытқуға бейім | strict: true арқылы кепілденеді |
| Токен құны | Қарапайым нәтижелер үшін төмен | Жоғары (функция анықтамалары токендер қосады) |
| Қашан қолдану | Ойлау міндеттері, мәтін генерациясы, стиль | Құрылымдалған деректер шығару, API оркестрациясы, агенттік әрекеттер |
| Промпт-инъекция экспозициясы | Төмен (сыртқы құрал орындалмайды) | Жоғары (құрал шақырулары нақты әрекеттерді триггерлей алады) |
Практикалық эвристика: нәтиже төменгі жүйені жүргізуі керек болса — дерекқорға жазу, API шақыруы, кодыңыздағы тармақталу шешімі — function calling қолданыңыз. Егер нәтиже адам оқуына арналса, промпт-инжиниринг әдетте жеткілікті және арзанырақ.
Негізгі түйіндер
| Тақырып | Есте сақтайтын нәрсе |
|---|---|
| Не екені | Модель қай функцияны қандай аргументтермен шақыру керегін сипаттайтын құрылымдалған JSON шығарады — функцияны өзі орындамайды |
| Ағымдағы API беткейі | tools және tool_choice қолданыңыз; ескі functions және function_call параметрлері ескіртілген |
| Strict режимі | Схемаға сәйкестікті мәжбүрлеу үшін функция анықтамаларында әрдайым strict: true орнатыңыз |
| Параллель шақыру | 2023 қарашасынан кейінгі модельдерде қолдау бар; бір сұрау бірнеше құрал шақыруын триггерлей алады |
| Токен құны | Функция схемалары кіріс токендерін тұтынады; ашылған функциялар санын азайтыңыз |
| Қауіпсіздік | Барлық функция шақыруларын валидациялаңыз; сенімсіз сыртқы контенттің тікелей құрал шақыруларын жүргізуіне жол бермеңіз |
| vs. Промпт-инжиниринг | Function calling шығыс құрылымын API деңгейінде мәжбүрлейді; промпт-инжиниринг ішкі ойлауды пішіндейді |
| Растау қадамдары | Нақты әлемдік салдары бар (жазу, жіберу, өшіру) кез келген функция орындалмас бұрын пайдаланушы растауы қажет |
Егер сіз әртүрлі модельдерде function calling-ті сынап көргіңіз келсе — GPT-5.4, claude opus 4.7, gemini 3.1 pro — әр провайдер үшін бөлек API тіркелгілерін ұстамай-ақ, CometAPI олардың бәріне бір ғана эндпойнт және кілт арқылы қол жеткізу береді, бұл модельаралық тестілеуді айтарлықтай жеңілдетеді.
CometAPI инфрақұрылымдық шығынды шешеді:
✅ 15+ модель бойынша бірізді function calling синтаксисі
✅ Бір API кілті — OpenAI/Anthropic/Google үшін бөлек аккаунттар қажет емес
✅ Автоматты схема трансляциясы — бір рет жазыңыз, барлық жерде тестілеңіз
✅ Енгізін құнын бақылау — модельдер бойынша токен тұтынуын нақты уақытта салыстырыңыз
Тегін кредиттермен тестілеуді бастаңыз → Қол жеткізу