ربط وكلاء الذكاء الاصطناعي بخدمة TrekMail Drive

يمكن لوكيل الذكاء الاصطناعي إدارة ملفات Drive بأمان عندما تمنحه رمزا محدودا وقواعد واضحة. يركز هذا الدليل على إعداد Drive الخاص بالوكلاء المتوافقين مع MCP. لمعرفة خطوات التثبيت العامة لـ MCP، راجع ربط وكلاء الذكاء الاصطناعي (MCP).

اختيار مهمة الوكيل

ابدأ بتسمية مسار العمل، لا الأداة. من الأمثلة الجيدة:

• ينشئ client-delivery-links روابط عامة للملفات المعتمدة.
• يرفع monthly-report-uploader ملفات PDF المنشأة إلى Drive الخاص بالحساب.
• يبحث mailbox-file-assistant في Drive الخاص بصندوق بريد واحد.
• يقرأ storage-monitor الاستخدام وحالة الإضافة.

يسهّل الاسم المحدد مراجعة الرمز المميز وسجلات التدقيق كثيرا في وقت لاحق.

إنشاء رمز ذي نطاق محدود

افتح وكلاء الذكاء الاصطناعي وAPI ← الرموز المميزة ← إنشاء رمز. بالنسبة إلى وكيل مخصص لـ Drive، حدد نطاقات Drive فقط. لا يحتاج معظم الوكلاء إلى الحذف النهائي.

أمثلة:

انسخ الرمز المميز مرة واحدة. لن يعرضه TrekMail مرة أخرى.

ضبط MCP

اضبط رمز العمليات في بيئة MCP:

TREKMAIL_BASE_URL=https://trekmail.net
TREKMAIL_API_TOKEN=tm_live_your_token
TREKMAIL_ALLOW_DESTRUCTIVE=false

هذا عنصر تحكم في أمان MCP المستضاف ذاتيا، وليس مفتاحا لميزة في Drive. أبق TREKMAIL_ALLOW_DESTRUCTIVE=false لأعمال Drive العادية، ولا تفعّله إلا لتشغيل تنظيف خضع للمراجعة ويحتاج إلى أدوات الحذف النهائي.

إذا كان الوكيل نفسه يقرأ البريد الإلكتروني أو يرسله أيضا، فأضف رمز رسائل منفصلا:

TREKMAIL_MESSAGE_TOKEN=tm_msg_your_message_token

لا تستخدم أدوات Drive رموز الرسائل. ولا تستخدم أدوات الرسائل نطاقات Drive.

الاختبار أولا باستخدام أدوات غير ضارة

اطلب من الوكيل استدعاء:

1. drive_spaces_list
2. drive_storage_summary
3. drive_browse_folder للقيمة space="account"

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

منح الوكيل قواعد تشغيل آمنة

ينبغي أن تتضمن مطالبة النظام العملية لوكيل Drive ما يلي:

• عدم حذف الملفات نهائيا إلا إذا طلب المستخدم ذلك صراحة.
• تفضيل المهملات على الحذف الدائم.
• إضافة تاريخ انتهاء وحدود للتنزيل إلى الروابط العامة.
• إعادة عناوين URL للمشاركة التي تم إنشاؤها على الفور.
• استخدام Drive الخاص بالحساب لملفات الفريق، وعدم استخدام Drive الخاص بصندوق البريد إلا عندما تسمي المهمة صندوق بريد.
• التحقق من استخدام مساحة التخزين قبل رفع الملفات الكبيرة.

مراجعة التدقيق بعد الإعداد

افتح وكلاء الذكاء الاصطناعي وAPI ← سجل التدقيق وصفّ النتائج حسب اسم الرمز. تحقق من أن الوكيل لم يستدع إلا أدوات Drive المتوقعة. إذا كان للرمز نطاقات أكثر من اللازم، فألغِه وأنشئ بديلا أضيق نطاقا.