U bood nuxurka ugu muhiimsan
OpenAI

Abriil 15, 2026

Badeecad

Horumarka xiga ee Agents SDK

Agents SDK-ga la cusboonaysiiyay wuxuu ka caawiyaa horumariyeyaasha inay dhisaan wakiillo baari kara faylal, socodsiin kara amarro, tafatiri kara koodh, kana shaqayn kara hawlo muddo-dheer ah gudaha deegaan sanduuqeed la xakameeyey.

Soo kacaya…

Waxaan soo bandhigaynaa awoodo cusub oo ku jira Agents SDK kuwaas oo siiya horumariyeyaasha kaabayaal la jaangooyey oo ay fududahay in lagu bilaabo isla markaana si sax ah loogu dhisay noocyada OpenAI: harness u dhalad ahaan ugu habboon nooca oo u oggolaanaya wakiillada inay ka shaqeeyaan faylal iyo qalab kombiyuutar ku yaal, iyo sidoo kale fulin sandbox oo asal ahaan ku dhex-jirta si shaqadaas si ammaan ah loogu socodsiiyo.

Tusaale ahaan, horumariyeyaashu waxay siin karaan wakiil goob shaqo oo la xakameeyey, tilmaamo cad, iyo qalabka uu u baahan yahay si uu caddaymaha u baaro:

Python

1
# pip install "openai-agents>=0.14.0"
2

3
import asyncio
4
import tempfile
5
from pathlib import Path
6

7
from agents import Runner
8
from agents.run import RunConfig
9
from agents.sandbox import Manifest, SandboxAgent, SandboxRunConfig
10
from agents.sandbox.entries import LocalDir
11
from agents.sandbox.sandboxes import UnixLocalSandboxClient
12

13

14
async def main() -> None:
15
    with tempfile.TemporaryDirectory() as tmp:
16
        dataroom = Path(tmp) / "dataroom"
17
        dataroom.mkdir()
18
        (dataroom / "metrics.md").write_text(
19
            """# Annual metrics
20

21
| Year | Revenue | Operating income | Operating cash flow |
22
| --- | ---: | ---: | ---: |
23
| FY2025 | $124.3M | $18.6M | $24.1M |
24
| FY2024 | $98.7M | $12.4M | $17.9M |
25
""",
26
            encoding="utf-8",
27
        )
28

29
        agent = SandboxAgent(
30
            name="Dataroom Analyst",
31
            model="gpt-5.4",
32
            instructions="Answer using only files in data/. Cite source filenames.",
33
            default_manifest=Manifest(entries={"data": LocalDir(src=dataroom)}),
34
        )
35

36
        result = await Runner.run(
37
            agent,
38
            "Compare FY2025 revenue, operating income, and operating cash flow with FY2024.",
39
            run_config=RunConfig(
40
                sandbox=SandboxRunConfig(client=UnixLocalSandboxClient()),
41
            ),
42
        )
43
        print(result.final_output)
44

45

46
if __name__ == "__main__":
47
    asyncio.run(main())
48

Horumariyeyaashu waxay u baahan yihiin wax ka badan noocyada ugu fiican si ay u dhisaan wakiillo waxtar leh—waxay u baahan yihiin nidaamyo taageera sida wakiilladu u baaraan faylalka, u socodsiinayaan amarrada, u qoraan koodhka, uguna sii shaqeeyaan tallaabooyin badan.

Nidaamyada maanta jira waxay la yimaadaan isdhaafsi marka kooxuhu ka gudbayaan prototypes una gudbayaan wax-soo-saar. Qaab-dhismeedyada aan nooc gaar ah ku xirnayn waa dabacsan yihiin laakiin si buuxda uma adeegsadaan awoodaha noocyada ugu casriyeysan; SDK-yada bixiyeyaasha noocyadu way u dhowaan karaan nooca laakiin badanaa ma laha aragti ku filan oo ku saabsan harness-ka; API-yada wakiillada la maareeyo waxay fududayn karaan dirista balse waxay xaddidaan halka wakiilladu ka shaqeeyaan iyo sida ay u helaan xog xasaasi ah.

Waa kuwan waxa qaar ka mid ah macaamiishii nala tijaabiyey SDK-ga cusub ay ka yidhaahdeen:

“Agents SDK-ga la cusboonaysiiyay wuxuu naga dhigay mid wax-soo-saar ahaan u suuragelin kara inaan otomaatig ka dhigno socod-shaqo muhiim ah oo diiwaannada caafimaadka ah oo hababkii hore aanay si ku filan la isku hallayn karo ugu maamuli karin. Annaga, farqigu kuma ekayn oo keliya soo saarista metadata saxda ah, balse wuxuu ahaa si sax ah u fahamka xuduudaha la-kulanka kasta ee ku jira diiwaanno dhaadheer oo adag. Sidaas darteed, waxaan si dhakhso leh u fahmi karnaa waxa ku dhacaya bukaan kasta booqasho la siiyay gudaheeda, taas oo ka caawinaysa xubnaha baahidooda daryeel isla markaana hagaajinaysa khibraddooda nala leeyihiin.”
— Oscar Health

