تكامل Google Cloud Storage

يربط تكامل Google Cloud Storage حاويات GCS لديك بـUltralytics Platform. تبقى صورك في حاوياتك — إذ تفهرسها Platform في موقعها، لتتمكن من تصفحها وتوسيمها وتدريب نماذج YOLO من دون رفع نسخة منها. وعند تفعيل ميزات الذكاء الاصطناعي، يمكن لـPlatform استخدامها أيضًا للتوسيم الذكي، والتوسيم التلقائي، والبحث عن الصور المتشابهة، والتدريب السحابي.

إنشاء حساب خدمة#

تشمل صلاحية القراءة كل شيء باستثناء إنشاء الصور، الذي ينشئ كائنات أيضًا. لا تعدّل Platform كائناتك أو تحذفها مطلقًا. أنشئ حساب خدمة مخصصًا:

1. في وحدة تحكم Google Cloud، انتقل إلى IAM & Admin > Service Accounts وأنشئ حساب خدمة.
2. امنحه دور Storage Object Viewer (roles/storage.objectViewer) على الحاويات التي تريد ربطها. ولـإنشاء الصور، امنحه أيضًا دور Storage Object Creator (roles/storage.objectCreator)، الذي ينشئ الكائنات لكنه لا يستطيع الكتابة فوقها أو حذفها.
3. افتح حساب الخدمة، واختر Keys > Add key > Create new key، وحدد JSON، ثم نزّل ملف المفتاح.

الاتصال بـ Platform#

1. انتقل إلى Settings > Integrations، ثم اختر Google Cloud Storage من قائمة عمليات التكامل.
2. الصق محتويات مفتاح JSON لحساب الخدمة.
3. انقر Find available buckets، ثم اختر الحاويات المراد ربطها. إذا تعذر على حساب الخدمة سرد الحاويات، فأدخل يدويًا اسم حاوية تعرفه.
4. انقر Connect. تتحقق Platform من قدرتها على سرد محتوى كل حاوية محددة وقراءته قبل حفظ أي شيء، وتسأل Google Cloud أيضًا عما إذا كان حساب الخدمة يستطيع إنشاء كائنات. لا يُكتب أي شيء.

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

يجب أن يكون لديك دور مسؤول مساحة العمل أو مالكها لربط التخزين السحابي. يمكنك إضافة ما يصل إلى 50 حاوية في المرة الواحدة، ويعرض الاكتشاف ما يصل إلى 300 حاوية يمكن لحساب الخدمة الوصول إليها.

يقرأ متصفحك ملف المفتاح الملصق ويرسل الحقول الثلاثة التي تحتاج إليها Platform فقط — client_email وprivate_key، وproject_id. ولا يغادر باقي ملف JSON الصفحة.

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

ميزات الذكاء الاصطناعي#

يتضمن كل اعتماد متصل مفتاح تبديل ميزات الذكاء الاصطناعي في Settings > Integrations، ويكون مفعّلًا افتراضيًا. عند تفعيله، قد تستخدم وحدات معالجة الرسومات من Ultralytics ومزودو نماذج الذكاء الاصطناعي صور ذلك الاعتماد في ما يلي:

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

لا تُستعان بمزودي نماذج الذكاء الاصطناعي إلا لتوليد الصور، حيث يخطط Google Gemini للمطالبات انطلاقًا من الصورة المصدر، ولنماذج التوسيم المدفوعة التي تعمل باستخدام مفتاح المزود الخاص بمساحة عملك. لا تحتفظ المنصة بنسخة من صورك: تقرأ الميزات الصور عند الحاجة، ويستخدم التدريب السحابي نسخًا مؤقتة طوال مدة التشغيل، ويحتفظ البحث عن الصور المتشابهة بـتضمين لكل صورة يُحذف عند إزالة الصورة من المنصة.

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

تحتاج إلى دور مسؤول مساحة العمل أو مالكها لتغيير مفتاح التبديل. يمكنك أيضًا ضبطه عبر REST API، باستخدام معرّف التكامل الذي تُعيده GET /api/integrations/buckets:

curl -X PATCH \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"processing": false}' \
  https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_ID

إنشاء الصور#

تعمل ميزة إنشاء صور مشابهة على مجموعات بيانات Google Cloud Storage التي يستطيع حساب الخدمة الكتابة إلى حاويتها، ما دامت ميزات الذكاء الاصطناعي مفعّلة. تُكتب الصور التي تضيفها في مجلد generated/ داخل مجلد مجموعة البيانات، ثم تُضاف إلى مجموعة البيانات كأي صورة أخرى مفهرسة. لا تنشئ Platform هناك إلا كائنات جديدة، ولا تكتب فوق الموجود منها أو تحذفه مطلقًا. إذا أشارت العملية إلى حاجتها إلى صلاحية الكتابة، فامنحها هذه الصلاحية عند الحاجة، ثم أعد ربط حساب الخدمة نفسه في Settings > Integrations.

