Галоўная / Артыкулы

OpenAI Agents API: кіраваная абвязка Codex і за што каманда адказвае сама

Agents API ад OpenAI запускае абвязку Codex за вас — з сесіямі, MCP-інструментамі, субагентамі і пясочніцамі. Што застаецца на камандзе: праверка, доступ і даныя.

Выдавец: REACTAPP.TOP7 хв чытання1560 слоў

Крыніцы: OpenAI’s Agents API: The Code You May No Longer Need to Write

Уявіце агента, прызначанага для анаізу бага, які практычна з’яўляецца толькі тады, калі кліент праказвае зноў неудачную запытку. Ён чытае заявку, шукае ў кодзе і выявляе верагодную прычыну. Але потым сітуацыя стае складней: трэба інсталаваць залежнасці, паўтарыць неудачу, пераглянуць другую службу і запрацаваць тэсты. У серэдзіне працэсу колега дадае важлівую дэталь — парадуець толькі старэйшыя кліянты.

У такі момент код, які абрамляе агента, мае багато завад. Ён павінен зберагчы ўсе ранейшыя нараджэнні, прыняць новую дэталь, падтрымваць робочую срэду і сочыць за тым, што насправды было пераглянуце. Адсутнасць з’язку не должна змусіць расследаванне пачынацца значна зноў.

API для агентаў OpenAI прызначана для такіх задач. Яна прысвячае Codex як адмініструваныя служба, пры чым OpenAI абавяраецца сесіямі, оркестрацыяй, складзеннем і вясвоўваннем кантэксту. З тэхнічной точкі зору, большая частка элементаў, якія дапамагаюць агенту працаваць эфектыва, можа стаць часткай платформы, таму командам не трэба ўсё перастраіваць для кожнага застосунку. Гэта таксама змінюе тое, на шта команды павінны ўважна старацца.

Цікавай часткай ёсць сам прыстрой

Мадэль можа вырашыць, што трэба ачыніць файл або запусціць тэст. Але іншы програмны элемент все равно павінен выконаць гэтую дзеяннё, вернуць рэзультат і падготавіць наступны вызов мадэлі. Гэты програмны элемент — гэта прыстрой, а яго задачы расшырваюцца ў меру таго, як заданні становяцца сложнейшымі: кераванне дыялогам, коордынацыя інструментаў, перазбіранне пасля перарываў і дапамога агенту падтрымваць свой ход працы.

API для агентаў дазволяе іншым прыкладненням выкарыстоўваць кераваную версію інструментарыя Codex. Серэд задокументаваных функцыяй — стварэнне падсумку пакананых раней задач для керавання кантэкстам, застосоўванне навыкаў, перадача падзадач іншым агентам і продакцыя сесій. У сабе OpenAI практычна параваняе тры варыянты рэалізацыі:

  • API для агентаў: OpenAI запускае інструментарыя Codex і керуе сесіяй агента.
  • SDK для агентаў: цыкл агента запускаецца ўсерэдыне вашага прыкладнення, таму вы маеце больш строгі контроль над інтэграцыяй і розгортанням.
  • API для адпаведзей: ваша прыкладнае рашэнне працуе з неапранутымі адпаведзямі модэлю і сама праектуе атрыбуты робочага працэсу.

Паколькі API для адказоў таксама мае можлівасці для керавання станам, запісаныя размовы не ўтвараюць чыстай межы. Тое, што дадае API для агентаў, — цэ гэта кераванне сесіямі у поўнай супарадзе з кераваным рэжымам выканання агента. Аднам з тлумачэнняў ёсць тое, што гэта зміняе звычную прымету практычнага выбору: перш чым пісаць новы шар коордынацыі, каманда можа запытацца, насколькі з яго насправды павінна застацца ў ўласнасці каманды.

Адступленне адной з расследаванняў

Возьмем знову баг з павтарным запускам. Паказаны выконвальны лянцюг ёсць працэўнай прыметай, а не аповешчэннем пра сістэму, якая вучылася. Програма ачынае сесію з інструкцыямі, інструментамі і прыдатнай робочай срэдой, пасля чаго прасіць агента відтворыць адказку і ўзяць яе пад чытанне, наводзячы відпаведны код і рэзультаты тэстаў.

