Google Workspace

تسجيل دخول واحد عبر Google يربط Drive و Sheets و Docs, 14 أداة لقراءة الملفات وإنشائها وتحديثها. أمّا Gmail والتقويم فيُربطان على حدة.

تسجيل دخول واحد عبر Google يربط Drive و Sheets و Docs بوكيلك، ويُعرض عليك وضع للقراءة فقط لحظة الربط. أربع عشرة أداة تتيح له قراءة ملفاتك وإنشاء جداول البيانات والمستندات أو تحديثها نيابةً عنك. أمّا Gmail وGoogle Calendar فاتصالان منفصلان, وكلاهما مرتبط أدناه.

الربط

افتح التكاملات واختر Google ‏(Drive · Sheets · Docs).
سجّل الدخول عبر Google وامنح الوصول. وللإبقاء عليه للقراءة فقط، فعّل خيار القراءة فقط, عندئذٍ يستطيع الوكيل القراءة لكن لا يستطيع أبدًا إنشاء أي شيء أو تحديثه أو نقله.
أصبح بإمكان الوكيل الآن العمل مع Drive و Sheets و Docs الخاصة بك.

المزلق الوحيد الذي يوقع الناس: نطاق drive.file. حفاظًا على خصوصيتك، لا يعرض سرد Drive سوى الملفات التي أنشأها الوكيل إضافةً إلى الملفات أو المجلدات التي شاركتها صراحةً مع حساب Google المرتبط, ولا يعرض أبدًا Drive بأكمله لديك. أمّا Sheets و Docs فما زال يمكن الوصول إليهما على مستوى الحساب كله عبر رابط أو معرّف، لذا فإنّ أسرع طريقة لتمكين الوكيل من العمل على مستند قائم هي لصق رابطه (أو مشاركة الملف). فإن «لم يعثر» الوكيل على جدول بيانات تعرف أنه موجود، فهذا النطاق هو السبب.

ما الذي يمكن للوكيل فعله

الأداة	الوصول	النوع	ما تفعله
`gdrive_list_files`	آمنة للعموم	Read	List files and folders the agent can access, the ones it created plus any you shared; filter by name or list a folder.
`gdrive_read_file`	آمنة للعموم	Read	Read a Drive file's text; native Docs, Sheets, and Slides are exported to plain text or CSV.
`gsheets_read`	آمنة للعموم	Read	Read cell values from a sheet by URL or ID, using an A1-notation range.
`gsheets_get_metadata`	آمنة للعموم	Read	Get a sheet's title and tabs, names, IDs, and row/column counts.
`gdocs_read`	آمنة للعموم	Read	Read the full text of a Google Doc by URL or ID.
`gdrive_create_file`	خاصة بالمالك	Write	Create a plain text file (txt, csv, markdown, html) in Drive, optionally inside a folder.
`gdrive_create_folder`	خاصة بالمالك	Write	Create a new folder, optionally inside a parent folder.
`gdrive_update_file`	خاصة بالمالك	Write	Rename a Drive file, replace its content, or move it to another folder.
`gsheets_append_rows`	خاصة بالمالك	Write	Append rows after the last row of data in a sheet tab.
`gsheets_update_cells`	خاصة بالمالك	Write	Overwrite a specific cell range with new values.
`gsheets_create`	خاصة بالمالك	Write	Create a new sheet with a title, optional tabs, and optional starting rows.
`gdocs_create`	خاصة بالمالك	Write	Create a new Google Doc with a title and optional initial text.
`gdocs_insert_text`	خاصة بالمالك	Write	Insert text into a Doc, at the end by default, or at a set position.
`gdocs_replace_text`	خاصة بالمالك	Write	Find and replace every occurrence of a string in a Doc.

الآمنة للعموم مقابل الخاصة بالمالك

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

مثال عملي

تقول لوكيلك الداخلي: «اقرأ تبويب العملاء المحتملين في جدول البيانات هذا [رابط] وابدأ مستند متابعة يلخّص أفضل خمسة.» فيستدعي gsheets_read على الرابط المشارَك، ثم gdocs_create لإنشاء المستند وgdocs_insert_text لتعبئته, ملف جديد يظهر في Drive لديك، مُنشأ باسم حسابك.

الحدود والصراحة

ضيّق بحكم التصميم. يعني نطاق drive.file أنّ الوكيل يرى الملفات المُنشأة والمشارَكة فقط, لا Drive بأكمله لديك. وهذه ميزة، لا خلل.
الأداة الصحيحة للملفات الأصلية. تُنشئ gdrive_create_file ملفات نصية عادية؛ استخدم gsheets_create / gdocs_create لإنشاء Sheets و Docs حقيقية.
يُقاس عمل الذكاء الاصطناعي بـ ABT، شأنه شأن كل نشاط الوكيل, انظر الفوترة و ABT.

Gmail والتقويم (اتصالان منفصلان)

Gmail يُربط بوصفه حساب بريد إلكتروني عبر تسجيل الدخول نفسه من Google ويمنح الوكيل أدوات بريد خاصة بالمالك. وتعمل القراءة والبحث في البريد ضمن النطاق الممنوح.

التقويم تكامل قائم بذاته, والتوفّر والحجز موجودان في صفحة Google Calendar.

استكشاف الأخطاء

«لا أجد ملفي». الملف ليس من إنشاء الوكيل ولا مشارَكًا معه. الصق رابط المستند أو معرّفه، أو شارِك الملف/المجلد مع حساب Google المرتبط.
أدوات الكتابة مفقودة. الاتصال في وضع القراءة فقط, أعِد الربط بدونه لتفعيل الإنشاء والتحديث والنقل.
المستند خرج فارغًا. تُنشئ gdocs_create بلا نصّ مستندًا فارغًا؛ اطلب المحتوى، أو أتبِعها بـgdocs_insert_text.

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

هل يستطيع الوكيل رؤية Drive بأكمله لديّ؟ لا, فقط الملفات التي أنشأها إضافةً إلى تلك التي شاركتها صراحةً (نطاق drive.file).

هل يستطيع إرسال البريد الإلكتروني؟ القراءة تعمل؛ أمّا الإرسال فبنطاق مقيّد, انظر الملاحظة أعلاه والبريد الإلكتروني قبل الاعتماد عليه.

هل يمنع وضع القراءة فقط جميع عمليات الكتابة فعلًا؟ نعم, تُخفى أدوات الكتابة التسع جميعها ما دام الاتصال للقراءة فقط.

Google Calendar, اعرض الفترات المتاحة واحجز المواعيد
البريد الإلكتروني, تسجيل الدخول عبر Google، و IMAP/SMTP، وعائلة أدوات البريد
قدرات الوكيل, كيف تُرفَق الأدوات بوكيل
نظرة عامة على التكاملات