نسخة Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# إعداد مهمة متصفح في Agents API باستخدام ميزة تشغيل الكمبيوتر من OpenAI

> دليل يستند إلى الوثائق لإنشاء جلسة متصفح في OpenAI Agents API، ومعالجة طلبات أصول المواقع، والتحقق من النتيجة، ثم حذف الجلسة.

By BIG CHANGE Editorial

Published: 2026-09-30T01:36:49.389Z
Updated: 2026-09-30T01:36:49.389Z
Canonical: https://bigchange.ai/blog/openai-agents-api-computer-use-browser-guide

![Conceptual illustration of a developer viewing a generic public webpage on one desktop display and three browser activity images on another.](https://bigchange.ai/api/media/file/agents-computer-use-browser-review-hero-v1.png)
AI-generated by OpenAI; BIG CHANGE conceptual editorial illustration.

في [ملخص DevDay](https://openai.com/index/devday-2026-recap/) الصادر في 29 سبتمبر، أعلنت OpenAI عن ميزة تشغيل الكمبيوتر في Agents API. ويتناول [دليل إطلاق DevDay](https://bigchange.ai/blog/openai-devday-2026-launches-availability-guide) الإطلاق الأوسع. أما المهمة المباشرة للمطوّر فأضيق من مهمة وكيل متصفح عام: فتح صفحة عامة، وجمع إجابة محددة، وتسجيل ما وصل إليه المتصفح. ويشرح [دليل تشغيل الكمبيوتر](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) من OpenAI، الذي روجع في 30 سبتمبر، هذا المسار عبر جلسة متصفح مستضافة. راجعت BIG CHANGE الوثائق ولم تشغّل واجهة API.

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

## التغيير الأبرز

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

## ابدأ بمفتاح API وجلسة متصفح

يتطلب [دليل البدء السريع لـ Agents API](https://developers.openai.com/api/docs/guides/agents-api/quickstart#prerequisites) من OpenAI مفتاح API للتطبيق ضمن مشروع على OpenAI Platform. ويحدد `api.agents.read` و `api.agents.write` لعمليات الجلسة، و `api.responses.write` لاستدلال النموذج. صدّر المفتاح باسم `OPENAI_API_KEY` في بيئة التطبيق وأبقِه خارج مساحة الوكيل المعزولة. استخدم إصداراً حديثاً من OpenAI SDK يدعم Agents API التجريبية؛ ويستخدم شرح JavaScript في دليل تشغيل الكمبيوتر `openai` و `prompt-sync`. ويتطلب بديل cURL استخدام Bash و `jq` وترويسة `OpenAI-Beta: agents=v1` الصريحة.

يضع إعداد الجلسة الموثق `{ "type": "computer_use" }` ضمن `agent.tools`، ويضبط `environment.type` على `openai_hosted`، ويفعّل `environment.desktop.enabled`. كما يفعّل مثال الصفحة العامة الوصول إلى الشبكة ويضبط `include_screenshots: true` للأداة. يعيد إنشاء الجلسة معرّفاً لطلبات الأحداث والعناصر اللاحقة، لكنه لا يبدأ مهمة المتصفح. احفظ ذلك المعرّف قبل المتابعة. ويطلب مثال الدليل من الوكيل العثور على صفحة البدء السريع لـ Agents API وإرجاع عنوانها وعنوان URL، من دون تسجيل الدخول أو تعديل بيانات الموقع.

## تابع المهمة وحدد المواقع التي يمكنها الوصول إليها

افتح تدفق أحداث الجلسة قبل إرسال مدخلات المهمة كي يتلقى التطبيق الأحداث الأولية. والمدخل الموثق هو `agent.session.input.message`. عندما يشير التدفق إلى `agent.session.requires_action`، استرجع `required_actions` الحالية للجلسة وحدد سجلات `computer_use_approval_request` المعلّقة. وعند ورود طلب `browser_origin_access`، اعرض للمستخدم الأصل المطلوب وأي سبب مذكور. أرسل قراره، سواء كان `approve` أو `deny` أو `cancel`، في صورة `agent.session.input.computer_use_approval_request_result` مع `request_id` المطابق.

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

يلغي شرح الصفحة العامة طلباً منفصلاً من نوع `browser_authentication`. وللمهمة التي تتطلب حساباً [مسار تسجيل دخول](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use#handle-sign-in) خاص بها؛ ولا يشملها هذا الإعداد المخصص للقراءة فقط. وتشير OpenAI أيضاً إلى أن إلغاء طلب الموافقة لا يلغي المهمة. وقبول استجابة الموافقة يعني استلام القرار، لا اكتمال التصفح.

## تحقق من النتيجة، وراجع النشاط، ثم احذف الجلسة

قد يوفر تدفق الأحداث نص الإجابة ضمن `agent.session.turn.output_text.done`. انتظر `agent.session.turn.completed` للجولة الرئيسية، وتعامل مع أحداث الفشل والإلغاء كلٌّ على حدة. وفي المهمة الموثقة، تحقق من أن الإجابة تتضمن فعلاً عنوان صفحة البدء السريع وعنوان URL. ولا يثبت إغلاق التدفق وحده انتهاء الجولة؛ إذ توجه OpenAI المطورين إلى استعادة الجلسة نفسها بعد انقطاع الاتصال أو غموض النتيجة.

تعرض عناصر الجلسة جانباً آخر من عمل المتصفح. وتتضمن عناصر `computer_use_call` عنوان النشاط ومعرّف الجولة والحالة. وعند تفعيل لقطات الشاشة، قد يتضمن العنصر عنوان صورة `computer_screenshot`؛ مع ذلك، لا تعيد بعض العمليات أي صورة. تعرض هذه العناصر عمليات المتصفح، لا حكماً نهائياً على المهمة. راجع العناصر المحفوظة وأي نتيجة أو لقطة تحتاج إليها قبل حذف الجلسة لطلب تنظيف البيئة. وقد تحتوي لقطات الشاشة على معلومات حساسة عن صفحة أو حساب؛ لذلك تنصح الوثائق بقصر الاطلاع عليها على الأشخاص المخولين وعدم وضعها في سجلات التطبيق.

## الوصول والتكلفة قراران منفصلان

تذكر OpenAI في [ملخص DevDay](https://openai.com/index/devday-2026-recap/) أن تشغيل الكمبيوتر متاح عبر API، وكذلك في Codex وChatGPT Work ضمن خطتي Pro 500 وEnterprise. ويتناول هذا الدليل مسار API الذي يتطلب بيانات اعتماد وأذونات Platform. ولا يمنح وصف خطة المنتج حق الوصول إلى API، ولا يشمل رسوم استخدامها.

يذكر [استعراض Agents API](https://developers.openai.com/api/docs/guides/agents-api/overview) أن استخدام النموذج يُحاسب وفق [أسعار API](https://developers.openai.com/api/docs/pricing) الخاصة بالنموذج المحدد، بينما تستخدم مساحات OpenAI المعزولة المستضافة [أسعار الحاويات](https://developers.openai.com/api/docs/pricing#built-in-tools) القياسية. لا تذكر الصفحات التي روجعت رسماً منفصلاً لأداة تشغيل الكمبيوتر؛ لكن ذلك لا يعني أن جلسة المتصفح المستضافة مجانية. تحقق من الأسعار الحالية للنماذج والحاويات قبل وضع ميزانية للتشغيل. تستخدم الأمثلة أساليب API تجريبية قد تتغير. لم تُنشأ لهذه المقالة جلسة API، ولم تُنفذ مهمة متصفح أو عملية SDK.

## المصادر ومراجع إضافية

- [OpenAI، “Computer use”](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use)، اطّلعنا عليه في 30 سبتمبر 2026. المرجع الأساسي لإعداد المتصفح، وأسماء الأحداث، وطلبات الأصل والمصادقة، والتحقق من النتائج، والنشاط والحذف. لم تعرض الصفحة تاريخ نشر.
- [OpenAI، “Agents API quickstart”](https://developers.openai.com/api/docs/guides/agents-api/quickstart)، اطّلعنا عليه في 30 سبتمبر 2026. يحدد أذونات مفاتيح Platform وترويسة beta ومتطلبات SDK؛ أما مثال البرمجة العام فيه فيختلف عن شرح تشغيل الكمبيوتر.
- [OpenAI، “Agents API”](https://developers.openai.com/api/docs/guides/agents-api/overview) و [“OpenAI-hosted sandboxes”](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted)، اطّلعنا عليهما في 30 سبتمبر 2026. تشرحان نموذج الجلسة والفوترة المنفصلة للنموذج والحاوية المستضافة. لم تذكر أي منهما تاريخ نشر.
- [أسعار OpenAI API](https://developers.openai.com/api/docs/pricing)، اطّلعنا عليها في 30 سبتمبر 2026. ينبغي التحقق من الأسعار الحالية للنموذج المحدد والحاوية المستضافة؛ ولا نقدّر هنا تكلفة تشغيل بعينه.
- [OpenAI، “DevDay 2026 Recap”](https://openai.com/index/devday-2026-recap/)، نُشر في 29 سبتمبر 2026. مصدر الإعلان وبيانات OpenAI المنفصلة عن إتاحة الميزة عبر API وضمن خطتي Pro 500 وEnterprise في Codex/ChatGPT Work.

## Sources

- [Computer use | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) — المرجع الأساسي لمهام المتصفح: البيئة المستضافة، وأسماء الأحداث والموافقات، والتحقق من النتيجة، والنشاط، ولقطات الشاشة والحذف. هذه وثائق وليست اختباراً أجرته BIG CHANGE.
- [Agents API quickstart | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/quickstart) — أذونات مفاتيح التطبيقات في Platform، وإعداد SDK، وترويسة beta، ودورة حياة الجلسة. يختلف مثال البرمجة العام عن شرح تشغيل الكمبيوتر.
- [Agents API | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/overview) — يوثق نموذج الجلسة المُدارة والرسوم المنفصلة لاستخدام النموذج وأدوات OpenAI والمساحات المعزولة المستضافة.
- [OpenAI-hosted sandboxes | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted) — يؤكد أسعار الحاويات القياسية لمساحات OpenAI المعزولة المستضافة، والفوترة المنفصلة للنموذج، والحذف لطلب تنظيف البيئة.
- [Pricing | OpenAI API](https://developers.openai.com/api/docs/pricing) — الأسعار الحالية للنماذج والحاويات. لا تذكر الصفحات التي روجعت رسماً مستقلاً لأداة تشغيل الكمبيوتر؛ ولا نقدم تقديراً لكل تشغيل.
- [DevDay 2026 Recap | OpenAI](https://openai.com/index/devday-2026-recap/) — إعلان الشركة عن تشغيل الكمبيوتر في Agents API، وعن الإتاحة المنفصلة عبر API وضمن خطتي Pro 500 وEnterprise في Codex/ChatGPT Work.