Согаўна з дакументацыяю сесіі, тое, што застаецца праз разныя крокі, — гэта настройкі агента, дыялог і ўсе вялікія даныя, які ўжо зберагліся. Крок — гэта адна цыклічная праця. Вхідныя даныя, які прыходзяць, калі сесія неактыўна, пачынаюць новы крок, а даныя, апрацоўваныя пад час актыўной працы, керуюць чыргавым крокам. Прогрэс можна сочыць за дапамогою стрымінгу або webhooks. Чыгункі кліентам старэйшага тыпу дае можлівасць прыўязацца да вялікіх даных існуючага розследавання без неабходнасці стварання новага запіту і перзбірання історыі.

Далей ідуць доказы з трэкера проблем. За дапамогою Model Context Protocol сервер можа запростаць інструменты для пошуку проблем або запрашэння запісаў, а API агентаў выкананае тыя інструменты і адправляе запыты да сервера, таму прыкладнаму програмнаму забезпечэнню не трэба перадаваць кожны з іх окрэма. Адкрыцце тут означае выявленне можлівасцяў на настаўленых серверах. Хтось усё рава павінен наладзіць правыя сістэмы і надаць разумны доступ.

Агент таксама можа раздзеліць працу: адзін падагент можа даследжваць способы рэагавання на праблемы пад час прабоўк, а іншы — пераканацца, як старэйшыя кліенты формуюць запыткі. У дакументацыі да багатага агента опісваюцца окольныя умовы для падагентаў, тады калі главны агент коордынуе і з’едынае ўсе ўтварэннія, якія яны ствараюць. Гэта працюе, калі запыткі ёсць незалежнымі. Аднак, калі обом неабходна правіць адну функцыю, коордынацыя знову стае проблемай, і рэкамендаціі OpenAI чытальна адзначаюць неабходнасць скоордынавання правак у спяльных файлах. Тое, што робіць час выканання такога працэсу значным, — гэта тое, што весь гэты працэс з’едынены адной продовжаючайся працай.

Сесія яшчэ патрэбуе месца для работы

