Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions ar/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,8 +32,9 @@ description: تفاعل مع بياناتك باللغة الطبيعية لتح
- **الإدخال الصوتي**: انقر على زر الميكروفون في مربع الإدخال واسمح بالوصول إلى الميكروفون لبدء التسجيل. أثناء التسجيل، اختر **إنهاء الإدخال الصوتي** أو **تجاهل الإدخال الصوتي**. بعد اختيار الإنهاء، ينسخ Teable التسجيل إلى نص في مربع الإدخال.
- **النموذج**: استخدم قائمة النماذج لاختيار نموذج المحادثة. استخدم نموذجًا أخف للاستعلامات البسيطة أو التنظيف أو إعادة الصياغة، ونموذجًا أقوى للتخطيط المعقد والتحليل عبر الجداول وإنشاء التطبيقات.
- **مستوى الذكاء**: اختر مستوى **الذكاء** بصورة مستقلة في قائمة النماذج. يتحكم هذا المستوى في عمق التفكير؛ وتنتج المستويات الأعلى استدلالًا أشمل.
- **الأسرار**: افتح قائمة **+** واختر **الأسرار** لحفظ مفاتيح API أو غيرها من بيانات الاعتماد لمحادثة الذكاء الاصطناعي. يمكن للمحادثة قراءة هذه القيم بوصفها متغيرات بيئة. القيم المحفوظة مخصصة للكتابة فقط؛ أدخل قيمة جديدة لتحديث سر.
- **عمليات التكامل**: عندما يحتاج الذكاء الاصطناعي إلى الوصول إلى حساب تابع لجهة خارجية، يمكنه عرض بطاقة مثل **ربط Slack** في المحادثة. انقر على **ربط** للتصريح عبر OAuth. انقر على **تخطي** لإلغاء هذا التصريح؛ وسيواصل الذكاء الاصطناعي تنفيذ الأجزاء التي يمكنه إكمالها من دون ذلك الاتصال.
- **أسراري**: افتح **+** ← **المزيد** ← **أسراري** لحفظ مفاتيح API أو غيرها من بيانات الاعتماد في **الإعدادات** ← **التكاملات**. هذه القيم ملك لك، ويمكن لمحادثة الذكاء الاصطناعي قراءتها أثناء التشغيل بوصفها متغيرات بيئة، كما يمكنك منحها لتطبيقات وأتمتة بعينها. راجع [بيانات الاعتماد وعمليات التكامل](/ar/basic/credential).
- **طلبات بيانات الاعتماد**: عندما يحتاج الذكاء الاصطناعي إلى حساب خارجي أو إلى سرّ، يثبّت بطاقة طلب في المحادثة. اختر **ربط حسابي** لتنفيذ تصريح OAuth، أو امنح بيانات اعتماد تملكها بالفعل. وإذا نقرت على **تخطي** فلن تُقدَّم بيانات الاعتماد، ويواصل الذكاء الاصطناعي الأجزاء التي يمكنه إكمالها من دونها.
- **استخراج بيانات الويب**: افتح قائمة **+** واختر **استخراج بيانات الويب**، ثم حدد منصة ونوع بيانات، مثل **الملف الشخصي** على LinkedIn أو **تقييمات المنتج** على Amazon. يملأ Teable التعليمات المناسبة في حقل الإدخال، وما عليك سوى إضافة الرابط أو الكلمة المفتاحية. ويقبل خيار **أي صفحة ويب** رابطًا تلصقه مباشرة.
- **المهارات**: افتح قائمة **+** واختر **المهارات** لاستيراد المهارات أو تمكينها أو تعطيلها أو تجربتها في المحادثة الحالية. عند استيراد مهارة، اختر من يمكنه استخدامها: يحصرها **شخصي** بك، ويتيحها **قاعدة البيانات** للمتعاونين في قاعدة البيانات هذه، وتتيحها **المساحة** للجميع في هذه المساحة. اكتب `/` في مربع الإدخال لاختيار مهارة مفعّلة. لربط نظام خارجي أو ترحيله، راجع [ربط كل شيء وترحيله](/ar/basic/ai/connect-everything).
- **استخدام السياق**: توضح الحلقة المجاورة لمربع الإدخال مقدار ما تستخدمه المحادثة حاليًا من نافذة سياق النموذج. انقر عليها لعرض النسبة المئوية وأعداد الرموز. عندما يمتلئ السياق، يضغط Teable المحادثة؛ ابدأ محادثة جديدة إذا أردت سياقًا جديدًا بدلاً من ذلك.
- **إدارة الملفات**: افتح **+** ← **المزيد** ← **إدارة الملفات** لعرض الملفات في بيئة المحادثة المعزولة الحالية. يمكنك معاينة الملفات المدعومة أو تنزيلها أو حذف الملفات والمجلدات التي لم تعد بحاجة إليها. يجب أن تكون هناك محادثة قبل أن تتمكن من إدارة ملفاتها.
Expand Down Expand Up @@ -283,6 +284,6 @@ Cuppy، يرجى قراءة الذاكرة الخاصة بـ Base ID bsexxxxxxxx
</Accordion>

