تربط عمليات التكامل Atoms بالأدوات والخدمات التي تستخدمها بالفعل. وبحسب الموصل، يمكن لـ Atoms استخدام معلومات خارجية أثناء مساعدتك في الإنشاء، أو إضافة قدرات إلى تطبيقك المنشور، أو دعم كلا سيرَي العمل.

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

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

قد تختلف الموصلات والإجراءات التي تراها حسب الحساب والإصدار. افتح فهرس الموصلات في Atoms لعرض ما هو متاح لك حاليًا.

حدّد ما الذي يجب أن يفعله الاتصال

قبل ربط خدمة، حدّد أين تحتاج إليها.

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

تدعم بعض الموصلات أكثر من هدف واحد. راجع وصف الموصل والأذونات المطلوبة قبل ربطه.

ربط تكامل

افتح الإعدادات ← الموصلات لاستخدام نقطة الدخول الأساسية. يمكنك أيضًا تحديد اربط أدواتك بـ Atoms من لوحة المعلومات.

قد يتطلب ربط تكامل أو فصله صلاحية مالك مساحة العمل أو وصول مسؤول مخوّل. إذا لم تكن مالكًا أو مسؤولًا وكان عنصر تحكم ما غير متاح، فاطلب من مالك مساحة العمل أو من مسؤول مخوّل.

من لوحة المعلومات

1. افتح لوحة معلومات Atoms.
2. حدّد اربط أدواتك بـ Atoms.
3. اختر الموصل الذي تريد استخدامه. اتبع عنصر التحكم في الاتصال المعروض على بطاقة ذلك الموصل.
4. استخدم عنصر التحكم المعروض لذلك الموصل. إذا فتح لوحة تفاصيل عامة، فحدّد Connect؛ وقد تفتح عمليات التكامل الخاصة بموفري الخدمات تدفق الإعداد أو التفويض الخاص بها.
5. سجّل الدخول إلى الخدمة الخارجية إذا طُلب منك ذلك.
6. راجع الحساب والأذونات، ثم وافق على الاتصال.
7. ارجع إلى Atoms وتأكد من أن الموصل يظهر على أنه متصل. في Chat الذي تريد استخدامه فيه، افتح أداة اختيار الموصلات وفعّل الموصل لذلك Chat.

استخدام تكامل متصل

أخبر Agent بالخدمة التي يجب استخدامها، وضمّن تفاصيل كافية لتحديد العنصر الصحيح. تشمل التفاصيل المفيدة ما يلي:

• اسم المشروع أو مساحة العمل أو المستودع أو المجلد أو التقويم أو جدول البيانات
• اسم مهمة، أو معرّف مشكلة، أو اسم ملف، أو معرّف سجل
• نطاق تاريخ، أو تاريخ استحقاق، أو مالك، أو حالة، أو أولوية
• ما الذي تريد من Atoms قراءته أو تلخيصه أو إنشاؤه أو تحديثه

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

• “لخّص مشكلات Linear عالية الأولوية المسندة إليّ.”
• “اعثر على موجز الإطلاق في Drive واعرض القرارات المفتوحة.”
• “أضف العملاء المحتملين المعتمدين هؤلاء إلى جدول بيانات الحملة.”
• “أنشئ حدثًا في التقويم لمراجعة التصميم يوم الثلاثاء القادم الساعة 3 مساءً.”

لا يمكن لـ Atoms استخدام سوى الإجراءات التي يدعمها الموصل والبيانات المتاحة للحساب المتصل. إذا لم تظهر القدرة أو الإجراء الذي تحتاجه لذلك الموصل، فتوقف ولا تفترض أنه مدعوم.

راجع التغييرات الخارجية قبل تنفيذها

عندما يدعم الموصل والإجراء إنشاء بيانات خارجية أو تحديثها، قد يعرض Atoms تأكيدًا قبل تنفيذ ذلك.

راجع:

• الخدمة والحساب المتصل
• الملف أو جدول البيانات أو التقويم أو المشروع أو السجل المستهدف
• المعلومات التي سيتم إنشاؤها أو تغييرها
• أي تاريخ أو وقت أو مستلم أو قيمة مهمة أخرى

إذا عرض Atoms تأكيدًا، فراجعه وحدّد Confirm للمتابعة أو ألغِ لترك الخدمة الخارجية دون تغيير. يعتمد توفر الكتابة على الموصل والإجراء؛ فالموصلات للقراءة فقط لا توفر إجراءات كتابة.

بعد عملية كتابة، تحقّق من النتيجة في الخدمة الخارجية قبل إعادة المحاولة. إذا كان الهدف أو القيم غير صحيحة، فأوقف سير العمل واستخدم أدوات السجل أو التراجع أو الاسترداد الخاصة بموفر الخدمة عند توفرها. يؤدي فصل الموصل إلى إيقاف الاستخدام المستقبلي؛ لكنه لا يعكس التغييرات التي أُجريت بالفعل.

إدارة اتصال

افتح فهرس الموصلات وحدّد خدمة متصلة لمراجعة حالتها الحالية.

من لوحة تفاصيل الموصل، قد تتمكن من:

• التحقق من الحساب المتصل
• مراجعة الإجراءات التي يدعمها الموصل ونطاق أذوناته
• إعادة الاتصال عند انتهاء صلاحية التفويض
• تحديث الوصول أو تغييره عندما تدعم الخدمة ذلك
• فصل الحساب عن Atoms

يؤدي الفصل في Atoms إلى إيقاف الاستخدام المستقبلي للاتصال. وقد تتطلب بعض الخدمات أيضًا أن تلغي تفويض Atoms من إعدادات الحساب أو الأمان الخاصة بالخدمة نفسها.

أمثلة حسب حالة الاستخدام

الجدول أدناه هو تجميع تحريري حسب حالة الاستخدام، وليس مجموعة من فئات الفهرس. استخدم الفهرس القابل للبحث للحصول على القائمة الحالية للموصلات المتاحة.

الفئة	الاستخدامات الشائعة	أمثلة
التطوير	التحكم في المصدر، والمستودعات، والمشكلات، وسير عمل التسليم	GitHub, Linear
الواجهة الخلفية والبيانات	قواعد البيانات، والمصادقة، والتخزين، والبيانات المنظمة	Supabase
المدفوعات	الدفع، والفوترة، وسير عمل المدفوعات	Stripe
إدارة العمل	المهام، والمشاريع، والمالكون، وتواريخ الاستحقاق	Asana, Todoist
الملفات والمحتوى	البحث في الملفات الخارجية وقراءتها وتنظيمها	Box, Dropbox
التحليلات والتسويق	الزيارات، وأداء البحث، والحملات، وإعداد التقارير	Google Analytics 4, Google Search Console, Google Ads

يتغير توفر الموصلات بمرور الوقت. استخدم الفهرس في Atoms للحصول على القائمة الحالية وافتح أي موصل لمراجعة قدراته الدقيقة.

أدلة الإعداد

اختر الدليل الخاص بخدمتك:

• ربط GitHub
• ربط Supabase
• ربط GA4
• ربط Google Search Console
• ربط Google Ads

لمشكلات الاتصال، راجع استكشاف أخطاء التكامل وإصلاحها.