مرکزی مواد پر جائیں
OpenAI

۱۰ ستمبر، ۲۰۲۶

پروڈکٹAPI

ایجنٹس API کا تعارف

OpenAI کے مکمل زیر انتظام Codex ہارنیس سے کلاؤڈ ایجنٹس بنائیں اور چلائیں.

لوڈ ہو رہا ہے…

Codex اور کام کے لیے ChatGPT کو دنیا بھر میں لاکھوں لوگوں تک پہنچاتے ہوئے ہم نے سیکھا ہے کہ طویل دورانیے تک چلنے والے ایجنٹس کو عملی طور پر مؤثر بنانے کے لیے کیا درکار ہے. کارآمد ایجنٹس کو ایک طاقتور ہارنیس درکار ہوتا ہے جو سیاق کا انتظام کرے، ٹولز کو مؤثر انداز میں استعمال کرے اور ذیلی ایجنٹس کے درمیان ہم آہنگی پیدا کرے. انہیں ایسا بنیادی ڈھانچہ بھی چاہیے جو کئی دن تک قابل اعتماد انداز میں چلاتا رہے، نیز ایسے ماحول جہاں وہ فائلوں پر کام، کوڈ چلا اور درمیانی نتائج محفوظ کر سکیں.

آج ہم عوامی آزمائشی مرحلے میں ایجنٹس API⁠(نئی ونڈو میں کھلتا ہے) متعارف کرا رہے ہیں، جو ایک سادہ اور لچک دار API کے ذریعے ڈویلپرز کو وہی ہارنیس اور بنیادی ڈھانچہ فراہم کرتا ہے جس پر Codex چلتا ہے.

ایجنٹس API کے بارے میں ہمارے صارفین کی رائے

8 از 1
”ایجنٹس API کے ساتھ ہمارا جائزہ اسکور 0.71 سے بڑھ کر 0.85 ہو گیا. API میں ذیلی ایجنٹس کی معاونت شاندار ہے اور اس نے ہمارے ورک فلو کو بہت تیز کر دیا. پہلے ہمارے پرانے نظام میں ذیلی ایجنٹس کی نگرانی اور تنظیم کاری خاصی دشوار تھی، مگر نئے APIs نے تاخیر چار گنا کم کر دی. ہم نے اسے بہتر بنانے کی کوشش میں کافی وقت صرف کیا تھا، مگر ذیلی ایجنٹ کے تیار شدہ بہاؤ نے فوراً بہت بڑی بہتری فراہم کی.“
جیک وائسنبرگر، چیف ٹیکنالوجی افسر، Ciridae

ایک API کال سے کلاؤڈ ایجنٹس بنائیں

ایجنٹس API کے ذریعے آپ کام، ماڈل، ٹولز اور ماحول کی وضاحت کر کے ایک ہی API کال میں پروڈکشن کے لیے تیار ایجنٹ بنا سکتے ہیں:

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 ہارنیس کی میزبانی اور دیکھ بھال کرتا ہے. آپ ایجنٹ کا کمپیوٹنگ ماحول منتخب کرتے ہیں: OpenAI کے زیر انتظام سینڈ باکس، اپنے بنیادی ڈھانچے یا ہمارے کسی سینڈ باکس شراکت دار کے ساتھ. ایجنٹس API ہمارے بہتر بنائے گئے ایجنٹ ہارنیس اور بنیادی ڈھانچے پر ایجنٹس بنانے کے لیے مضبوط بنیاد فراہم کرتا ہے، تاکہ آپ ان ٹولز، علم اور ورک فلوز پر توجہ دے سکیں جو آپ کے ایجنٹ کو منفرد بناتے ہیں.

ایک ایپلیکیشن ایجنٹس API کو کام بھیجتی ہے اور واقعات اور نتیجہ وصول کرتی ہے. ایجنٹس API زیر انتظام Codex ہارنیس چلاتا ہے، سینڈ باکس کو ٹول کالز بھیجتا اور ٹول کے نتائج وصول کرتا ہے. ایپلیکیشن خود میزبانی والے کمپیوٹنگ وسائل کو کنٹرول کرتی ہے.

ایجنٹس API آپ کے ایجنٹس کو وہی ہارنیس اور بنیادی ڈھانچہ فراہم کرتا ہے جو Codex کے پس پشت ہے.

اپنے ایجنٹ کا ماحول منتخب کریں