Harness awood badan u leh wareegga wakiilka

Sii-daynta maanta, harness-ka Agents SDK wuxuu noqday mid awood badan u leh wakiillada la shaqeeya dukumiintiyada, faylalka, iyo nidaamyada. Hadda wuxuu ku darayaa xasuus la habayn karo, abaabul ka warqaba sandbox-ka, qalab nidaamka faylka oo u eg Codex, iyo isdhexgal la jaangooyey oo lala yeesho aasaasyo ku soo badanaya nidaamyada wakiillada ugu casriyeysan.

Aasaasyadan waxaa ka mid ah isticmaalka qalabka iyada oo loo marayo MCP⁠(ku furmaa daaqad cusub), soo bandhigid tartiib tartiib ah iyada oo loo marayo skills⁠(ku furmaa daaqad cusub), tilmaamo gaar ah iyada oo loo marayo AGENTS.md⁠(ku furmaa daaqad cusub), fulinta koodhka iyadoo la adeegsanayo qalabka shell⁠(ku furmaa daaqad cusub), tafatirka faylalka iyadoo la adeegsanayo qalabka apply patch⁠(ku furmaa daaqad cusub), iyo kuwo kale. Harness-ku wuxuu sii wadi doonaa inuu waqti ka dib ku daro qaabab iyo aasaasyo wakiilnimo oo cusub, si horumariyeyaashu waqti yar ugu bixiyaan cusboonaysiinta kaabayaasha aasaasiga ah iyo waqti badan caqliga gaar u ah domain-ka ee wakiilladooda waxtarka ka dhiga.

Jaantus muujinaya sida Agent SDK uu ugu xiro gelinta isticmaalaha, noocyada, iyo qalabka si loo dhiso wakiillo AI ah.
Jaantus muujinaya sida loo dhiso wakiillo AI ah iyadoo la adeegsanayo Agent SDK oo leh noocyo, qalab, iyo abaabul.

Harness-ku sidoo kale wuxuu ka caawiyaa horumariyeyaasha inay furaan wax badan oo ka mid ah awoodda nooc ugu casriyeysan isagoo la jaanqaadaya fulinta habka ay noocyadaasi ugu shaqeeyaan si fiican. Taasi waxay wakiillada ka dhigaysaa kuwo u dhow qaabka dabiiciga ah ee hawlgalka nooca, taas oo hagaajinaysa isku-halayn iyo waxqabad hawlo adag—gaar ahaan marka shaqadu tahay mid muddo dheer socota ama la isku dubbaridayo qalab iyo nidaamyo kala duwan.

Intaa waxaa dheer, waxaan ognahay in badeecad kastaa gaar tahay oo ay dhif tahay inay si nadiif ah ugu habboonaato hal qaab. Waxaan u naqshadaynay Agents SDK inay taageerto kala duwanaanshahan. Horumariyeyaashu waxay helaan harness diyaarsan haddana dabacsan—taas oo fududaynaysa inay ku waafajiyaan stack-gooda—oo ay ku jiraan isticmaalka qalabka, xasuusta, iyo deegaanka sandbox-ka.

Fulin sandbox oo asal ah

Agents SDK-ga la cusboonaysiiyay wuxuu si asal ah u taageeraa fulinta sandbox-ka, si wakiilladu ugu shaqeeyaan deegaan kombiyuutar oo la xakameeyey oo leh faylasha, qalabka, iyo ku-tiirsanaanta ay hawshu u baahan tahay.

Wakiillo badan oo waxtar leh waxay u baahan yihiin goob shaqo oo ay ka akhriyi karaan oo ku qori karaan faylal, ku rakibi karaan ku-tiirsanaanta, ku socodsiin karaan koodhka, kuna adeegsan karaan qalab si ammaan ah. Taageerada sandbox-ka ee asaliga ahi waxay siisaa horumariyeyaasha lakabkaas fulinta si toos ah, halkii lagu khasbi lahaa inay iyagu isu geeyaan.

Horumariyeyaashu waxay keensan karaan sandbox-kooda ama waxay adeegsan karaan taageerada ku dhex-jirta ee Blaxel, Cloudflare, Daytona, E2B, Modal, Runloop, iyo Vercel.

Si deegaannadaas looga dhigo kuwo u kala wareegi kara bixiyeyaasha, SDK-gu wuxuu sidoo kale soo bandhigayaa abstraction-ka sharraxaad si loogu qeexo goobta shaqada ee wakiilka. Horumariyeyaashu waxay mount-gareyn karaan faylal maxalli ah, qeexi karaan galalka wax-soo-saarka, isla markaana keeni karaan xog ka timaadda bixiyeyaasha kaydinta oo ay ku jiraan AWS S3, Google Cloud Storage, Azure Blob Storage, iyo Cloudflare R2.

