Langkau ke kandungan utama
OpenAI

10 September 2026

ProdukAPI

Memperkenalkan API Ejen

Bina dan jalankan ejen awan dengan harnes Codex yang diurus sepenuhnya oleh OpenAI.

Memuat…

Ketika kami memperluas Codex dan ChatGPT untuk Kerja kepada jutaan orang di seluruh dunia, kami telah mempelajari perkara yang diperlukan untuk memastikan ejen jangka panjang berfungsi dengan baik dalam penggunaan sebenar. Ejen yang berguna memerlukan harnes berkuasa yang mengurus konteks, menggunakan alat dengan cekap dan menyelaraskan subejen. Ejen juga memerlukan infrastruktur yang memastikannya berjalan dengan andal selama berhari-hari, dengan persekitaran untuk mengendalikan fail, menjalankan kod dan menyimpan hasil perantaraan.

Hari ini, kami memperkenalkan API Ejen⁠(dibuka dalam tetingkap baru) dalam beta awam, yang menyediakan harnes dan infrastruktur sama yang menguasakan Codex kepada pembangun melalui API yang ringkas dan fleksibel.

Pendapat pelanggan kami tentang API Ejen

1 daripada 8
“Dengan API Ejen, skor penilaian kami meningkat daripada 0.71 kepada 0.85. Sokongan subejen dalam API sangat baik dan mempercepat aliran kerja kami secara mendadak. Sebelum ini, agak rumit untuk memantau dan mengorkestrasi subejen dalam persediaan lama kami, tetapi API baharu mengurangkan kependaman sebanyak 4 kali ganda. Kami mengambil masa yang lama untuk mengoptimumkan perkara ini, dan aliran subejen memberikan peningkatan besar yang tersedia serta-merta.”
Jack Weissenberger, CTO, Ciridae

Bina ejen awan dengan satu panggilan API

Dengan API Ejen, anda boleh mencipta ejen sedia pengeluaran melalui satu panggilan API dengan menentukan tugas, model, alat dan persekitaran:

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 mengehos dan menyelenggarakan harnes tersebut. Anda memilih persekitaran pengkomputeran ejen: dalam medan ujian yang diurus OpenAI, pada infrastruktur anda sendiri atau melalui salah satu rakan kongsi medan ujian kami. API Ejen menyediakan asas kukuh untuk membina ejen berasaskan harnes dan infrastruktur ejen kami yang dioptimumkan, supaya anda boleh menumpukan pada alat, pengetahuan dan aliran kerja yang menjadikan ejen anda unik.

Aplikasi menghantar tugas kepada API Ejen dan menerima peristiwa serta output. API Ejen menjalankan harnes Codex terurus, menghantar panggilan alat kepada medan ujian dan menerima hasil alat. Aplikasi mengawal pengkomputeran yang dihoskan sendiri.

API Ejen menguasakan ejen anda dengan harnes dan infrastruktur sama yang mendasari Codex.

Pilih persekitaran ejen anda

Beban kerja yang berbeza memerlukan pilihan pengkomputeran, storan dan penggunaan yang berbeza. API Ejen membolehkan anda memilih medan ujian yang sesuai dengan aplikasi anda.

Kami bekerjasama dengan penyedia ekosistem⁠(dibuka dalam tetingkap baru), termasuk Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop dan Vercel, untuk menyediakan penyepaduan bertaraf tinggi bagi pelbagai keperluan:

  • Persekitaran terurus sepenuhnya atau penggunaan dalam VPC anda

  • Mekanisme penyimpanan fail dan rahsia yang khusus

  • Konfigurasi CPU, GPU dan memori yang berbeza, dengan profil prestasi, permulaan sejuk dan kos yang sepadan dengan aliran kerja syarikat anda.

Rakan kongsi medan ujian: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B dan DigitalOcean.

API Ejen menawarkan penyepaduan bertaraf tinggi dengan penyedia ekosistem yang popular.

Medan ujian yang dihoskan OpenAI

Bagi pembangun yang mahu bermula dengan cepat dan meningkatkan skala secara cekap, kami turut memperkenalkan medan ujian yang dihoskan OpenAI⁠(dibuka dalam tetingkap baru). Ini memanfaatkan infrastruktur medan ujian sama yang menguasakan Codex dan ChatGPT.

OpenAI menyediakan dan mengurus medan ujian tersebut, sekali gus memberikan ejen anda persekitaran yang selamat dan berprestasi tinggi untuk menjalankan kod, mengendalikan fail dan menghasilkan artifak. Medan ujian ini boleh dikonfigurasikan secara fleksibel dengan fail, pakej, kemahiran dan pemalam anda untuk memberikan segala yang diperlukan oleh ejen bagi menyelesaikan tugas.