<Accordion title="أين أضع مفاتيح API لمحادثة الذكاء الاصطناعي؟">
استخدم **+** ← **الأسرار** في إدخال المحادثة. يمكن لمحادثة الذكاء الاصطناعي استخدام هذه القيم أثناء المحادثة من دون وضع النص الصريح في مطالبتك.
استخدم **+** ← **المزيد** ← **أسراري** في إدخال المحادثة. يمكن لمحادثة الذكاء الاصطناعي استخدام هذه القيم أثناء المحادثة من دون وضع النص الصريح في مطالبتك.
</Accordion>
</AccordionGroup>
29 changes: 16 additions & 13 deletions ar/basic/ai/app-builder.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -85,21 +85,24 @@ description: حوّل بياناتك إلى تطبيقات ويب مخصصة ب
- يحل ملف ZIP محل المشروع الحالي. وتُحذف من الإصدار الجديد الملفات التي لم تضمنها فيه.
- إذا احتوى ملف ZIP على مجلد تغليف واحد، يزيل Teable ذلك المجلد. يمكنك ضغط مجلد المشروع الخارجي مباشرةً.
- يجب أن يتضمن المشروع المستورد ملف `package.json` في جذر المشروع.
- يُقرأ ملف `.env` الموجود في جذر ملف ZIP إلى **أسرار** التطبيق. وتُتجاهل صيغ `.env*` الأخرى، مثل `.env.local`.
- تُحفظ المتغيرات المخصصة في ملف `.env` الموجود في جذر ملف ZIP بوصفها أسرارًا لك، وتُمنح للتطبيق بالأسماء نفسها. وتُتجاهل صيغ `.env*` الأخرى، مثل `.env.local`.
</Note>

#### الأسرار
#### بيانات الاعتماد والإعدادات

استخدم **الأسرار** لمفاتيح API وبيانات الاعتماد وقيم التهيئة التي يحتاج إليها تطبيقك أثناء التشغيل. في لوحة محادثة منشئ التطبيقات، افتح قائمة **+** واختر **الأسرار**.
لا تكتب مفاتيح API وبيانات الاعتماد وقيم التهيئة داخل الشيفرة المصدرية. فالتطبيق يستخدم **بيانات اعتمادك أنت**: اتصال OAuth أو سرًّا تحفظه. من لوحة المحادثة في App Builder، افتح **+** **المزيد** ← **بيانات الاعتماد والإعدادات** وامنح التطبيق بيانات اعتماد.

