الانتقال إلى المحتوى الرئيسي

​
Gmail وDrive وCalendar والمزيد

يربط تكامل Google Workspace تطبيق وولف فيش بـ Gmail و Google Drive و Calendar و Contacts و Tasks و Sheets. يدعم حسابات Google متعددة ويستخدم OAuth 2.0 للمصادقة.

​
الإعداد

1

فتح الإعدادات

انتقل إلى الإعدادات > التكاملات > Google.
2

التفويض

اضغط “تفويض” لبدء مسار OAuth. سيفتح متصفحك الافتراضي على شاشة موافقة Google.
3

منح الصلاحيات

وافق على النطاقات المطلوبة. يطلب وولف فيش صلاحيات قراءة/كتابة لـ Gmail و Drive و Calendar و Contacts و Tasks و Sheets.
4

الإكمال

يعيد المتصفح التوجيه إلى عنوان استدعاء محلي. تُخزّن رموزك في config.json ويظهر الحساب في الإعدادات.
تُخزّن رموز OAuth محليًا في ~/.wolffish/workspace/config.json. يستخدم وولف فيش رمز التحديث لتجديد رموز الوصول بصمت عند انتهائها — لا حاجة لإعادة التفويض.

​
دعم الحسابات المتعددة

يمكنك تفويض حسابات Google متعددة. أداة google_accounts تعرض جميع الحسابات المتصلة، وكل أداة Google أخرى تتطلب معامل account صريحًا لتحديد الحساب المراد استخدامه. 
User: "Check my email"
LLM calls: google_accounts() → returns [{email: "work@company.com"}, {email: "personal@gmail.com"}]
LLM calls: gmail_search({account: "work@company.com", query: "is:unread"})
إذا كان لديك حساب واحد فقط، يظل وولف فيش يتطلب معامل account للاتساق ولتجنب الالتباس إذا أضفت حسابات أخرى لاحقًا.

​
الأدوات المتاحة

​
Gmail

الأداةالوصف
gmail_searchالبحث في الرسائل بصيغة استعلام Gmail
gmail_readقراءة رسالة محددة بمعرّفها
gmail_sendكتابة وإرسال رسالة جديدة
gmail_replyالرد على سلسلة رسائل موجودة
gmail_forwardإعادة توجيه رسالة إلى مستلم آخر
gmail_archiveأرشفة رسالة (إزالتها من البريد الوارد)
gmail_trashنقل رسالة إلى المهملات
gmail_mark_readتعليم رسالة كمقروءة
gmail_save_draftحفظ مسودة بدون إرسال

​
Google Drive

الأداةالوصف
drive_listعرض الملفات والمجلدات
drive_uploadرفع ملف محلي إلى Drive
drive_downloadتنزيل ملف من Drive إلى القرص المحلي
drive_create_folderإنشاء مجلد جديد
drive_searchالبحث في الملفات بالاسم أو المحتوى

​
Google Calendar

الأداةالوصف
calendar_list_eventsعرض الأحداث القادمة (مع فلتر نطاق زمني)
calendar_create_eventإنشاء حدث تقويم جديد
calendar_update_eventتحديث حدث موجود
calendar_delete_eventحذف حدث
calendar_rescheduleنقل حدث إلى وقت جديد

​
Google Contacts

الأداةالوصف
contacts_listعرض جميع جهات الاتصال
contacts_createإنشاء جهة اتصال جديدة
contacts_searchالبحث في جهات الاتصال بالاسم أو البريد الإلكتروني أو رقم الهاتف

​
Google Tasks

الأداةالوصف
tasks_list_tasklistsعرض جميع قوائم المهام
tasks_listعرض المهام في قائمة مهام محددة
tasks_createإنشاء مهمة جديدة
tasks_completeتعليم مهمة كمكتملة
tasks_deleteحذف مهمة

​
Google Sheets

الأداةالوصف
sheets_readقراءة بيانات من نطاق في جدول بيانات
sheets_writeكتابة بيانات في نطاق بجدول بيانات
sheets_createإنشاء جدول بيانات جديد
sheets_update_cellsتحديث خلايا محددة

​
المحفّزات

تُفعّل قدرة Google عندما تتطابق رسالتك مع أي من هذه الأنماط: 
email, inbox, gmail, send email, compose email, draft,
drive, upload file, download file, google drive,
calendar, schedule, meeting, event, appointment,
contacts, address book, phone number,
tasks, todo, task list, to-do,
sheets, spreadsheet, google sheets

​
أمثلة على سير العمل

You: "Check my email"
Wolffish: Lists your 10 most recent unread emails with sender, subject, and snippet.

You: "Schedule a meeting with Ali tomorrow at 2pm for 30 minutes"
Wolffish: Creates a calendar event, confirms the time and date.

You: "Upload ~/Documents/report.pdf to my Drive"
Wolffish: Uploads the file and returns the Drive link.

You: "Find emails from sarah@example.com about the project proposal"
Wolffish: Searches Gmail with the query and returns matching threads.

​
مرجع التهيئة

يخزّن تكامل Google بياناته في config.json: 
{
  "integrations": {
    "google": {
      "accounts": [
        {
          "email": "you@gmail.com",
          "accessToken": "ya29.a0AfH6SM...",
          "refreshToken": "1//0eXyz...",
          "expiresAt": 1700000000000
        }
      ]
    }
  }
}
لا تعدّل الرموز يدويًا في config.json إلا إذا كنت تعرف ما تفعله. استخدم واجهة الإعدادات لإضافة أو إزالة الحسابات. الرموز المشوّهة ستسبب أخطاء مصادقة صامتة.
إذا بدأت استدعاءات Google API بالفشل مع أخطاء 401، انتقل إلى الإعدادات > Google واضغط “إعادة التفويض” لتحديث رموزك. يحدث هذا عادةً إذا أزلت الوصول من إعدادات أمان حسابك في Google.