Aqbeż għall-kontenut prinċipali
OpenAI

10 ta’ Settembru 2026

ProdottAPI

Nintroduċu l-API tal-Aġenti

Ibni u ħaddem aġenti fil-cloud bil-harness ta’ Codex, immaniġġjat għalkollox minn OpenAI.

Qed jillowdja…

Hekk kif wessajna Codex u ChatGPT għal Work għal miljuni ta’ nies madwar id-dinja, tgħallimna x’hemm bżonn biex aġenti li jaħdmu fit-tul ikunu effettivi fil-prattika. Aġenti utli jeħtieġu harness b’saħħtu li jimmaniġġja l-kuntest, juża l-għodod b’mod effiċjenti u jikkoordina s-subaġenti. Jeħtieġu wkoll infrastruttura li żżommhom jaħdmu b’mod affidabbli għal jiem sħaħ, b’ambjenti fejn jistgħu jaħdmu bil-fajls, iħaddmu kodiċi u jissejvjaw riżultati intermedji.

Illum qed inniedu l-API tal-Aġenti⁠(jinfetaħ f’tieqa ġdida) f’verżjoni beta pubblika, biex l-iżviluppaturi jkollhom aċċess għall-istess harness u infrastruttura li jħaddmu lil Codex permezz ta’ API sempliċi u flessibbli.

X’qed jgħidu l-klijenti tagħna dwar l-API tal-Aġenti

1 minn 8
“B'Agents API, il-punteġġ tal-evalwazzjoni tagħna tela’ minn 0.71 għal 0.85. L-appoġġ għas-sott-aġenti fl-API huwa eċċellenti u ħaffef drastikament il-fluss tax-xogħol tagħna. Qabel kien pjuttost ikkumplikat li nosservaw u norkestraw is-sottoaġenti fis-sistema l-qadima tagħna, iżda l-APIs il-ġodda naqqsulna l-latenza b’erba’ darbiet. Qattajna ħafna żmien nippruvaw nottimizzaw dan u l-flussi tas-sott-aġenti tawna titjib enormi minnufih.”
Jack Weissenberger, CTO, Ciridae

Oħloq aġenti fil-cloud b’sejħa waħda lill-API

Bl-API tal-Aġenti, tista’ toħloq aġent lest għall-produzzjoni b’sejħa waħda lill-API billi tispeċifika l-kompitu, il-mudell, l-għodod u l-ambjent:

JavaScript

1
import OpenAI from "openai";
2

3
const client = new OpenAI();
4

5
const session = await client.beta.agents.sessions.create({
6
agent: {
7
model: "gpt-6-astra",
8
tools: [
9
{
10
type: "mcp",
11
server_label: "observability",
12
transport: {
13
type: "http",
14
server_url: "https://observability.example.com/mcp",
15
},
16
},
17
],
18
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
19
},
20
vault_ids: ["vault_YOUR_VAULT_ID"],
21
environment: {
22
type: "openai_hosted",
23
capability_directories: ["/workspace/capabilities/skills"],
24
},
25
input:
26
"Investigate service-api’s elevated 5xx rate over the last 30 minutes. " +
27
"Delegate deployment, error, and dependency analysis to subagents. " +
28
"Save findings, evidence, and recommended mitigation in /workspace/outputs.",
29
});

OpenAI tospita u żżomm il-harness. Int tagħżel l-ambjent tal-compute tal-aġent: f’sandbox immaniġġjat minn OpenAI, fuq l-infrastruttura tiegħek stess jew ma’ wieħed mis-sħab tagħna li jipprovdu sandboxes. L-API tal-Aġenti tagħtik bażi soda biex tibni aġenti fuq il-harness u l-infrastruttura ottimizzati tagħna, ħalli tkun tista’ tiffoka fuq l-għodod, l-għarfien u l-flussi tax-xogħol li jagħmlu lill-aġent tiegħek uniku.

Applikazzjoni tibgħat kompiti lill-Agents API u tirċievi avvenimenti u riżultati. Agents API tħaddem il-harness immaniġġjat ta’ Codex, tibgħat sejħiet tal-għodod lil sandbox u tirċievi r-riżultati tagħhom. L-applikazzjoni tikkontrolla l-compute ospitat mill-utent.