Tani waxay siisaa horumariyeyaasha hab joogto ah oo ay ugu qaabeeyaan deegaanka wakiilka laga bilaabo prototype maxalli ah ilaa dirista wax-soo-saarka. Waxay sidoo kale siisaa nooca goob shaqo oo la saadaalin karo: halka laga helo gelinta, halka lagu qoro wax-soo-saarka, iyo sida shaqada loo habeeyo inta lagu jiro hawl muddo dheer socota.

Astaamo summadeedka Daytona, E2B, Modal, Cloudflare, Vercel, Blaxel, Runloop

Kala saarista harness-ka iyo xisaabinta si loo helo amni, waartaansho, iyo baaxad

Nidaamyada wakiillada waa in loo naqshadeeyaa iyadoo loo qaadanayo isku-dayo prompt-injection iyo xog-baxin. Kala saarista harness-ka iyo xisaabintu waxay ka caawisaa in aqoonsiyada gelitaanku ka fogaadaan deegaanada ay ku shaqaynayaan koodh ay noocyadu soo saareen.

Waxay sidoo kale suuragelisaa fulin waarta. Marka xaaladda wakiilka dibadda loo saaro, luminta konteenarka sandbox-ka micnaheedu ma aha luminta socodsiinta. Iyada oo leh snapshotting iyo rehydration ku dhex-jira, Agents SDK wuxuu soo celin karaa xaaladda wakiilka konteenar cusub oo uu ka sii wadi karaa barta hubinta ee ugu dambeysay haddii deegaanka asalka ahi fashilmo ama dhaco.

Ugu dambayn, waxay ka dhigtaa wakiillada kuwo si ka badan loo ballaadhin karo. Socodsiinta wakiilladu waxay adeegsan karaan hal sandbox ama kuwo badan, waxay kicin karaan sandbox-yo keliya marka loo baahdo, waxay u diri karaan wakiillo-hoosaadyo deegaan go'doonsan, waxayna shaqada ku barbar socodsiin karaan konteenarro kala duwan si loo helo fulin degdeg badan.

Jaantus socod muujinaya sida Agent SDK uu ugu suurageliyo wakiillada AI inay isticmaalaan kheyraad xisaabeed dheeraad ah hawlo ka adag.
Jaantus muujinaya sida wakiillada AI ee lagu dhisay Agent SDK ay u abaabuli karaan nidaamyo xisaabeed kala go'an, taas oo u oggolaanaysa culaysyada shaqadu inay si madax-bannaan u socdaan iyagoo taageeraya hawlo aad u horumarsan.

Qiimeyn iyo helitaan

Awoodahan cusub ee Agents SDK guud ahaan waa u diyaar dhammaan macaamiisha iyada oo loo marayo API-ga waxayna isticmaalaan qiimeynta caadiga ah ee API-ga, taas oo ku salaysan token-yo iyo isticmaalka qalabka.

Maxaa xiga

Inta aan sii wadno horumarinta Agents SDK, waxaan sii ballaarin doonaa waxa horumariyeyaashu ku dhisi karaan, annagoo fududaynayna in wakiillo awood badan leh la geeyo wax-soo-saar iyadoo la adeegsanayo kaabayaal gaar loo dhisay oo yar, isla markaana la ilaalinayo dabacsanaanta iyo xakamaynta ay horumariyeyaashu u baahan yihiin si ay wakiillada ugu waafajiyaan deegaanadooda.

Awoodaha cusub ee harness-ka iyo sandbox-ka waxaa marka hore lagu bilaabayaa Python, iyadoo taageerada TypeScript loo qorsheeyey sii-dayn mustaqbalka ah. Waxaan sidoo kale ka shaqaynaynaa inaan keenno awoodo wakiil oo dheeraad ah, oo ay ku jiraan habka koodhka iyo wakiillo-hoosaadyo, labadaba Python iyo TypeScript.

Intaa waxaa dheer, waxaan rabnaa inaan ka caawinno isu keenista nidaamka deegaanka wakiillada ee ballaaran waqti ka dib, iyadoo la taageerayo bixiyeyaal sandbox oo badan, isdhexgal badan, iyo siyaabo badan oo horumariyeyaashu ugu xiraan SDK-ga qalabka iyo nidaamyada ay horay u isticmaalaan.

Qoraa

OpenAI

Sii wad akhrinta

Eeg dhamaan
Art Card 1080x1080 (3)
Better memory for a more helpful ChatGPT
Dreaming: Better memory for a more helpful ChatGPT

Cilmi-baaris

Rosalind5.5 ArtCard
Introducing new capabilities to GPT-Rosalind

Badeecad

1 1 Art Card
Codex oo loogu talagalay door walba, aalad kasta, iyo habraac shaqo oo walba

Badeecad