| التفاصيل | السلوك |
| التفصيل | السلوك |
| --- | --- |
| الإتاحة | تتاح أسرار التطبيق في بيئة معاينة التطبيق والتطبيق المنشور |
| الوصول من الشيفرة | يمكن لشيفرة التطبيق من جانب الخادم قراءتها من متغيرات البيئة، مثل `process.env.MY_API_KEY` |
| القيم المحفوظة | تكون قيم الأسرار مخصصة للكتابة فقط بعد حفظها؛ أدخل قيمة جديدة لتحديث إحداها |
| تنسيق الاسم | يجب أن يبدأ **الاسم** بحرف إنجليزي كبير، ويمكن أن يحتوي على أحرف إنجليزية كبيرة وأرقام وشرطات سفلية |
| نطاق الإتاحة | تتوفر بيانات الاعتماد الممنوحة للتطبيق في بيئة المعاينة وفي التطبيق المنشور |
| اسم المتغير | الاسم المستعار الذي تدخله عند المنح؛ يبدأ بحرف كبير ولا يقبل سوى الحروف الكبيرة والأرقام والشرطات السفلية |
| قراءة سرّ | تقرأ الشيفرة من جانب الخادم متغيرات البيئة مثل `process.env.MY_API_KEY` |
| قراءة اتصال | تستدعي الشيفرة من جانب الخادم `getConnectionToken('ALIAS')` للحصول على رمز وصول |
| القيم المحفوظة | تصبح القيم مخصصة للكتابة فقط بعد الحفظ؛ أدخل قيمة جديدة لاستبدالها |

بعد إضافة قيمة سر أو حذفها أو تغييرها، تستخدم بيئة معاينة التطبيق القيمة الجديدة. ولا يستخدمها التطبيق المنشور إلا بعد إعادة نشره. لا يتطلب تحرير وصف السر وحده إعادة النشر.
بعد إضافة تفويض أو إزالته أو استبدال قيمة بيانات اعتماد، تستخدم بيئة معاينة التطبيق القيمة الجديدة، أما التطبيق المنشور فلا يستخدمها إلا بعد إعادة النشر.

لا يؤدي نسخ تطبيق إلى نسخ بيانات اعتماده: تبقى في اللوحة عناصر نائبة عليها **لم يُربط بعد**، ويضيف زر **ربط بيانات اعتمادي** بياناتك أنت. لإدارة بيانات الاعتماد ومعرفة أماكن استخدامها، راجع [بيانات الاعتماد وعمليات التكامل](/ar/basic/credential).

#### إدارة ملفات التطبيق

Expand Down Expand Up @@ -162,7 +165,7 @@ description: حوّل بياناتك إلى تطبيقات ويب مخصصة ب

### متغيرات البيئة والتطوير المحلي

لا يحتوي المستودع إلا على المصدر. لا يدفع Teable مطلقًا ملفًا يبدأ اسمه بـ `.env`، سواء في جذر المشروع أو مجلد فرعي أو سجل الالتزامات. توجد قيم البيئة ضمن **أسرار** التطبيق ولا تدخل إلى git مطلقًا. يتضمن ملف `.gitignore` في المستودع إدخال `.env*` مسبقًا، لذلك لن تلتزم نسخة محلية به عن طريق الخطأ.
لا يحتوي المستودع إلا على المصدر. لا يدفع Teable مطلقًا ملفًا يبدأ اسمه بـ `.env`، سواء في جذر المشروع أو مجلد فرعي أو سجل الالتزامات. تأتي قيم البيئة من بيانات الاعتماد الممنوحة للتطبيق، وتوجد ضمن **بيانات الاعتماد والإعدادات**، ولا تدخل إلى git مطلقًا. يتضمن ملف `.gitignore` في المستودع إدخال `.env*` مسبقًا، لذلك لن تلتزم نسخة محلية به عن طريق الخطأ.

لتشغيل التطبيق على جهازك:

Expand All @@ -172,13 +175,13 @@ description: حوّل بياناتك إلى تطبيقات ويب مخصصة ب
<Step title="تشغيل التطبيق">شغّل `pnpm dev`.</Step>
</Steps>

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

<Warning>
يمنح سطر `TEABLE_APP_TOKEN` في ذلك الملف حق الوصول إلى بيانات التطبيق، ولذلك لا يمكن نسخه إلا بواسطة الأعضاء الذين يملكون صلاحية تحرير التطبيق. لا تلتزم الملف مطلقًا، ولا تلصقه في مسألة أو طلب سحب.
</Warning>

