پرش به محتوای اصلی
OpenAI

۱۹ شهریور ۱۴۰۵

محصولAPI

معرفی API عامل‌ها

عامل‌های ابری را با چارچوب آزمون Codex، کاملاً تحت مدیریت OpenAI، بسازید و اجرا کنید.

در حال بارگذاری…

با گسترش Codex و ChatGPT Work در دسترس میلیون‌ها نفر در سراسر جهان، آموخته‌ایم که برای عملکرد مؤثر عامل‌های طولانی‌مدت در عمل چه چیزهایی لازم است. عامل‌های مفید به چارچوب آزمونی قدرتمند نیاز دارند که زمینه را مدیریت کند، ابزارها را بهینه به کار گیرد و عامل‌های فرعی را هماهنگ کند. آن‌ها همچنین به زیرساختی نیاز دارند که چندین روز با اطمینان فعال نگهشان دارد و محیط‌هایی فراهم کند تا بتوانند با فایل‌ها کار کنند، کد اجرا کنند و نتایج میانی را ذخیره کنند.

امروز نسخه بتای عمومی API عامل‌ها⁠(در یک پنجره جدید باز می‌شود) را معرفی می‌کنیم؛ یک API ساده و انعطاف‌پذیر که همان چارچوب آزمون و زیرساخت پشتیبان Codex را در اختیار توسعه‌دهندگان قرار می‌دهد.

نظر مشتریان ما درباره API عامل‌ها

1 از 8
«با API عامل‌ها، امتیاز ارزیابی ما از ۰٫۷۱ به ۰٫۸۵ رسید. پشتیبانی API از عامل‌های فرعی عالی است و گردش کار ما را به‌شدت سرعت بخشیده است. پیش‌تر مشاهده و هماهنگ‌سازی عامل‌های فرعی در ساختار قدیمی ما بسیار دشوار بود، اما APIهای جدید تأخیر را چهار برابر کاهش دادند. زمان زیادی را صرف بهینه‌سازی این بخش کرده بودیم و گردش‌های آماده عامل‌های فرعی، پیشرفت چشمگیری برایمان ایجاد کردند.»
جک وایسنبرگر، مدیر ارشد فناوری، 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 هزینهٔ اضافی ندارد؛ شما فقط هزینهٔ توکن‌ها و ابزارهایی را می‌پردازید که عامل های‌تان استفاده می‌کنند، همانطور که در صفحهٔ قیمت گذاری⁠(در یک پنجره جدید باز می‌شود) ما توضیح داده شده است.

برای اطلاعات بیشتر، نمای کلی API عامل‌ها⁠(در یک پنجره جدید باز می‌شود) را بررسی کنید، یا برای شروع و آوردن چارچوب آزمونِ پشتیبان Codex به عامل‌های خود، راهنمای شروع سریع⁠(در یک پنجره جدید باز می‌شود) را دنبال کنید.

در طول بتای عمومی، همزمان با تلاش برای عرضه عمومی، بر اساس بازخورد شما به سرعت تکرار و بهبود خواهیم کرد. به ما بگویید چه چیزهایی خوب کار می‌کنند، در کجا با مشکل مواجه می‌شوید، و برای ساخت و اجرای عامل‌های خود در محیط تولید به چه چیزی نیاز دارید.

نویسنده

OpenAI