تخطي إلى المحتوى الرئيسي
OpenAI

10 سبتمبر 2026

المنتجAPI

نقدّم واجهة برمجة تطبيقات الوكلاء

أنشئ وكلاء سحابيين وشغّلهم باستخدام منظومة تقييم Codex التي تديرها OpenAI بالكامل.

جاري التحميل...

مع توسيع نطاق Codex وChatGPT للعمل ليصلا إلى ملايين الأشخاص حول العالم، تعلّمنا ما يلزم كي يعمل الوكلاء المصممون للمهام الطويلة بكفاءة في الواقع العملي. يحتاج الوكلاء المفيدون إلى منظومة تقييم قوية تدير السياق، وتستخدم الأدوات بكفاءة، وتنسّق عمل الوكلاء الفرعيين. كما يحتاجون إلى بنية تحتية تضمن استمرار عملهم بموثوقية لأيام، وإلى بيئات تتيح لهم التعامل مع الملفات وتشغيل التعليمات البرمجية وحفظ النتائج الوسيطة.

نقدّم اليوم واجهة برمجة تطبيقات الوكلاء⁠(يفتح في نافذة جديدة) في إصدار تجريبي عام، لنتيح للمطورين منظومة التقييم والبنية التحتية نفسيهما اللتين تشغّلان Codex، من خلال واجهة برمجة تطبيقات بسيطة ومرنة.

تستضيف OpenAI منظومة التقييم وتتولى صيانتها. أنت تختار بيئة الحوسبة الخاصة بالوكيل: بيئة معزولة تديرها OpenAI، أو بنيتك التحتية الخاصة، أو بيئة يوفرها أحد شركائنا. توفر لك واجهة برمجة تطبيقات الوكلاء أساسًا قويًا لبناء الوكلاء فوق منظومة التقييم والبنية التحتية المحسّنتين لدينا، كي تركز على الأدوات والمعرفة وتدفقات العمل التي تميّز وكيلك.

«بفضل واجهة برمجة تطبيقات الوكلاء، ارتفعت نتيجة تقييمنا من 0.71 إلى 0.85. دعم الوكلاء الفرعيين في الواجهة ممتاز، وقد سرّع سير عملنا بدرجة كبيرة. في السابق، كانت مراقبة الوكلاء الفرعيين وتنسيقهم ضمن إعدادنا القديم مرهقة للغاية، لكن واجهات برمجة التطبيقات الجديدة خفّضت زمن الاستجابة بمقدار أربعة أضعاف. أمضينا وقتًا طويلًا في محاولة تحسين ذلك، وقد حققت تدفقات الوكلاء الفرعيين دفعة هائلة فور استخدامها».
جاك وايسنبرغر، الرئيس التنفيذي للتكنولوجيا، Ciridae
يرسل تطبيق المهام إلى واجهة برمجة تطبيقات الوكلاء ويتلقى الأحداث والمخرجات. تشغّل واجهة برمجة تطبيقات الوكلاء منظومة تقييم Codex المُدارة، فترسل استدعاءات الأدوات إلى بيئة معزولة وتتلقى نتائجها. يتحكم التطبيق في موارد الحوسبة ذاتية الاستضافة.

تزوّد واجهة برمجة تطبيقات الوكلاء وكلاءك بمنظومة التقييم والبنية التحتية نفسيهما اللتين تقفان وراء Codex.

أنشئ وكلاء سحابيين باستدعاء واحد لواجهة برمجة التطبيقات

باستخدام واجهة برمجة تطبيقات الوكلاء، يمكنك إنشاء وكيل جاهز للإنتاج باستدعاء واحد لواجهة برمجة التطبيقات، وذلك بتحديد المهمة والنموذج والأدوات والبيئة:

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

آراء عملائنا في واجهة برمجة تطبيقات الوكلاء

1 من 8
«بفضل واجهة برمجة تطبيقات الوكلاء، ارتفعت نتيجة تقييمنا من 0.71 إلى 0.85. دعم الوكلاء الفرعيين في الواجهة ممتاز، وقد سرّع سير عملنا بدرجة كبيرة. في السابق، كانت مراقبة الوكلاء الفرعيين وتنسيقهم ضمن إعدادنا القديم مرهقة للغاية، لكن واجهات برمجة التطبيقات الجديدة خفّضت زمن الاستجابة بمقدار أربعة أضعاف. أمضينا وقتًا طويلًا في محاولة تحسين ذلك، وقد حققت تدفقات الوكلاء الفرعيين دفعة هائلة فور استخدامها».
جاك وايسنبرغر، الرئيس التنفيذي للتكنولوجيا، Ciridae

اختر بيئة وكيلك

تحتاج أعباء العمل المختلفة إلى خيارات مختلفة للحوسبة والتخزين والنشر. تتيح لك واجهة برمجة تطبيقات الوكلاء اختيار بيئة معزولة تناسب تطبيقك.

نعقد شراكات مع مزودي منظومتنا التقنية⁠(يفتح في نافذة جديدة)، ومنهم Blaxel وCloudflare وDaytona وDigitalOcean وE2B وModal وOracle وRunloop وVercel، لتوفير عمليات تكامل رائدة تلبي احتياجات متنوعة:

  • بيئات مُدارة بالكامل أو عمليات نشر داخل شبكتك السحابية الخاصة VPC
  • آليات محددة لتخزين الملفات والأسرار
  • تكوينات مختلفة لوحدات المعالجة المركزية CPU ومعالجات الرسومات GPU والذاكرة، مع خيارات أداء وبدء تشغيل بارد وتكلفة تلائم سير عمل شركتك.
