أتمتة سير العمل المتقدمة باستخدام TypeScript و OpenAI Agents SDK

ما الذي نبنيه

في هذا الدليل المحدث لعام 2026، نتجاوز مجرد استدعاءات API التقليدية. سنقوم ببناء نظام أتمتة وكلاء متعدد المهارات (Multi-Skill Agentic Workflow). على عكس الأنظمة القديمة، يستخدم هذا النظام “حزم أدوات الوكلاء” لإدارة الحالة، وتنفيذ مهارات متخصصة، والتعامل مع حلقات اتخاذ القرار المستقلة.

سيظهر هذا المشروع كيف يمكنك تقليل التدخل اليدوي في عمليات CI/CD من خلال السماح للوكلاء بإجراء تحليل معمق للكود وفحوصات أمنية بدقة تقارب الصفر من حيث الخطأ.

الإعداد والتثبيت

تأكد من تثبيت أحدث إصدار من SDK لدعم نماذج الاستدلال (Reasoning Models) لعام 2026.

npm install @openai/agents-sdk@latest typescript ts-node dotenv

قم بتكوين ملف البيئة الخاص بك ليتناسب مع معايير الإنتاج الحالية:

# .env file
OPENAI_API_KEY=your-openai-api-key
OPENAI_ORG_ID=your-org-id
  

الخطوة ١: تهيئة الوكيل بنظام GPT-5

سنقوم بتهيئة الوكيل باستخدام نموذج gpt-5-preview، الذي يدعم “توكنات الاستدلال” المحسنة المطلوبة لتنسيق تدفقات العمل المعقدة.

import { Agent } from '@openai/agents-sdk';
import dotenv from 'dotenv';

dotenv.config();

const agent = new Agent({
  apiKey: process.env.OPENAI_API_KEY,
  model: 'gpt-5-preview', // استخدام قمة تكنولوجيا الاستدلال لعام 2026
  temperature: 0, // ضروري لضمان دقة واستمرارية الأتمتة
});

agent.initialize().then(() => {
  console.log('تمت تهيئة النواة الذكية بنجاح');
}).catch(error => {
  console.error('فشل في تهيئة النواة:', error);
});
  

في هذا الإعداد المحدث، نستخدم temperature: 0 لضمان أن يتبع الوكيل المنطق المحدد المطلوب في بيئات العمل البرمجية الاحترافية.

الخطوة ٢: تعريف المهارات المستقلة

المهارات في إصدار 2026 هي أدوات نمطية “يختار” الوكيل تنفيذها بناءً على سلسلة التفكير الخاصة به.

import { Skill } from '@openai/agents-sdk';

const codeReviewSkill = new Skill({
  name: 'advancedCodeReview',
  description: 'إجراء تحليل معمق للبنية التحتية ومراجعة الأمان.',
  execute: async (context) => {
    console.log('الوكيل يقوم بتحليل الأنماط المعمارية للكود...');
    // هنا يتم الدمج مع أدوات الفحص أو المترجمات
    return { 
      status: 'verified', 
      logicCheck: true, 
      timestamp: new Date().toISOString() 
    };
  }
});

agent.registerSkill(codeReviewSkill);
  

الخطوة ٣: تنسيق سير عمل الوكيل

تدفقات العمل الآن تدعم التفرع الديناميكي. سنبدأ بتنفيذ تسلسلي أساسي.

import { Workflow } from '@openai/agents-sdk';

const deploymentWorkflow = new Workflow({
  name: 'prodDeploymentCheck',
  steps: [
    { 
      skill: codeReviewSkill, 
      input: { repository: 'main-branch-v5' } 
    }
  ]
});

agent.runWorkflow(deploymentWorkflow).then(result => {
  console.log('أكمل الوكيل سير العمل بنجاح:', result);
}).catch(error => {
  console.error('تم قطع سير العمل:', error);
});
  

اختبار الوكيل الذكي

node --loader ts-node/esm index.ts

استخدام مُحمل ESM يضمن التوافق مع أحدث إصدارات Agents SDK. يجب أن ترى الوكيل وهو يبدأ العمل، يحلل “الكود”، ويعيد حالة التحقق بنجاح.

توسيع ذكاء وكيلك

• التكامل مع Muse Spark: اربط الـ SDK الخاص بك بنموذج Muse Spark من ميتا لإجراء مراجعات بصرية لواجهات المستخدم (UI/UX Analysis).
• لوحات تحكم فورية: اربط حدث agent.on('step') بـ WebSockets لمراقبة تفكير الوكيل في الوقت الفعلي.
• التنسيق عبر المنصات: استخدم نفس الـ SDK للتحكم في الوكلاء عبر GitHub و Jira و Slack بشكل متزامن.