> ## 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.

# استخراج البيانات الوصفية بالذكاء الاصطناعي

> كيف تستخدم Truthlocks الذكاء الاصطناعي لتصنيف ووصف المحتوى المحمي الخاص بك تلقائيًا.

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

## كيف يعمل

عند تحميل ملف في صفحة الحماية، يرسل Truthlocks اسم الملف، نوعه، حجمه، ومعاينة (للملفات النصية) أو بيانات EXIF (للصور) إلى نموذج ذكاء اصطناعي. يبقى الملف نفسه في متصفحك — يتم إرسال البيانات الوصفية فقط للتحليل.

**1. تم تحديد الملف**

تقوم بتحديد ملف أو سحبه إلى صفحة الحماية.

**2. البيانات الوصفية المستخرجة**

تقرأ Truthlocks خصائص الملف الأساسية (الاسم، نوع MIME، الحجم) و، حيثما أمكن،
إذا كان ذلك منطبقًا، يستخرج بيانات EXIF من الصور أو معاينة نصية من التعليمات البرمجية و
ملفات المستندات.

**3. تحليل الذكاء الاصطناعي**

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

**4. المراجعة والتعديل**

تظهر الحقول التي تم إنشاؤها بواسطة الذكاء الاصطناعي كاقتراحات. يمكنك تعديل أي حقل قبل
تأكيد حمايتك.

> [!NOTE]
>
> يتم استخراج بيانات التعريف بالذكاء الاصطناعي تلقائيًا ويعمل في الخلفية بمجرد قيامك بذلك
> حدد ملفًا. لديك دائمًا الكلمة الأخيرة — قم بتحرير أو تجاوز أي
> اقتراح قبل الحماية.

## الفئات المدعومة

يصنف الذكاء الاصطناعي محتواك إلى إحدى الفئات التالية بناءً على نوع الملف وتحليل المحتوى:

| الفئة | أنواع الملفات |
| - | - |
| **التصوير الفوتوغرافي** | JPEG، PNG، WebP، TIFF، تنسيقات RAW |
| **الفن الرقمي** | PSD، AI، SVG، Procreate، HEIC |
| **الرمز المصدري** | JS، TS، Python، Go، Rust، Java، C/C++، و30+ لغة أخرى |
| **المستند** | PDF، DOCX، TXT، Markdown، LaTeX |
| **الموسيقى** | MP3، WAV، FLAC، AAC، MIDI |
| **الفيديو** | MP4، MOV، AVI، WebM، MKV |
| **التصميم** | ملفات Figma، Sketch، XD |
| **البيانات** | CSV، JSON، XML، SQL، Parquet |

## حقول البيانات الوصفية التي تم إنشاؤها

ينتج الذكاء الاصطناعي الحقول التالية لكل ملف:

| الحقل | الوصف |
| - | - |
| `category` | فئة المحتوى (انظر الجدول أعلاه) |
| `content_type` | نوع محتوى محدد ضمن الفئة (مثل "تصوير المناظر الطبيعية") |
| `suggested_title` | عنوان مقروء من قبل الإنسان بناءً على اسم الملف ومحتواه |
| `description` | وصف موجز لما يحتويه الملف |
| `tags` | الكلمات المفتاحية ذات الصلة للبحث والاكتشاف |
| `language` | لغة البرمجة (لملفات الكود المصدري) |
| `framework` | الإطار أو المكتبة المكتشفة (لملفات الكود المصدري) |
| `license_hint` | الترخيص المكتشف أو المقترح (إذا كان قابلاً للتحديد) |
| `subject_matter` | الموضوع الأساسي أو موضوع المحتوى |

## ملخصات الإثبات

تتضمن كل شهادة حماية ملخصًا تم إنشاؤه بواسطة الذكاء الاصطناعي يصف ما تم حمايته ومتى. يظهر الملخص في صفحة الإثبات العامة أسفل تفاصيل الشهادة وهو مصمم للمشاركة ومعاينات الروابط.

يتم إنشاء ملخصات الإثبات تلقائيًا عندما يشاهد أي شخص صفحة إثبات. لا تحتاج إلى تكوينها أو تشغيلها.

