بنية الوكلاءالمهارات العامة

Cloud Storage

تخزين سحابي شامل لوكلاء الذكاء الاصطناعي — رفع، تنزيل، مشاركة، بحث، وإدارة الملفات عبر AWS S3، Google Cloud Storage، Cloudflare R2، وMinIO.

افتح مصدر المهارة اقرأ الدليل الرسمي ↗

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

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

الهيكلية

كيف يوجه Cloud Storage وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة Cloud Storage

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-storage

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-storage · الأدوات المسموح بها: 12

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

تأتي هذه المسارات مباشرة من تعليمات المهارة. تساعد النموذج على التعرف على النية واختيار أداة أو سير عمل مركّز بدلاً من الارتجال عبر كامل سطح القدرة.

"upload", "store", "put file"?

upload_object

"download", "get file", "fetch"?

download_object

"share", "link", "URL"?

generate_presigned_url (محدود زمنياً!)

"find", "search", "where is"?

search_objects / list_objects

"copy", "duplicate"?

copy_object

"move", "rename"?

move_object

"delete", "remove"?

delete_object (تأكيد أولاً!)

"buckets", "list storage"?

list_buckets

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

011 استدعاء

رفع

تخزين الملف مع نوع المحتوى

021 استدعاء

رابط موقع موقع مسبق التوقيع محدود زمنياً

031-2 استدعاء

بحث

العثور على الملفات حسب البادئة/النمط

041-2 استدعاء

تنظيم

نسخ، نقل، إعادة تسمية

051 استدعاء

مراقبة

استخدام التخزين لكل دلو

06Setup استدعاء

مزود

الإعداد

حدود الأداة

قد تستخدم المهارة 12 أدوات موثقة.

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

list_buckets

list_objects

get_object_info

download_object

generate_presigned_url

upload_object

copy_object

move_object

delete_object

create_bucket

search_objects

get_storage_usage

قواعد العمل

ما الذي يجب على الوكيل القيام به.

استخدم الروابط الموقعة للمشاركة (لا تجعل الكائنات عامة أبداً)
حدد content_type المناسب عند الرفع
أكد قبل الحذف (لا يمكن التراجع)
افحص استخدام التخزين دورياً

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

لا تحذف بدون تأكيد صريح من المستخدم
لا تجعل الحاويات متاحة للعامة
لا ترفع بدون تحديد content_type
لا تنشئ روابط موقعة بصلاحية 24 ساعة بدون مبرر

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-storage، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-cloud-storage.git \
  ~/.skills/skills/cloud-storage

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("cloud-storage").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-storage (AWS S3، Google Cloud Storage، Cloudflare R2، MinIO، أو أي مزود متوافق مع S3).

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md سير عمل عبر Mcp ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md التحقق من المفتاح ↗scripts/validate_key.py تقرير التخزين ↗assets/storage-report.md

استمر في الاستكشاف