مختلف کاموں کے بوجھ کے لیے کمپیوٹنگ، اسٹوریج اور تعیناتی کے مختلف اختیارات درکار ہوتے ہیں. ایجنٹس API آپ کو اپنی ایپلیکیشن کے مطابق سینڈ باکس منتخب کرنے دیتا ہے.

ہم مختلف ضروریات کے لیے اعلیٰ معیار کے انضمام فراہم کرنے کی خاطر Blaxel، Cloudflare، Daytona، DigitalOcean، E2B، Modal، Oracle، Runloop اور Vercel سمیت ماحولیاتی نظام کے فراہم کنندگان سے شراکت کر رہے ہیں⁠(نئی ونڈو میں کھلتا ہے):

  • مکمل طور پر زیر انتظام ماحول یا آپ کے VPC میں تعیناتیاں

  • فائلوں اور خفیہ معلومات کے لیے مخصوص ذخیرہ کاری کے طریقے

  • CPU، GPU اور میموری کی مختلف ترتیبیں، جن کی کارکردگی، ابتدائی آغاز اور لاگت کے خاکے آپ کی کمپنی کے ورک فلو سے مطابقت رکھتے ہیں.

سینڈ باکس شراکت دار: Modal، Cloudflare، Daytona، Blaxel، Runloop، Vercel، Oracle، E2B اور DigitalOcean.

ایجنٹس API مقبول ماحولیاتی نظام کے فراہم کنندگان کے ساتھ اعلیٰ معیار کے انضمام پیش کرتا ہے.

OpenAI کے زیر میزبانی سینڈ باکسز

تیزی سے آغاز اور مؤثر توسیع کے خواہاں ڈویلپرز کے لیے ہم OpenAI کے زیر میزبانی سینڈ باکس⁠(نئی ونڈو میں کھلتا ہے) بھی متعارف کرا رہے ہیں. یہ اسی سینڈ باکس بنیادی ڈھانچے سے فائدہ اٹھاتا ہے جس پر Codex اور ChatGPT چلتے ہیں.

OpenAI سینڈ باکس فراہم کرتا اور اس کا انتظام سنبھالتا ہے، جس سے آپ کے ایجنٹ کو کوڈ چلانے، فائلوں پر کام کرنے اور نمونے تیار کرنے کے لیے محفوظ اور اعلیٰ کارکردگی والا ماحول ملتا ہے. ان سینڈ باکسز کو آپ کی فائلوں، پیکیجز، مہارتوں اور اضافی اجزا کے ساتھ لچک دار انداز میں ترتیب دیا جا سکتا ہے، تاکہ ایجنٹ کو کام مکمل کرنے کے لیے درکار وسائل مل سکیں.

مسلسل بہتر ہوتے Codex ہارنیس کے ساتھ بنائیں

ماڈل کی نئی صلاحیتوں سے فائدہ اٹھانے کے لیے اکثر ہارنیس پر دوبارہ کام کرنا پڑتا ہے، جس سے وہ قیمتی وقت صرف ہوتا ہے جو آپ اپنی ایپلیکیشن بہتر بنانے پر لگا سکتے تھے. ایجنٹس API ہر ماڈل کے اجرا کے ساتھ ان صلاحیتوں تک نسخہ بند رسائی فراہم کرتا ہے. ہم اپنے ماڈلز کے ساتھ ہارنیس کی دیکھ بھال اور مسلسل بہتری کرتے ہیں، تاکہ آپ کے ایجنٹس ہر اپ گریڈ سے بہتر کارکردگی حاصل کر سکیں. مثلاً ہارنیس میں حالیہ بہتریوں میں شامل ہیں:

طویل سیشنز میں ایجنٹس کو فعال رکھیں

ماڈلز کو گھنٹوں کام کرنے کے قابل بنانے کے لیے ہم نے سیاق کے انتظام کا ایسا نظام بنایا ہے جو ایجنٹس کو طویل سیشنز میں متعلقہ معلومات برقرار رکھنے میں مدد دیتا ہے. جب کوئی سیشن اپنی سیاقی حد کے قریب پہنچتا ہے تو ایجنٹس API پہلے کے سیاق کو خودکار طور پر کمپیکٹ کرتا ہے⁠(نئی ونڈو میں کھلتا ہے)، جبکہ ایجنٹ کو آگے بڑھنے کے لیے درکار معلومات محفوظ رہتی ہیں. ڈویلپرز اپنی کمپیکشن منطق نافذ کیے بغیر متعدد سیاق ونڈوز پر محیط ورک فلوز بنا سکتے ہیں.

