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

# ملف

> فهرسة الملفات من محرك محلي أو شبكة

## كيف يعمل

يقوم موصل الملفات بفهرسة الملفات التي رفعها المستخدم. يدعم حاليًا ملفات `.txt`، و `.pdf`، و `.docx`، و `.pptx`، و `.xlsx`، و `.csv`،
و `.md`، و `.mdx`، و `.conf`، و `.log`، و `.json`، و `.tsv`، و `.xml`، و `.yml`، و `.yaml`، و `.eml`، و `.epub`.
يمكنك أيضًا رفع `.zip` يحتوي على هذه الملفات - إذا كانت هناك أنواع ملفات أخرى في الـ zip،
يتم تجاهل أنواع الملفات الأخرى. هناك أيضًا سطر بيانات وصفية اختياري يدعم الروابط ومالكي المستندات،
ووقت التحديث كبيانات وصفية للاسترجاع والإجابة بالذكاء الاصطناعي في Gorbit.

## إضافة البيانات الوصفية

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

* `#GORBIT_METADATA={"link": "<LINK>"}`
* `<!-- GORBIT_METADATA={"link": "<LINK>"} -->`

حيث يتبع GORBIT\_METADATA= ملف json. مفاتيح json الصالحة هي:

* link
* primary\_owners
* secondary\_owners
* doc\_updated\_at
* file\_display\_name

يمكنك أيضًا تضمين أزواج مفتاح/قيمة عشوائية سيتم فهمها على أنها "وسوم".
يمكن استخدام هذه الوسوم بعد ذلك في واجهة المستخدم كفلتر إذا كنت تريد تقييد بحثك / محادثتك للمستندات
التي بها وسوم/وسوم معينة مرفقة

على سبيل المثال:

```
#GORBIT_METADATA={"link": "https://github.com/gorbit-dot-app/gorbit/blob/main/CONTRIBUTING.md", "primary_owners": ["yuhong@gorbit.app", "chris@gorbit.app"], "secondary_owners": ["founders@gorbit.app"], "doc_updated_at": "2023-11-30T13:06:08.589616-08:00", "file_display_name": "Desired File Name!", "tag_of_your_choice": "tag_value"}
```

مثال على ملف كامل:

```
#GORBIT_METADATA={"link": "https://www.gorbit.com/captcha", "file_display_name": "Captcha Setup"}
How to set up captcha
Follow the example below to set up a captcha
like you saw when you visited this page!
By including a captcha, this page is able to
prevent web scrapers from reading it.
```

كما نرى، هناك العديد من صفحات الويب أو الأدوات الداخلية التي لا يمكن كشطها مباشرة.
بالإضافة إلى التعامل مع رفعات الملفات المحلية،
يُقدم موصل الملفات كخيار لهذه الأدوات التي قد يكون لديها APIs للوصول إلى المحتويات.

بدلاً من ذلك، إذا كنت ترفع `.zip` مليئًا بالملفات،
يمكنك تعريف ملف `.gorbit_metadata.json` وتضمينه في جذر ملف zip.
إذا كان هيكل ملف zip الخاص بك يبدو مثل:

```
| file1.txt
| file2.txt
| .gorbit_metadata.json
```

فقد يبدو ملف `.gorbit_metadata.json` الخاص بك مثل:

```json theme={null}
[
  {
    "filename": "file1.txt",
    "link": "<LINK_TO_FILE1>",
    "file_display_name": "<WHAT_YOU_WANT_THE_NAME_OF_FILE1_TO_BE_IN_THE_UI>"},
    "primary_owners": ["<FILE1_OWNER>"],
    // this is an arbitrary tag, can be any key/value pair and can be used in the UI as
    // a filter if you want to constrain your search / conversation to only documents with
    // this tag attached
    "status": "<SOME_STATUS>"
  },
  {
    "filename": "file2.txt",
    "link": "<LINK_TO_FILE2>",
    "file_display_name": "<WHAT_YOU_WANT_THE_NAME_OF_FILE2_TO_BE_IN_THE_UI>"},
    "primary_owners": ["<FILE2_OWNER>"],
    // this is an arbitrary tag, can be any key/value pair and can be used in the UI as
    // a filter if you want to constrain your search / conversation to only documents with
    // this tag attached
    "status": "<SOME_OTHER_STATUS>"
  }
]
```

## الإعداد

### التفويض

* لا تتطلب تدفقات مصادقة خارجية.
* يمكن للمسؤولين رفع الملفات وجعلها متاحة للجميع
* \[قيد العمل] سيتمكن المسؤولون أو المستخدمون العاديون من رفع الملفات عبر موصلات شخصية وجعل
  الوصول إليها متاحًا لأنفسهم فقط.

### الفهرسة

<Steps>
  <Step title="افتح موصل الملفات">
    انتقل إلى لوحة الإدارة وحدد موصل **الملفات**.
  </Step>

  <Step title="رفع الملف">
    حدد ملف `.txt` أو ملف `.zip` وانقر

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/file/FileConnector.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=dcea221358a6f5ab80bbaccf5ae4e6f6" alt="FileConnector" width="835" height="536" data-path="assets/admins/connectors/file/FileConnector.png" />
  </Step>
</Steps>