> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تنسيق الذكاء الاصطناعي وتنفيذ سير العمل

> فهم تنفيذ سير العمل، وسجلات تتبع MAIP، والنتائج المسجلة، وحدود التكامل الحالية.

لدى Truthlocks واجهتان مختلفتان لسير العمل. اختر الواجهة قبل بناء التكامل؛ تختلف معرفاتها وحمولاتها وسلوك التنفيذ.

| الواجهة | ما تفعله | أين تستخدمها |
| - | - | - |
| محرك سير عمل Console | يشغل رسمًا بيانيًا محفوظًا من خلال عامل Temporal ويسجل خطواته ونتائجه النهائية. | مصمم سير عمل Console وسجل التشغيل. |
| واجهات برمجة تطبيقات تنسيق وسير عمل MAIP | تخزين التعريفات، سجلات تتبع التنفيذ، والأدلة المتعلقة بالوكيل. هذه المسارات لا تبدأ عامل Console Temporal. | مراجع `/v1/orchestrate/...` العامة. |

## تشغيل سير عمل Console

احفظ الرسم البياني في مصمم سير العمل، وراجع اتصالاته، وقم بتشغيله باستخدام بيانات المشغل المقصودة. تعني استجابة التشغيل الناجحة أن Temporal قبل الطلب؛ ولا يعني ذلك أن العمل قد انتهى.

افتح **سجل التشغيل** وقم بتحديث السجل لفحص:

* `pending`: تم حفظ الطلب، ولكن لم يتم تسجيل بدء العامل بعد.
* `running`: سجل العامل بدءه.
* `completed`: اكتملت الخطوات المحددة وتم حفظ النتيجة النهائية.
* `failed`: فشلت عملية خطوة أو سير عمل. افحص الخطوات المسجلة قبل إعادة محاولة الآثار الجانبية.
* `cancelled`: تم ملاحظة الإلغاء وقام العامل بحفظ النتيجة النهائية.

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

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

تُلتقط عمليات التشغيل الجديدة الرسم البياني المحفوظ عند الإطلاق. التعديلات اللاحقة لا تغير هذا التنفيذ. تحتوي النتيجة على إصدار التعريف وملخص SHA-256، ومعرفات التنفيذ الزمني، والطوابع الزمنية، والتكاليف المبلغ عنها بواسطة الخطوات، ومخرجات خطوة JSON. قد لا تحتوي عمليات التشغيل القديمة على هذه المعلومات؛ لا يتم إعادة بنائها أو تزويرها.

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

نتيجة التشغيل هي دليل تشغيلي، وليست حزمة إثبات تشفيرية تلقائيًا. `proof_status: "not_generated"` تعني صراحة أنه لم يتم إنشاء حزمة. لا يثبت تسجيل تكلفة صفرية أن مزودًا خارجيًا لم يفرض أي رسوم.

### خطوة إشعار البريد الإلكتروني

استخدم مستلمًا واحدًا لكل خطوة وقدم نصًا صريحًا:

```json theme={null}
{
  "id": "notify-reviewer",
  "name": "Notify reviewer",
  "type": "notify",
  "config": {
    "channel": "email",
    "recipients": ["reviewer@your-company.example"],
    "subject": "Your review is ready",
    "text_body": "Open your workspace to review the recorded result."
  }
}
```

يُبلغ الناتج عن `provider_accepted` ومعرف رسالة بعد أن يقبل مزود SMTP المُكوّن الرسالة. لا يضمن التسليم إلى صندوق الوارد. لا تدعم هذه النشاطات القوالب المسماة، أو المستلمين المتعددين في خطوة واحدة، أو القنوات غير البريدية. يتم تعطيل عمليات إعادة المحاولة التلقائية لأن SMTP لا يمكنه ضمان التسليم مرة واحدة بالضبط. تحقق من محاولة غير مؤكدة قبل الإرسال مرة أخرى.

### حدود التنفيذ التي يجب أخذها في الاعتبار

* يمكن أن يؤدي انتهاء مهلة التشغيل إلى ترك سجل `pending` حتى لو قبلت Temporal الطلب. تحقق من هذا التشغيل قبل إطلاق آخر؛ تظل تسوية الإرسال الآلي غير مكتملة.
* تستمر خطوات المراجعة البشرية في Console في طلبات الموافقة المعينة. لقد اجتازت قرارات الموافقة/الرفض المصرح بها ونتائجها المؤقتة قبولًا مباشرًا محدد النطاق. لا يشير سجل موافقة وكيل MAIP المنفصل إلى سير عمل Console.
* تستخدم خطوات الذكاء الاصطناعي بوابة Gemini المكونة؛ لقد اجتاز تشغيل Temporal-to-Gemini الاصطناعي قبولًا مباشرًا. تحقق من موجهك الخاص ومتطلبات الإخراج والتكاليف.
* خطوات `tool_call` الخارجية غير متوفرة في وقت تشغيل الموصل المنشور. احتفظ بهذه الرسوم البيانية كمسودات؛ لا يمكن استخدامها لأتمتة أدوات الإنتاج. لا تمكّن حزمة التكامل الخارجي موصل سير العمل.
* يقوم عامل خلفي بتسوية معرفات تنفيذ Temporal المعروفة، بما في ذلك الفشل النهائي والانتقالات المستمرة كجديد. ولا يستنتج التأثيرات الناجحة من التاريخ المفقود، ولا يمكنه استعادة هوية إرسال غير معروفة.
* يتم تحديد تعريفات سير العمل والتشغيل والخطوات والموافقات التي تم إنشاؤها بعد عزل البيئة لنطاق بيئة مساحة العمل المحددة. تظل السجلات التاريخية بدون إسناد بيئي متحقق منه متاحة لإشراف النظام الأساسي؛ لا يتم تعيينها بصمت للإنتاج. لا يتم تأسيس عزل أوسع من جانب المزود واستعادة جميع الآثار الجانبية الخارجية بواسطة حدود التخزين هذه.
* يتم حفظ أحداث تدقيق سير العمل مع تغييرات الحالة. هذا لا يؤسس تصديرًا مكتملًا إلى كل وجهة تدقيق خارجية أو سياسة احتفاظ معتمدة بشكل مستقل.

## تتبع تنفيذ MAIP

توثق [مرجع تنفيذ التنسيق](https://docs.truthlocks.com/ar/api-reference/machine-identity/orchestrations/execute.md) العام `pattern`، `orchestrator_id`، و`agent_ids`. استخدم حقوله الموّلدة والقوائم المنسدلة لعقد الطلب الكامل.

يؤدي استجابة HTTP `201` إلى إنشاء سجل تتبع. حالته الأولية `running` ليست دليلاً على تشغيل الوكلاء أو الأدوات. قم بتنفيذ هذه الإجراءات والإشراف عليها في تطبيقك حتى يتم توصيل منفذ مدعوم.

مرجع تشغيل سير عمل [MAIP](https://docs.truthlocks.com/ar/api-reference/machine-identity/workflows/execute.md) هو مسار منفصل لإنشاء السجلات يتطلب `trigger_agent_id`. لا تستبدل معرفات رسوم Console البيانية أو تفترض أن الجدول الزمني المقدم يسجل جدولًا زمنيًا مؤقتًا.

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

للقرارات البشرية المستقلة بشأن إجراء وكيل مقترح، استخدم [agent approvals](https://docs.truthlocks.com/ar/guides/agent-approvals.md). لا تقوم سجلات الموافقة تلقائيًا بتنفيذ أو استئناف سير العمل.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.