ایجنٹس کو مزید ٹولز مؤثر انداز میں استعمال کرنے دیں

ایجنٹس API درست ٹولز تلاش کرنے اور انہیں مؤثر انداز میں استعمال کرنے میں ایجنٹس کی مدد کرتا ہے. ٹول کی تلاش⁠(نئی ونڈو میں کھلتا ہے) ضرورت کے مطابق متعلقہ ٹول کی تعریفیں لوڈ کرتی ہے، جس سے ماڈل کا کیش برقرار رکھتے ہوئے ٹوکن کے استعمال اور لاگت میں کمی آتی ہے. ٹولز دستیاب ہونے کے بعد پروگرامی طریقے سے ٹول کالنگ⁠(نئی ونڈو میں کھلتا ہے) ایجنٹس کو کالز متوازی چلانے، متعلقہ کارروائیوں کو سلسلہ وار جوڑنے اور کوڈ میں نتائج چھانٹنے یا یکجا کرنے دیتی ہے، تاکہ وہ بڑی مقدار میں ڈیٹا پر کام کرتے ہوئے صرف متعلقہ نتائج ہی سیاق میں واپس لائیں. ایجنٹس API، MCP، حسب ضرورت افعال اور ویب تلاش جیسے پہلے سے شامل ٹولز کی معاونت کرتا ہے.

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
}

ذیلی ایجنٹس کے ذریعے کام متوازی کرائیں

کثیر ایجنٹ معاونت⁠(نئی ونڈو میں کھلتا ہے) کے ذریعے ایجنٹس API پیچیدہ کاموں کو آزاد حصوں میں تقسیم کر کے انہیں متوازی کام کرنے والے ذیلی ایجنٹس کے سپرد کر سکتا ہے. ہر ذیلی ایجنٹ اپنا سیاق برقرار رکھتا ہے، جس سے وہ اپنی ذمہ داری پر مرکوز رہتا ہے، جبکہ مرکزی ایجنٹ ان کے کام میں ہم آہنگی پیدا کر کے نتائج یکجا کرتا ہے. اس سے متوازی کام سے فائدہ اٹھانے والی تحقیق، تجزیے اور کوڈنگ کی رفتار بڑھ سکتی ہے، اور آپ کو اپنی تنظیم کاری بنانے کی ضرورت نہیں پڑتی.

JSON

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

ایک اوپن سورس فاؤنڈیشن

ایجنٹس API اوپن سورس Codex ہارنیس سے چلتا ہے، جو ڈویلپرز کو ماڈل کالز، ٹولز اور سیاق میں ہم آہنگی پیدا کرنے والی بنیادی منطق دیکھنے کی سہولت دیتا ہے. ایجنٹس API کے ساتھ OpenAI اس ہارنیس کو چلاتا اور برقرار رکھتا ہے، جبکہ ڈویلپرز اس کے عوامی کوڈ بیس⁠(نئی ونڈو میں کھلتا ہے) کا معائنہ کر کے اس سے سیکھ سکتے ہیں.

بنانا شروع کریں

Agents API آج تمام ڈویلپرز کے لیے عوامی بِیٹا میں دستیاب ہے. Agents API استعمال کرنے کی کوئی اضافی فیس نہیں ہے – آپ صرف اپنے ایجنٹس کے استعمال کردہ ٹوکنز اور ٹولز کی ادائیگی کرتے ہیں، جیسا کہ ہمارے قیمتوں کے صفحے⁠(نئی ونڈو میں کھلتا ہے) پر بتایا گیا ہے.

مزید جاننے کے لیے Agents API کا جائزہ⁠(نئی ونڈو میں کھلتا ہے) دیکھیں، یا شروع کرنے اور Codex کے پس پشت ہارنیس کو اپنے ایجنٹس میں لانے کے لیے کوئیک اسٹارٹ⁠(نئی ونڈو میں کھلتا ہے) پر عمل کریں.

عوامی بیٹا کے دوران، ہم عمومی دستیابی کی جانب بڑھتے ہوئے آپ کے فیڈبیک کی بنیاد پر تیزی سے بہتری لاتے رہیں گے. ہمیں بتائیں کہ کیا کام کر رہا ہے، آپ کو کہاں رکاوٹوں کا سامنا ہے اور پروڈکشن میں اپنے ایجنٹس بنانے اور چلانے کے لیے آپ کو کیا درکار ہے.

مصنف

OpenAI