لإضافة سر أو تغييره، حرر **الأسرار** في Teable بدلاً من الملف المحلي. لا يؤدي الالتزام بملف `.env` إلى GitHub إلى إنشاء سر أو تحديثه. بعد تغيير سر، انسخ المتغيرات مجددًا لتحديث ملف `.env` المحلي.
لإضافة بيانات اعتماد أو استبدالها، استخدم **بيانات الاعتماد والإعدادات** في Teable بدلاً من الملف المحلي. لا يؤدي الالتزام بملف `.env` إلى GitHub إلى إنشاء بيانات اعتماد أو تحديثها. وبعد أي تغيير، انسخ المتغيرات مجددًا لتحديث ملف `.env` المحلي.

### إلغاء ربط المستودع

Expand Down Expand Up @@ -290,7 +293,7 @@ description: حوّل بياناتك إلى تطبيقات ويب مخصصة ب
</Accordion>

<Accordion title="كيف أنزّل شيفرة التطبيق أو أستوردها؟">
انتقل إلى علامة تبويب **الشيفرة** في المحرر، وانقر على قائمة **`...`** في شريط علامات التبويب، ثم اختر **تنزيل الشيفرة** أو **استيراد الشيفرة**. يمكن أن يصل حجم ملفات ZIP المستوردة إلى 20 MB، وهي تحل محل المشروع الحالي؛ لذا ضمّن كل ملف مصدر تريد الاحتفاظ به. يجب أن يتضمن المشروع المستورد ملف `package.json` في الجذر. ويُستورد ملف `.env` في الجذر إلى **أسرار** التطبيق.
انتقل إلى علامة تبويب **الشيفرة** في المحرر، وانقر على قائمة **`...`** في شريط علامات التبويب، ثم اختر **تنزيل الشيفرة** أو **استيراد الشيفرة**. يمكن أن يصل حجم ملفات ZIP المستوردة إلى 20 MB، وهي تحل محل المشروع الحالي؛ لذا ضمّن كل ملف مصدر تريد الاحتفاظ به. يجب أن يتضمن المشروع المستورد ملف `package.json` في الجذر. وتُحفظ المتغيرات المخصصة في ملف `.env` الموجود في الجذر بوصفها أسرارًا لك، وتُمنح للتطبيق بالأسماء نفسها.
</Accordion>

<Accordion title="متى تُطبق إعدادات تسجيل الدخول على التطبيق المباشر؟">
Expand Down
8 changes: 5 additions & 3 deletions ar/basic/automation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,11 +39,13 @@ description: "أنشئ تدفقات عمل مؤتمتة بالذكاء الاص

تُحفظ التغييرات بوصفها مسودة. ويستمر سير العمل النشط في العمل بالإصدار السابق حتى تنقر على **تطبيق التحديث**.

## الأسرار
## بيانات الاعتماد والإعدادات

استخدم **الأسرار** لتخزين مفاتيح API وبيانات الاعتماد والتهيئة التي تحتاج إليها الأتمتة في وقت التشغيل. افتح سير العمل في علامة تبويب التحرير، ثم انقر على **الأسرار** بجوار عناصر التحكم في الاختبار.
تستدعي الأتمتة الخدمات الخارجية ببيانات اعتمادك: اتصال OAuth أو سرّ تحفظه. افتح سير العمل في علامة تبويب التحرير، وانقر على **بيانات الاعتماد والإعدادات** بجوار عناصر التحكم في الاختبار، وامنح هذه الأتمتة بيانات اعتماد، وأعطها **اسم متغير**.

تقتصر الأسرار على الأتمتة الحالية. ويمكن لإجراءات البرامج النصية قراءتها من متغيرات البيئة مثل `process.env.EXTERNAL_API_KEY`. القيم المحفوظة مخصصة للكتابة فقط؛ أدخل قيمة جديدة لتحديث أحد الأسرار.
تقرأ إجراءات البرامج النصية هذا الاسم من متغير بيئة مثل `process.env.EXTERNAL_API_KEY`، أما الإجراءات الأخرى فيمكنها إدراج مرجع عبر **إدراج سرّ** بجوار حقل الإدخال. ولا تُعرض القيم بنص صريح، كما تُخفى في نتائج الاختبار.

أما بيانات الاعتماد نفسها فتُدار في **الإعدادات** ← **التكاملات**؛ راجع [بيانات الاعتماد وعمليات التكامل](/ar/basic/credential).

## سجل التشغيل

Expand Down
Loading