OpenAI
Бұл бет машиналық аударма арқылы жасалған. Түпнұсқа ағылшын мақаласын қараңыз.

OpenAI API ішіндегі функция шақыру

Функция шақыру деген не және ол OpenAI API ішінде қалай жұмыс істейді?

Жаңартылған: 18 days ago

2025 жылғы 11 наурыздағы жағдай бойынша біз жаңа Agents платформамыздың негізгі құрылыс блоктарын шығардық. Толық мәлімет үшін Responses API, Web Search, File Search және Computer Use сияқты Құралдар, сондай-ақ Agents SDK және ондағы Tracing бойынша API құжаттарымызды қараңыз.

Функция шақыру OpenAI модельдерін сыртқы құралдар мен жүйелерге қосуға мүмкіндік береді. Бұл ЖИ көмекшілеріне жаңа мүмкіндіктер беру немесе қолданбаларыңыз бен үлкен тілдік модельдер арасында терең интеграция құру сияқты көптеген мақсатқа пайдалы.

Толығырақ функция шақыру жөніндегі әзірлеуші нұсқаулығынан оқыңыз.

2024 жылдың маусымында біз «Құрылымдалған нәтижелер» мүмкіндігін іске қостық. Қолдау көрсетілетін модельдер мен сұрау конфигурацияларында модель функция шақыруын шығарған кезде, функция анықтамасында strict: true параметрін орнату жасалған аргументтердің берілген схемаға сай болуын қамтамасыз етеді. Ол үшін схема JSON схемасының қолдау көрсетілетін ішкі жиынын пайдаланып, қатаң режим талаптарына сай болуы керек. Қолдау көрсетілмейтін немесе талаптарға сай емес схемалары бар сұраулар қате хабарымен қабылданбайды.

2024 жылдың қазанында біз «Кез келген нәрсені жасау» мүмкіндігін іске қостық. Оның көмегімен әзірлеушілер функцияны сипаттап не оны тікелей енгізіп, сондай-ақ өз кодын қойып, жарамды функция схемасын жасай алады. «Кез келген нәрсені жасау» мүмкіндігі туралы толығырақ анықтама орталығындағы осы мақаладан оқыңыз.

Функция шақыруды қалай қолдана аламын?

Функция шақыру көптеген пайдалану жағдайлары үшін пайдалы, мысалы:

  • Ассистенттерге дерек алуға мүмкіндік беру:

  • Ассистенттерге әрекет жасауға мүмкіндік беру:

  • Ассистенттерге есептеу орындауға мүмкіндік беру:

  • Күрделі жұмыс процестерін құру:

  • өңделмеген мәтінді алып, кейін оны құрылымдалған деректерге түрлендіріп, дерекқорға сақтайтын дерек шығару конвейері.

Функция шақыру бұрын Чат жауаптарын құратын API және Assistants API арасында бөлінген мүмкіндіктерді біріктіретін Responses 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 нысаны болмауына әкелуі мүмкін шеткі жағдайларды анықтап, өңдеуі керек (төменде қараңыз).

Бұл мақала пайдалы болды ма?