إنشاء مجموعة بيانات من حاوية GCS#

1. انقر New Dataset وافتح علامة التبويب Cloud.
2. اختر حاوية متصلة، واستعرض المجلد الذي يحتوي على بياناتك.
3. أكّد المجلد، وعدّل اسم مجموعة البيانات، ثم أنشئها.

تسرد Platform محتويات المجلد مرة واحدة وتفهرس ما تعثر عليه:

• الصور — تُفهرس عناصر .jpg و.jpeg و.png و.webp و.avif مع قراءة الأبعاد عبر طلبات محدودة الحجم. ولا تحتفظ Platform بنسخة ثانية من الصورة المصدر.
• التسميات — تُحلّل ملفات YOLO الجانبية .txt وتحول إلى تعليقات توضيحية في Platform، وتُطابق وفق البنية القياسية images/ → labels/ أو بوصفها ملفات شقيقة في المجلد نفسه.
• البيانات الوصفية — يوفر ملف YAML أسماء الفئات وشكل النقاط المفتاحية للوضعيات، تمامًا كما يحدث عند رفع أرشيف. ويُفضّل استخدام data.yaml وdata.yml إذا احتوى المجلد على عدة ملفات.
• المهمة — تحدد عينة من ملفات التسميات نوع المهمة، لذا تُعرَف مجلدات التقسيم وتقدير الوضعيات وOBB من شكل التسميات، لا من المهمة التي اخترتها في مربع الحوار.
• التقسيمات — تعيّن أسماء المجلدات train وval وtest في مسار العنصر التقسيمات تلقائيًا.

تعمل مجموعة البيانات بعد ذلك مثل أي مجموعة أخرى: استعرضها وأضف إليها تعليقات توضيحية، واجعلها عامة أو خاصة، وشاركها مع فريقك، ودرّب عليها باستخدام التدريب المُدار. وتُبث الملفات الأصلية عند الطلب، ولا تشغل الصور المفهرسة حيزًا من حصة التخزين في Platform.

عمليات الاستيراد الفاشلة#

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

تعيد محاولة الاستيراد سرد محتويات المجلد بدلًا من استئناف العملية: تُضاف العناصر التي أُضيفت منذ المحاولة الأولى، وتُزال من مجموعة البيانات العناصر التي لم تعد موجودة.

التدريب#

يعمل التدريب المُدار عبر مسار التدريب المعتاد ما دامت ميزات الذكاء الاصطناعي مفعّلة. يستخدم التدريب نسخ Platform الخاصة من الصور المثبّتة طوال مدة التشغيل، ولا تُكشف بيانات اعتماد Google Cloud الخاصة بك مطلقًا لأحمال عمل التدريب. عند إيقاف ميزات الذكاء الاصطناعي، يوضح مربع حوار التدريب سبب عدم توفر التدريب السحابي ويعرض التدريب المحلي بدلًا منه.

قطع اتصال اتصال#

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

لقطع الاتصال، انتقل إلى الإعدادات > عمليات التكامل، واختر Google Cloud Storage، وانقر على قطع الاتصال بجوار بيانات الاعتماد، ثم أكّد الإجراء. عند فتح إحدى مجموعات البيانات المرتبطة به، ستظهر رسالة تم قطع اتصال Google Cloud Storage مع رابط إلى هذه الإعدادات، وستعود مجموعة البيانات تلقائيًا بمجرد إعادة الاتصال.

يمكنك أيضًا قطع الاتصال باستخدام REST API، بالاستعانة بمعرّف التكامل الذي يعيده GET /api/integrations/buckets:

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_ID

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY
integrations = client.storage_integrations.list()
client.storage_integrations.delete("INTEGRATION_ID")

لإلغاء الوصول من المصدر بدلًا من ذلك، احذف مفتاح حساب الخدمة في Google Cloud.

القيود الحالية#

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

يؤدي حذف مجموعة بيانات مرتبطة بـ GCS أو صور فردية منها إلى إزالة مراجع Platform فقط — ولا تُمس عناصرُك مطلقًا.

راجع أيضًا عمليات تكامل Amazon S3 وAzure Blob Storage.

الأسئلة الشائعة#