Agents API tħaddem lill-aġenti tiegħek bl-istess harness u infrastruttura li jħaddmu lil Codex.

Agħżel l-ambjent tal-aġent tiegħek

Tagħbijiet tax-xogħol differenti jeħtieġu għażliet differenti ta’ compute, ħażna u skjerament. L-API tal-Aġenti tħallik tagħżel sandbox adattat għall-applikazzjoni tiegħek.

Qed nissieħbu ma’ fornituri fl-ekosistema⁠(jinfetaħ f’tieqa ġdida), fosthom Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop u Vercel, biex noffru integrazzjonijiet tal-ogħla livell għal firxa ta’ ħtiġijiet:

  • Ambjenti mmaniġġjati għalkollox jew skjeramenti fil-VPC tiegħek

  • Mekkaniżmi speċifiċi għall-ħażna ta’ fajls u sigrieti

  • Konfigurazzjonijiet differenti ta’ CPU, GPU u memorja, bi profili ta’ prestazzjoni, startjar kiesaħ u spiża li jaqblu mal-fluss tax-xogħol tal-kumpanija tiegħek.

Sħab tas-sandbox: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B u DigitalOcean.

Agents API toffri integrazzjonijiet tal-ogħla livell ma’ fornituri popolari fl-ekosistema.

Sandboxes ospitati minn OpenAI

Għall-iżviluppaturi li jixtiequ jibdew malajr u jespandu b’mod effiċjenti, qed inniedu wkoll is-sandbox ospitat minn OpenAI⁠(jinfetaħ f’tieqa ġdida). Dan juża l-istess infrastruttura ta’ sandboxing li tħaddem lil Codex u ChatGPT.

OpenAI tipprovdi u timmaniġġja s-sandbox, u tagħti lill-aġent tiegħek ambjent sigur u effiċjenti biex iħaddem kodiċi, jaħdem bil-fajls u jipproduċi artefatti. Dawn is-sandboxes jistgħu jiġu kkonfigurati b’mod flessibbli bil-fajls, il-pakketti, il-ħiliet u l-plugins tiegħek biex l-aġent ikollu dak kollu li jeħtieġ ħalli jlesti l-kompitu.

Ibni b’harness ta’ Codex li dejjem jevolvi

Biex tieħu vantaġġ minn kapaċitajiet ġodda tal-mudell, spiss ikollok terġa’ taħdem il-harness tiegħek, u b’hekk titlef ħin prezzjuż li tista’ tuża biex ittejjeb l-applikazzjoni. Ma’ kull tnedija ta’ mudell, l-API tal-Aġenti tipprovdi aċċess b’verżjonijiet għal dawn il-kapaċitajiet. Aħna nżommu u ntejbu kontinwament il-harness flimkien mal-mudelli tagħna, biex ngħinu lill-aġenti tiegħek jiksbu prestazzjoni aħjar minn kull aġġornament. Pereżempju, titjib reċenti fil-harness jinkludi:

Żomm l-aġenti jaħdmu tul sessjonijiet twal

Biex nappoġġjaw mudelli li jaħdmu għal sigħat sħaħ, ħloqna sistema ta’ ġestjoni tal-kuntest li tgħin lill-aġenti jżommu informazzjoni rilevanti matul sessjonijiet itwal. L-API tal-Aġenti tikkompatta awtomatikament⁠(jinfetaħ f’tieqa ġdida) il-kuntest preċedenti hekk kif sessjoni toqrob lejn il-limitu tal-kuntest tagħha, filwaqt li tippreserva l-informazzjoni li l-aġent jeħtieġ biex ikompli. L-iżviluppaturi jistgħu jibnu flussi tax-xogħol li jkopru diversi twieqi tal-kuntest mingħajr ma jimplimentaw il-loġika ta’ kompattazzjoni tagħhom stess.

Għin lill-aġenti jużaw aktar għodod b’mod effiċjenti

