Përmbledhje

Agents API është në dispozicion në versionin beta. U mundëson zhvilluesve të ndërtojnë aplikacione me një agjent Codex të menaxhuar nga OpenAI, i cili mund të punojë në disa hapa dhe të vazhdojë në të njëjtin sesion.

Aplikacioni juaj ofron detyrën, mjetet dhe konfigurimin. OpenAI menaxhon sesionin e agjentit dhe bashkërendimin midis modelit dhe mjeteve të tij.

Çfarë mund të bëjë një agjent?

Në varësi të mjeteve dhe mjedisit të tij të ekzekutimit, një agjent mund të ekzekutojë kod, të modifikojë skedarë, të përdorë lidhje MCP dhe të krijojë skedarë për aplikacionin tuaj. Mund të dërgoni udhëzime shtesë ose të vazhdoni me një detyrë tjetër në të njëjtin sesion.

Shihni përmbledhjen e Agents API për funksionalitetet e mbështetura dhe shembuj.

Si të filloj?

1. Krijoni një çelës API për aplikacionin në projektin tuaj në Platformën OpenAI. Jepni lejet api.agents.read dhe api.agents.write për sesionet, si dhe api.responses.write për kërkesat për modelin.

2. Ndiqni udhëzuesin e fillimit të shpejtë për të konfiguruar një agjent, për të krijuar një sesion dhe për të dërguar një detyrë.

3. Ndiqni ngjarjet e sesionit për të shqyrtuar ecurinë dhe rezultatet. Ruani ID-në e sesionit nëse dëshironi ta vazhdoni punën.

Mbajeni çelësin tuaj API jashtë mjedisit të izoluar të agjentit. Kërkesat duhet të përfshijnë fushën e kreut OpenAI-Beta: agents=v1. SDK-të e OpenAI e shtojnë automatikisht këtë fushë të kreut.

A i duhet agjentit tim një mjedis i izoluar?

Zgjidhni mjedisin që i përshtatet detyrës:

• Pa mjedis: Agjenti u përgjigjet pyetjeve ose përdor mjete të jashtme pa pasur nevojë për komanda shell të integruara apo skedarë të hapësirës së punës.

• Mjedis i izoluar i hostuar nga OpenAI: Agjentit i duhet të ekzekutojë skripte ose të punojë me skedarë dhe ju dëshironi që OpenAI të menaxhojë mjedisin e tij të izoluar.

• Mjedis i izoluar i hostuar nga ju: Ju nevojitet infrastruktura, softueri ose rrjeti juaj privat. Aplikacioni juaj menaxhon ciklin e jetës së mjedisit.

Shihni arkitekturën e Agents API për hollësi mbi konfigurimin.

Ku mund ta shqyrtoj një sesion?

Hapni Regjistrat në panelin e Platformës, zgjidhni Agjentët dhe kërkoni ID-në e sesionit. Mund të shqyrtoni ciklet e ndërveprimit, thirrjet e mjeteve dhe aktivitetin e nënagjentëve.

Udhëzuesi për monitorimin shpjegon gjithashtu si të shqyrtoni përdorimin e regjistruar të tokenëve.

Çfarë të bëj nëse ndërpritet lidhja me rrjedhën e ngjarjeve?

Merrni sesionin ekzistues dhe elementet e ruajtura të tij përpara se të provoni sërish. Kjo ju ndihmon të kontrolloni çfarë ka ndodhur përpara se të dërgoni punë të tjera.

Përfundimi i një cikli ndërveprimi nuk do të thotë se çdo mjet ka funksionuar me sukses. Shqyrtoni rezultatin e raportuar. Fakti që një sesion është në pritje nuk vërteton në vetvete se detyra ka përfunduar me sukses.

Si faturohet përdorimi?

Kërkesat për modelin faturohen sipas tarifave të API-së së modelit të zgjedhur. Për mjetet e OpenAI dhe mjediset e izoluara të hostuara nga OpenAI zbatohen tarifat përkatëse të mjeteve dhe kontejnerëve.

Shihni çmimet e API-së për tarifat aktuale.

Si trajtohen të dhënat dhe skedarët e sesionit?

Agents API ruan gjendjen e sesionit, në mënyrë që puna të mund të vazhdojë nga një cikël ndërveprimi në tjetrin. Mund t'i fshini sesionet dhe artefaktet e publikuara kur nuk ju nevojiten më. Ruani çdo skedar që ju nevojitet përpara se të fshini një sesion.

Agents API aktualisht mbështet qëndrimin e të dhënave vetëm në Shtetet e Bashkuara. Nuk e mbështet opsionin Pa mbajtje të dhënash, as kur përdorni një mjedis të izoluar të hostuar nga ju. Shihni dokumentacionin e Agents API për hollësi mbi kontrollin e të dhënave.