| التفاصيل | الوصف |
| - | - |
| **المحتوى** | شرح من 2-3 جمل للحماية — ما الذي تم حمايته، وفئته، وتاريخ الحماية |
| **احتياطي** | إذا كان الذكاء الاصطناعي غير متاح، يتم إنشاء ملخص قائم على القالب بدلاً من ذلك بحيث تعرض صفحة الإثبات دائمًا وصفًا قابلاً للقراءة |
| **مؤشر** | تظهر الملخصات التي تم إنشاؤها بواسطة الذكاء الاصطناعي أيقونة بريق صغيرة وملصق "ملخص تم إنشاؤه بواسطة الذكاء الاصطناعي" |
| **التخزين المؤقت** | يتم تخزين الملخصات مؤقتًا لكل صفحة إثبات وإعادة التحقق منها كل خمس دقائق. يرى الزوار اللاحقون الإصدار المخزن مؤقتًا، مما يقلل من زمن الوصول واستخدام الذكاء الاصطناعي |

### كيف يعمل التخزين المؤقت

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

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

> [!NOTE]
>
> يتم تخزين ملخصات الإثبات مؤقتًا وإعادة التحقق منها كل خمس دقائق. يقوم الزائر الأول لصفحة الإثبات بتشغيل إنشاء الملخص، ويرى الزوار اللاحقون النسخة المخزنة مؤقتًا حتى يتم تحديثها. لا تحتاج إلى إدارة التخزين المؤقت بنفسك.

### الملخصات الاحتياطية

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

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

لا تظهر ملخصات القوالب أيقونة اللمعان، لذا يمكنك دائمًا معرفة ما إذا كان الملخص قد تم إنشاؤه بواسطة الذكاء الاصطناعي.

> [!TIP]
>
> تستخدم ملخصات الإثبات فقط البيانات الوصفية التي قدمتها عند حماية المحتوى الخاص بك — العنوان والوصف والفئة والتاريخ. لا يتم الوصول إلى ملفك الأصلي أبدًا.

## اكتشاف التشابه

قبل سك حماية، تتحقق Truthlocks مما إذا كانت تجزئة ملف مماثلة موجودة بالفعل. يمنع هذا الحماية المكررة وينبهك إذا تم تسجيل المحتوى مسبقًا - إما بواسطتك أو بواسطة مستخدم آخر.

إذا تم العثور على تطابق، فسترى تحذيرًا مع تفاصيل حول الحماية الموجودة قبل المتابعة. يتضمن كل تطابق:

* **درجة التشابه** — مدى تطابق المحتوى مع حماية موجودة.
* **المالك** — اسم المستخدم للشخص الذي حمى الأصل.
* **التاريخ** - متى تم إنشاء الحماية الأصلية.
* **علامة التطابق التام** - ما إذا كان تجزئة المحتوى متطابقًا مع سجل موجود.

## استخدام بيانات تعريف الذكاء الاصطناعي مع واجهة برمجة التطبيقات

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

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/consumer/mint \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "content_hash": "e3b0c44298fc1c149afbf4c8...",
    "title": "Sunset at Big Sur",
    "description": "Landscape photograph taken at Pfeiffer Beach",
    "file_name": "sunset-big-sur.jpg",
    "file_size": 4521984,
    "content_type": "landscape photography",
    "category": "photography",
    "tags": ["landscape", "sunset", "california", "beach"],
    "visibility": "public"
  }'
```

> [!TIP]
>
> عند استخدام واجهة برمجة التطبيقات، يمكنك تخطي استخراج الذكاء الاصطناعي وتقديم بيانات التعريف الخاصة بك
> مباشرة. ميزة استخراج الذكاء الاصطناعي متاحة على واجهة الويب و
> يعمل تلقائيًا.

## الخصوصية

يتبع استخراج البيانات الوصفية بالذكاء الاصطناعي نفس نموذج الخصوصية مثل بقية Truthlocks:

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

## الخطوات التالية

> [card] [حماية المحتوى](https://docs.truthlocks.com/guides/content-protection.md)
>
> دليل كامل لحماية المحتوى الخاص بك بشهادات التشفير.

> [card] [بوابة المستهلك](https://docs.truthlocks.com/guides/consumer-portal.md)
>
> إدارة الحماية، وبيانات الاعتماد، والإعدادات من لوحة التحكم الخاصة بك.

> [card] [شارات قابلة للتضمين](https://docs.truthlocks.com/guides/badges.md)
>
> أضف شارات التحقق إلى موقع الويب الخاص بك أو ملف README.

> [card] [محفظة عامة](https://docs.truthlocks.com/guides/portfolio.md)
>
> اعرض الأعمال الموثقة على صفحة ملف شخصي عام.


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