Bina dengan harnes Codex yang terus berkembang

Memanfaatkan keupayaan model baharu sering memerlukan anda mengolah semula harnes, sekali gus mengambil masa berharga yang sepatutnya digunakan untuk menambah baik aplikasi. API Ejen menyediakan akses yang mempunyai versi kepada keupayaan ini dengan setiap pelancaran model. Kami menyelenggarakan dan terus menambah baik harnes seiring dengan model kami, bagi membantu ejen anda memperoleh prestasi lebih baik daripada setiap peningkatan. Sebagai contoh, penambahbaikan harnes terkini termasuk:

Pastikan ejen terus bekerja sepanjang sesi yang panjang

Untuk menyokong model yang bekerja selama berjam-jam, kami membina pengurusan konteks yang membantu ejen membawa maklumat berkaitan merentas sesi yang lebih panjang. API Ejen memadatkan secara automatik⁠(dibuka dalam tetingkap baru) konteks terdahulu apabila sesi menghampiri had konteksnya, sambil mengekalkan maklumat yang diperlukan ejen untuk meneruskan tugas. Pembangun boleh membina aliran kerja yang merentasi berbilang tetingkap konteks tanpa melaksanakan logik pemadatan sendiri.

Bantu ejen menggunakan lebih banyak alat dengan cekap

API Ejen membantu ejen mencari alat yang tepat dan menggunakannya dengan cekap. Carian alat⁠(dibuka dalam tetingkap baru) memuatkan definisi alat yang berkaitan apabila diperlukan, sekali gus membantu mengurangkan penggunaan token dan kos sambil mengekalkan cache model. Setelah alat tersedia, panggilan alat secara programatik⁠(dibuka dalam tetingkap baru) membolehkan ejen menjalankan panggilan secara selari, merantaikan operasi berkaitan serta menapis atau menggabungkan hasil dalam kod. Dengan itu, ejen boleh memproses sejumlah besar data sambil membawa hanya hasil yang berkaitan kembali ke dalam konteks. API Ejen menyokong MCP, fungsi tersuai dan alat terbina dalam seperti carian 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
}

Benarkan ejen menjalankan kerja secara selari dengan subejen

Dengan sokongan berbilang ejen⁠(dibuka dalam tetingkap baru), API Ejen boleh memecahkan tugas kompleks kepada bahagian bebas dan menyerahkannya kepada subejen yang bekerja secara selari. Setiap subejen mengekalkan konteksnya sendiri agar dapat terus menumpukan pada tugasan, manakala ejen utama menyelaraskan kerja mereka dan menggabungkan hasilnya. Ini boleh mempercepat tugas penyelidikan, analisis dan pengekodan yang mendapat manfaat daripada kerja selari, tanpa memerlukan anda membina orkestrasi sendiri.

JSON

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

Sebuah yayasan sumber terbuka

API Ejen dikuasakan oleh harnes Codex sumber terbuka, yang memberikan pembangun keterlihatan terhadap logik teras yang menyelaraskan panggilan model, alat dan konteks. Dengan API Ejen, OpenAI mengendalikan dan menyelenggarakan harnes tersebut, manakala pembangun boleh meneliti serta belajar daripada asas kod awamnya⁠(dibuka dalam tetingkap baru).

Mula membina

Agents API tersedia dalam versi beta awam mulai hari ini untuk semua pembangun. Tiada caj tambahan dikenakan untuk penggunaan Agents API – anda hanya dikenakan bayaran untuk token dan alat yang digunakan oleh ejen anda, seperti yang dinyatakan pada halaman harga⁠(dibuka dalam tetingkap baru) kami.

Terokai gambaran keseluruhan Agents API⁠(dibuka dalam tetingkap baru) untuk mengetahui lebih lanjut atau ikuti pengenalan ringkas⁠(dibuka dalam tetingkap baru) untuk bermula dan membawakan harnes di sebalik Codex dalam ejen anda sendiri.

Semasa versi beta umum tersedia, kami akan membuat penambahbaikan dengan pantas berdasarkan maklum balas anda sambil berusaha ke arah ketersediaan umum. Beritahu kami perkara yang berkesan, tempat anda menghadapi kesukaran dan perkara yang anda perlukan untuk membina serta menjalankan ejen anda dalam pengeluaran.

Penulis

OpenAI