---
x-i18n:
    generated_at: "2026-04-11T15:15:51Z"
    model: gpt-5.4
    provider: openai
    source_hash: 2a8884fc2c304bf96d4675f0c1d1ff781d6dc1ae8c49d92ce08040c9c7709035
    source_path: reference/rich-output-protocol.md
    workflow: 15
---

# بروتوكول الإخراج المنسق

يمكن أن يتضمن إخراج المساعد مجموعة صغيرة من توجيهات التسليم/العرض:

- ‏`MEDIA:` لتسليم المرفقات
- ‏`[[audio_as_voice]]` لتلميحات العرض الصوتي
- ‏`[[reply_to_current]]` / ‏`[[reply_to:<id>]]` لبيانات الرد الوصفية
- ‏`[embed ...]` للعرض المنسق في واجهة التحكم

هذه التوجيهات منفصلة. تظل وسوم `MEDIA:` والرد/الصوت بيانات وصفية للتسليم؛ أما `[embed ...]` فهو مسار العرض المنسق الخاص بالويب فقط.

## ‏`[embed ...]`

‏`[embed ...]` هو صياغة العرض المنسق الوحيدة الموجهة للوكلاء في واجهة التحكم.

مثال ذاتي الإغلاق:

```text
[embed ref="cv_123" title="Status" /]
```

القواعد:

- لم يعد `[view ...]` صالحًا للمخرجات الجديدة.
- تُعرض الشيفرات المختصرة للتضمين في سطح رسالة المساعد فقط.
- لا تُعرض إلا التضمينات المدعومة بعنوان URL. استخدم `ref="..."` أو `url="..."`.
- لا يتم عرض الشيفرات المختصرة المضمنة بصيغة HTML المضمنة على شكل كتلة.
- تقوم واجهة الويب بإزالة الشيفرة المختصرة من النص المرئي وتعرض التضمين ضمنيًا.
- ‏`MEDIA:` ليس اسمًا بديلًا للتضمين، ويجب عدم استخدامه لعرض التضمين المنسق.

## شكل العرض المخزن

كتلة محتوى المساعد المُطبَّعة/المخزنة هي عنصر `canvas` منظم:

```json
{
  "type": "canvas",
  "preview": {
    "kind": "canvas",
    "surface": "assistant_message",
    "render": "url",
    "viewId": "cv_123",
    "url": "/__openclaw__/canvas/documents/cv_123/index.html",
    "title": "Status",
    "preferredHeight": 320
  }
}
```

تستخدم كتل العرض المنسق المخزنة/المعروضة شكل `canvas` هذا مباشرة. لا يتم التعرف على `present_view`.
