Ruka hadi kwenye maudhui kuu
OpenAI

10 Septemba 2026

ProductAPI

Tunakuletea API ya Mawakala

Unda na uendeshe mawakala wa wingu kwa mazingira ya Codex yanayosimamiwa kikamilifu na OpenAI.

Inapakia…

Kadiri tulivyopanua Codex na ChatGPT for Work hadi kufikia mamilioni ya watu ulimwenguni, tumejifunza kinachohitajika ili mawakala wanaofanya kazi kwa muda mrefu wafanye kazi vizuri katika matumizi halisi. Mawakala wenye manufaa wanahitaji mazingira thabiti ya uendeshaji yanayosimamia muktadha, kutumia zana kwa ufanisi na kuratibu mawakala wasaidizi. Pia wanahitaji miundombinu inayowawezesha kufanya kazi kwa kutegemewa kwa siku kadhaa, katika mazingira wanakoweza kutumia faili, kuendesha msimbo na kuhifadhi matokeo ya kati.

Leo, tunazindua API ya Mawakala(fungua katika dirisha jipya) katika toleo la majaribio la umma, tukiwapatia wasanidi programu mazingira yale yale ya uendeshaji na miundombinu inayoendesha Codex kupitia API rahisi na nyumbufu.

OpenAI hupangisha na kudumisha mazingira ya uendeshaji. Unachagua mazingira ya kompyuta ya wakala: katika mazingira ya majaribio yanayosimamiwa na OpenAI, kwenye miundombinu yako mwenyewe au kupitia mmoja wa washirika wetu wa mazingira ya majaribio. API ya Mawakala hukupa msingi imara wa kuunda mawakala juu ya mazingira yetu yaliyoboreshwa ya uendeshaji na miundombinu, ili uweze kuzingatia zana, maarifa na mitiririko ya kazi inayomtofautisha wakala wako.

Programu hutuma majukumu kwa API ya Mawakala na kupokea matukio na matokeo. API ya Mawakala huendesha mazingira ya Codex yanayosimamiwa, ikituma miito ya zana kwenye mazingira ya majaribio na kupokea matokeo ya zana. Programu hudhibiti kompyuta inayopangishwa na mtumiaji.

API ya Mawakala huwapa mawakala wako mazingira yale yale ya uendeshaji na miundombinu inayotumiwa na Codex.

Unda mawakala wa wingu kwa ombi moja la API

Ukitumia API ya Mawakala, unaweza kuunda wakala aliye tayari kwa matumizi halisi kwa ombi moja la API kwa kubainisha jukumu, muundo, zana na mazingira:

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
});

Maoni ya wateja wetu kuhusu API ya Mawakala

1 kati ya 8
“Kwa API ya Mawakala, alama yetu ya tathmini iliongezeka kutoka 0.71 hadi 0.85. Uwezo wa kutumia mawakala wasaidizi katika API ni bora na umeharakisha sana mtiririko wetu wa kazi. Awali ilikuwa vigumu sana kufuatilia na kuratibu mawakala wasaidizi katika mfumo wetu wa zamani, lakini API mpya zilipunguza muda wa kusubiri kwa mara 4. Tulitumia muda mrefu kujaribu kuboresha hili, na mitiririko ya mawakala wasaidizi ilileta ongezeko kubwa la utendaji mara moja.”
Jack Weissenberger, CTO, Ciridae

Chagua mazingira ya wakala wako

Kazi tofauti huhitaji chaguo tofauti za kompyuta, hifadhi na upelekaji. API ya Mawakala hukuwezesha kuchagua mazingira yanayofaa ya majaribio ya matumizi yako.

Tunashirikiana na watoa huduma katika mfumo huu(fungua katika dirisha jipya), wakiwemo Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop na Vercel, ili kutoa miunganisho ya kiwango cha juu kwa mahitaji mbalimbali:

  • Mazingira yanayosimamiwa kikamilifu au upelekaji ndani ya VPC yako
  • Mbinu mahususi za kuhifadhi faili na siri
  • Mipangilio tofauti ya CPU, GPU na kumbukumbu, yenye viwango vya utendaji, muda wa kuanza kutoka hali tulivu na gharama vinavyolingana na mtiririko wa kazi wa kampuni yako.
Washirika wa mazingira ya majaribio: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B na DigitalOcean.

API ya Mawakala hutoa miunganisho ya kiwango cha juu na watoa huduma maarufu katika mfumo huu.

Mazingira ya majaribio yanayopangishwa na OpenAI