L-API tal-Aġenti tgħin lill-aġenti jsibu l-għodod it-tajba u jużawhom b’mod effiċjenti. It-tfittxija tal-għodod⁠(jinfetaħ f’tieqa ġdida) tillowdja d-definizzjonijiet rilevanti tal-għodod meta jkunu meħtieġa, u tgħin biex jitnaqqsu l-użu tat-tokens u l-ispejjeż filwaqt li tippreserva l-cache tal-mudell. Ladarba l-għodod ikunu disponibbli, is-sejħiet programmatiċi tal-għodod⁠(jinfetaħ f’tieqa ġdida) jippermettu lill-aġenti jmexxu sejħiet b’mod parallel, jgħaqqdu operazzjonijiet relatati f’sekwenza, u jiffiltraw jew jikkombinaw ir-riżultati fil-kodiċi. B’hekk ikunu jistgħu jipproċessaw volumi kbar ta’ data filwaqt li jġibu lura fil-kuntest ir-riżultati rilevanti biss. L-API tal-Aġenti tappoġġja l-MCP, funzjonijiet personalizzati u għodod inkorporati bħat-tfittxija fuq il-web.

JSON

1
"agent": {
2
"tools": [
3
{
4
"type": "mcp",
5
"server_label": "openai_docs",
6
"transport": {
7
"type": "http",
8
"server_url": "https://developers.openai.com/mcp"
9
}
10
},
11
]
12
}

Ħalli l-aġenti jqassmu x-xogħol b’mod parallel mas-subaġenti

Bl-appoġġ għal diversi aġenti⁠(jinfetaħ f’tieqa ġdida), l-API tal-Aġenti tista’ taqsam kompiti kumplessi f’partijiet indipendenti u tiddelegahom lil subaġenti li jaħdmu b’mod parallel. Kull subaġent iżomm il-kuntest tiegħu stess, u dan jgħinu jibqa’ ffukat fuq il-kompitu assenjat lilu, filwaqt li l-aġent ewlieni jikkoordina x-xogħol tagħhom u jiġbor ir-riżultati flimkien. Dan jista’ jħaffef il-kompiti ta’ riċerka, analiżi u kitba ta’ kodiċi li jibbenefikaw minn xogħol parallel, mingħajr ma jkollok bżonn tibni s-sistema ta’ orkestrazzjoni tiegħek stess.

JSON

1
"agent": {
2
"model": "gpt-6-astra",
3
"multi_agent": {
4
"enabled": true,
5
"max_concurrent_subagents": 3,
6
}
7
}

Pedament b’sors miftuħ

L-API tal-Aġenti titħaddem mill-harness b’sors miftuħ ta’ Codex, u tagħti lill-iżviluppaturi viżibbiltà fuq il-loġika ewlenija li tikkoordina s-sejħiet tal-mudell, l-għodod u l-kuntest. Bl-API tal-Aġenti, OpenAI tħaddem u żżomm dak il-harness, filwaqt li l-iżviluppaturi jistgħu jispezzjonaw il-bażi tal-kodiċi pubblika⁠(jinfetaħ f’tieqa ġdida) tiegħu u jitgħallmu minnha.

Ibda ibni

L-API tal-Aġenti hija disponibbli llum f’verżjoni beta pubblika għall-iżviluppaturi kollha. M’hemm l-ebda tariffa addizzjonali għall-użu tal-API tal-Aġenti — tħallas biss għat-tokens u l-għodod li jużaw l-aġenti tiegħek, kif spjegat fil-paġna tal-prezzijiet⁠(jinfetaħ f’tieqa ġdida) tagħna.

Esplora l- ħarsa ġenerali lejn l-API tal-Aġenti⁠(jinfetaħ f’tieqa ġdida) biex titgħallem aktar, jew segwi l- gwida biex tibda malajr⁠(jinfetaħ f’tieqa ġdida) ħalli tibda u ddaħħal il-harness ta’ Codex fl-aġenti tiegħek stess.

Matul il-verżjoni beta pubblika, se nkomplu ntejbuha malajr abbażi tal-feedback tiegħek hekk kif naħdmu biex nagħmluha disponibbli b’mod ġenerali. Għidilna x’qed jaħdem, fejn qed tiltaqa’ ma’ diffikultajiet u x’għandek bżonn biex tibni u tħaddem l-aġenti tiegħek fil-produzzjoni.

Awtur

OpenAI