Чытанне проблемы і адкрыцце тэста на ўтварэнне адпаведных сітуацый трэбуе разных рэсурсаў. За дакументацыяй архітэктуры, прыстройство, якое запускае цыкл модэлю і інструментаў, ўскладненая з абставінамі выканання, якая забезпечвае вычыслювальныя магчымасці і файлы за патрэбы. Ваша прыкладна програма адправляе заданні, прыме явы і керуе всімі функцыяльнымі інструментамі, якія яна задаўша. Існуе тры варыянты абставінамі:

  • Няма абставінама ўжоўсё: агент можа вызваць своі настроеныя інструменты, без шэлу і без файлаў рабочага прастору.
  • Хоставанне ад OpenAI: для вас ствараецца і запускаецца песочнік, дзе выкананыяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяяя

    Для пошуку багоў сераўсер павінен маць код, яго залежнасці і настройкі для тэставання. Сесія, якая пам’ятае ход розследавання, не можа компенсаваць відсутнасць пакета чырагоднедоступнага сервісу для тэставання. Іншая разліка таксама мае значэнне. У дасягліх дакументах OpenAI зазначаецца, што сесія можа перазіснаваць дыяльнасць свага сераўсера, а пры самастойнай експаняцыі прыкладнэнне застаецца адпаведальным за вычысленні і файлы. Тое, што пам’ятаецца, што файл для тэставання быў створаны, — гэта не тое ж самае, што ён усё ўсё ў наявнасці, і команды павінны пераканацца ў обох аспектах, перш чым обяцваць без працяў кантынуэўнае веданне працы.

    Зберагчыць працу — гэта не значыць, што яна правільная

    Падазроўваючы, што запуск завершыўся з упэўненым адказам і паспешным тэстам, інжынер усё рава павінен спытацца, чы рэалізаваў той тэст первасны бяг. Можа, ён тэставаў нынешньаго кліента, тады калі баг застаўся ў старым. Можа, агент змяніў тэст так, што той больш не пераглядаў проблемную працэзуру.

    Осё гэта ўскладнюе вопыт прызначэння адпаведнасці. Сервіс часу выканання з’яўляе механізмы для адрабаткі і продажу працы, а команда прылады вялікае, што ляжыць у парадку як падтверджэнне. Для такога расследавання гэта значыць неякосць, якую можна перадаць знову, точную версію коду, якая была пераглянутая, кожную команду, якая была выканана, а таксама яе рэзультат, і ўсі застаючыся сумневы. Гэтыя трэбаванні павінны быць часткай працэсу працы, нават калі платформа адрабоўвае гэты цыкл.

    Компактаванне таксама заслуговае на такую ж увагу. Апূরкненне стыскае пакананую працу ў доступны кантэкст модэлю, але ключовыя рашэнні таксама павінны быць зафіксаваныя ў стойкім запісе, які людзі могу пераглядзець. У гэтым случае „толькі старэйшыя кліенты“ павінны застацца часткай крэтэрыяў парадку задання.

    Аналіз другога агента ёсць корыстным, але яго не трэба плутаць з незалежным парабяраннем. Два агента можу мець аднаковыя няправільныя прыпускі або спалагацца на адныя толькі слабыя доказы. Тэст на відтворэнне, які іншы інжынер можа запусціць знову, ёсць болей надзеяным адказам.

    Установы таксама выкорыстоўваюць тую ж логіку. У рэкамендаціях OpenAI па безпецы сэндбокса сказана, што код, які генеруе агент, можа даць доступ да файлаў, аутантыкацыйных даных і сеткі, якія ёсць доступныя ў яго сераўе, таму ізоляцыя і строгі правіла доступу павінны быць настаўлены спецыяльна. Для гэтага прыкладу дастатнік праваў на расследаванне. Магчымасць адразу пераглядаць неудачныя запыткі недастатнек, каб мець права на змяну даных у працоўнай сеткі.

    Як гэта ацэніць

    Разумныя працэвыканні выкарыстоўваюць адну вялічыну-обмежаную схему работы, напрыклад стварэнне атласа аналізу баго для перагляду. Пораўняйце яе з ныямі падходамі каманды: як часта яна дае можна выкарыстоўваць доказы, сколькі людскага корэктавання яй трэба і насколькі надзеямоўна яя вяртаецца да працы пасля перарыву. Пісачыце аб’ёмныя віткі за кожны прыйняты рэзультат, адтолькі што дзяўнай аналіз можа выклікваць многія вызовы модэляў, інструментаў і падагентаў.

    API адказвае пра логі з сэсіяў, запісы падзеяў, захаваную історыю і можлівасць перагляду выкарыстоўвання токенаў. У дасяглібнай документацыі таксама наводзіцца адно з нынешніх абмежэнняў: адзыскванне трэсаў і засобы для выэкспорту трэсаў з ванэйшных джэральнаў не ўключаныя ў публічную версію beta, што мае значэнне для команд, якія вжываюць готавыя сістэмы манітарынгу. Таксама важна якнайранейша атрыбутыця патрэбаў да дадзэнняў. У адглядзе зазначаецца, што на момент напісання API Agents падтрымліваў размешчэнне дадзэнняў толькі ў Сяродземніх Штатах і не адпавядаў прынцыпу абсалютнага незберагання дадзэнняў, пры чым самастойна адмаштаваны sandbox не скасоўвае гэтага абмежэння.

    Калі гэтыя абмежэнні ўзятыя за прыемныя, падымаецца практычны пытанне: чы рэгульяваны рантайм скасоўвае достатню частку інфраструктурнай працы, каб было правадлежна паверыцца ў яго? Дзеякім камандам паспадобіцца гэты компрэс, а іншыя будуць жадаць кантролю над SDK або саею оркестрацыі.

    Загальныя тэндэнцыяў ёсць позытывныя. Контроль над кантэкстам, запуск коду, коордынацыя агентаў і продактываўка работы сэрцэвыяк выступаюць як спільная інфраструктура, што падтрымлівае думку, што корыстныя агенты залежаць ад сістэм, якія абслужваюць мадэль, настолькі ж, насколькі і ад самай модэлі. Рэзультатам яе вікорыстоўвання ёсць можласць спрамаваць заўсёдышчаны інжынерны час на тое, каб рэзультаты сталі болей надзеянымі. У случае павторных спробаў гэта значыць перадаць наступнаму інжынеру сітуацыю аб бядах, якія ён можа перадаць, і доказы, якія ён можа пераглядзець.

    Гэта адпавядае офіцыйнай дакументацыі OpenAI, пераглянутай 15 сябра 2026 года. Прыклады рабочых практык і рэкамендацыі па ацэнцы ёсць рэзультатамі інжынернага аналізу, а не рэзультатамі тэстаў.

    Спадневанае чытанне

  • GemStuffer: Какі штучныя інтэлектуальныя агенты перэтворылі RubyGems і RubyDoc на шлях атакі — У 2026 году агенты OpenAI публікавалі пад 2 000 пакетаў, запускалі код на серверах падготовкі RubyDoc і скрабавалі веб-сайты брытанскага ураду. Чым гэта было спрычынена, чаму гэта мае значэнне і як зробіць працэс падготовкі болей захішчаным.