شركاء البيئات المعزولة: Modal وCloudflare وDaytona وBlaxel وRunloop وVercel وOracle وE2B وDigitalOcean.

توفر واجهة برمجة تطبيقات الوكلاء عمليات تكامل رائدة مع مزودي المنظومة التقنية الشائعين.

بيئات معزولة تستضيفها OpenAI

وللمطورين الراغبين في البدء بسرعة والتوسع بكفاءة، نقدّم أيضًا بيئة معزولة تستضيفها OpenAI⁠(يفتح في نافذة جديدة). وتستفيد هذه البيئة من بنية العزل التحتية نفسها التي تشغّل Codex وChatGPT.

تجهّز OpenAI البيئة المعزولة وتديرها، ما يمنح وكيلك بيئة آمنة وعالية الأداء لتشغيل التعليمات البرمجية والتعامل مع الملفات وإنتاج المخرجات. يمكن تهيئة هذه البيئات المعزولة بمرونة باستخدام ملفاتك وحزمك ومهاراتك ومكوناتك الإضافية، لتزويد الوكيل بما يحتاج إليه لإتمام المهمة.

طوّر باستخدام منظومة تقييم Codex المتجددة

غالبًا ما تتطلب الاستفادة من إمكانات النماذج الجديدة إعادة تصميم منظومة التقييم، ما يستهلك وقتًا ثمينًا كان يمكن تخصيصه لتحسين تطبيقك. توفر واجهة برمجة تطبيقات الوكلاء وصولًا محدد الإصدارات إلى هذه الإمكانات مع كل إطلاق لنموذج جديد. نصون منظومة التقييم ونحسّنها باستمرار بالتوازي مع نماذجنا، لمساعدة وكلائك على تحقيق أداء أفضل مع كل ترقية. تشمل التحسينات الحديثة لمنظومة التقييم، على سبيل المثال:

حافظ على عمل الوكلاء عبر الجلسات الطويلة

لدعم النماذج التي تعمل لساعات، أنشأنا نظامًا لإدارة السياق يساعد الوكلاء على الاحتفاظ بالمعلومات ذات الصلة عبر الجلسات الأطول. تعمل واجهة برمجة تطبيقات الوكلاء على تكثيف السياق تلقائيًا⁠(يفتح في نافذة جديدة) من الأجزاء السابقة عندما تقترب الجلسة من حد سياقها، مع الاحتفاظ بالمعلومات التي يحتاج إليها الوكيل للمتابعة. يمكن للمطورين إنشاء تدفقات عمل تمتد عبر نطاقات سياق متعددة من دون تنفيذ منطق خاص بهم لتكثيف السياق.

ساعد الوكلاء على استخدام مزيد من الأدوات بكفاءة

تساعد واجهة برمجة تطبيقات الوكلاء الوكلاء على العثور على الأدوات المناسبة واستخدامها بكفاءة. يحمّل البحث عن الأدوات⁠(يفتح في نافذة جديدة) تعريفات الأدوات ذات الصلة عند الحاجة، ما يساعد على خفض استخدام الرموز والتكلفة مع الحفاظ على ذاكرة النموذج المؤقتة. بعد إتاحة الأدوات، يسمح الاستدعاء البرمجي للأدوات⁠(يفتح في نافذة جديدة) للوكلاء بتنفيذ الاستدعاءات بالتوازي، وتسلسل العمليات المترابطة، وتصفية النتائج أو دمجها برمجيًا، ما يمكّنهم من معالجة كميات كبيرة من البيانات مع إعادة النتائج ذات الصلة فقط إلى السياق. تدعم واجهة برمجة تطبيقات الوكلاء بروتوكول 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
}

مكّن الوكلاء من تنفيذ العمل بالتوازي عبر وكلاء فرعيين

بفضل دعم الوكلاء المتعددين⁠(يفتح في نافذة جديدة)، تستطيع واجهة برمجة تطبيقات الوكلاء تقسيم المهام المعقدة إلى أجزاء مستقلة وتفويضها إلى وكلاء فرعيين يعملون بالتوازي. يحتفظ كل وكيل فرعي بسياقه الخاص، ما يساعده على التركيز في مهمته، بينما ينسّق الوكيل الرئيسي عملهم ويجمع النتائج. يمكن لذلك تسريع مهام البحث والتحليل والبرمجة التي تستفيد من العمل المتوازي، من دون أن تضطر إلى إنشاء نظام التنسيق الخاص بك.

JSON

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

An open-source foundation

The Agents API is powered by the open-source Codex harness, giving developers visibility into the core logic that coordinates model calls, tools, and context. With the Agents API, OpenAI operates and maintains that harness while developers can inspect and learn from its public codebase⁠(يفتح في نافذة جديدة).

Start building

Agents API is available in public beta today to all developers. There are no additional fees for using the Agents API – you simply pay for the tokens and tools your agents use, as outlined on our pricing page⁠(يفتح في نافذة جديدة).

Explore the Agents API overview⁠(يفتح في نافذة جديدة) to learn more, or follow the quickstart⁠(يفتح في نافذة جديدة) to get started and bring the harness behind Codex into your own agents.

During the public beta, we’ll iterate quickly based on your feedback as we work toward general availability. Let us know what’s working, where you’re running into friction, and what you need to build and run your agents in production.

المؤلف

OpenAI

متابعة القراءة

عرض الكل
Now everyone can put data to work — card image
Now everyone can put data to work

المنتج

FinServ Blog - Art Card Texture Square
Introducing ChatGPT for Financial Services

المنتج

GPT-Live-1 API | Green-blue cover | Option 038
Build more natural voice experiences with GPT‑Live‑1 in the API

المنتج