Kwa wasanidi programu wanaotaka kuanza haraka na kupanua kwa ufanisi, pia tunazindua mazingira ya majaribio yanayopangishwa na OpenAI(fungua katika dirisha jipya). Hii hutumia miundombinu ile ile ya mazingira ya majaribio yanayoendesha Codex na ChatGPT.

OpenAI huandaa na kusimamia mazingira ya majaribio, na kumpa wakala wako mazingira salama na yenye utendaji bora ya kuendesha msimbo, kutumia faili na kutengeneza bidhaa za kidijitali. Mazingira haya ya majaribio yanaweza kusanidiwa kwa unyumbufu kwa kutumia faili, vifurushi, ujuzi na programu-jalizi zako ili kumpa wakala anachohitaji kukamilisha jukumu.

Unda ukitumia mazingira ya uendeshaji ya Codex yanayoendelea kuboreshwa

Kutumia uwezo mpya wa muundo mara nyingi huhitaji kurekebisha mazingira yako ya uendeshaji, jambo linalopunguza muda muhimu wa kuboresha programu yako. API ya Mawakala hutoa ufikiaji wenye matoleo kwa uwezo huu kila muundo mpya unapozinduliwa. Tunadumisha na kuboresha mazingira ya uendeshaji daima sambamba na miundo yetu, ili mawakala wako wapate utendaji bora zaidi kwa kila sasisho. Kwa mfano, maboresho ya hivi karibuni katika mazingira ya uendeshaji ni pamoja na:

Wawezeshe mawakala kuendelea kufanya kazi katika vipindi virefu

Ili kusaidia miundo inayofanya kazi kwa saa kadhaa, tumeunda usimamizi wa muktadha unaowasaidia mawakala kubeba taarifa muhimu katika vipindi virefu zaidi. API ya Mawakala hukandamiza muktadha kiotomatiki(fungua katika dirisha jipya) kipindi kinapokaribia kikomo chake cha muktadha, huku ikihifadhi taarifa ambazo wakala anahitaji ili kuendelea. Wasanidi programu wanaweza kuunda mitiririko ya kazi inayovuka madirisha mengi ya muktadha bila kutekeleza mantiki yao wenyewe ya ukandamizaji wa muktadha.

Wasaidie mawakala kutumia zana zaidi kwa ufanisi

API ya Mawakala huwasaidia mawakala kupata zana zinazofaa na kuzitumia kwa ufanisi. Utafutaji wa zana(fungua katika dirisha jipya) hupakia ufafanuzi unaofaa wa zana unapohitajika, hivyo kusaidia kupunguza matumizi ya tokeni na gharama huku ukihifadhi akiba ya muundo. Zana zikishapatikana, uitaji wa zana kupitia programu(fungua katika dirisha jipya) huwawezesha mawakala kutekeleza miito kwa wakati mmoja, kuunganisha shughuli zinazohusiana, na kuchuja au kuunganisha matokeo katika msimbo ili kuchakata data nyingi huku wakirejesha katika muktadha matokeo muhimu pekee. API ya Mawakala inatumia MCP, vitendaji maalum na zana zilizojengewa ndani kama vile utafutaji wa wavuti.

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
}

Wawezeshe mawakala kugawa kazi kwa mawakala wasaidizi

Kwa uwezo wa kutumia mawakala wengi(fungua katika dirisha jipya), API ya Mawakala inaweza kugawanya majukumu tata katika sehemu huru na kuzikabidhi kwa mawakala wasaidizi wanaofanya kazi kwa wakati mmoja. Kila wakala msaidizi hudumisha muktadha wake mwenyewe, jambo linalomsaidia kuzingatia jukumu lake, huku wakala mkuu akiratibu kazi zao na kuunganisha matokeo. Hili linaweza kuharakisha utafiti, uchanganuzi na kazi za kuandika msimbo zinazonufaika na utekelezaji wa wakati mmoja, bila kukuhitaji ujenge mfumo wako mwenyewe wa uratibu.

JSON

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

Jenga juu ya msingi wa programu huria

API ya Mawakala inaendeshwa na mazingira ya uendeshaji ya Codex yenye programu huria, hivyo kuwapa wasanidi programu mwonekano wa mantiki kuu inayoratibu miito ya muundo, zana na muktadha. Kwa API ya Mawakala, OpenAI huendesha na kudumisha mazingira hayo ya uendeshaji, huku wasanidi programu wakiweza kukagua na kujifunza kutoka kwenye msimbo wake wa umma(fungua katika dirisha jipya).

Mwandishi

OpenAI