تخطَّ إلى المحتوى

جاهز للبناء مع AnyBot؟

مستندات AnyBot
التكاملات

Notion

اربط Notion بتسجيل دخول واحد، ثم دع وكيلك يبحث في الصفحات وقواعد البيانات ويقرأها ويكتب فيها, لكن فقط الصفحات التي تشاركها مع التكامل.

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

الربط

  1. افتح التكاملات واختر Notion.
  2. أكمل تسجيل الدخول إلى Notion. وفي شاشة الموافقة الخاصة بـ Notion، اختر الصفحات وقواعد البيانات التي تريد أن يصل إليها الوكيل, فهذه هي الخطوة التي تمنح الوصول.
  3. تمّ الربط. لا يوجد منتقي نطاقات في جانب AnyBot؛ فاختيار الصفحات يحدث بالكامل في شاشة Notion.

المزلق التمكيني: تكاملات Notion ترفض بشكل افتراضي. فكل ما لم تؤشّر عليه أثناء تسجيل الدخول يبقى غير مرئي للوكيل, وسيعيد البحث عنه لا شيء ببساطة. ولإضافة صفحة أو قاعدة بيانات لاحقًا، افتحها في Notion واستخدم قائمة ... ← Connections ← أضِف AnyBot. ومشاركة صفحة أب تشارك صفحاتها الفرعية أيضًا.

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

الأداةالوصولالنوعما تفعله
notion_searchآمنة للعمومReadSearches shared pages and databases by title and returns their ids for the other tools.
notion_get_pageآمنة للعمومReadReads a page's properties (title, fields) by id, metadata only, not the body.
notion_get_block_childrenآمنة للعمومReadReads a page's body content as a flat list of blocks with plain text; nested blocks can be read deeper.
notion_query_data_sourceآمنة للعمومReadQueries rows of a database with optional filter and sorts, by data source or database id.
notion_create_pageخاصة بالمالكWriteCreates a page under a parent page or as a database row, optionally with content.
notion_append_blocksخاصة بالمالكWriteAppends content blocks (paragraphs, headings, lists, to-dos, quotes, code) to a page.
notion_update_pageخاصة بالمالكWriteUpdates a page's title, properties, or archived state.
notion_create_commentخاصة بالمالكWriteAdds a comment to a page or replies to a discussion thread.

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

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

مثال عملي

تحتفظ بصفحة «سياسة الإرجاع» في Notion وتشاركها مع التكامل. يسأل عميل وكيل الدعم لديك: «كم من الوقت أمامي لإرجاع منتج؟» يشغّل الوكيل notion_search للعثور على الصفحة، ثم notion_get_block_children لقراءتها، فيجيب من نصّ السياسة الفعلي, بلا أي نسخ ولصق، وتتحدّث الإجابة نفسها بنفسها لحظة تعديلك للصفحة.

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

  • الوصول مرفوض افتراضيًا. لا شيء مرئي إلى أن تشاركه في شاشة الموافقة أو عبر قائمة ... ← Connections.
  • قواعد البيانات تعتمد على المخطّط أولًا. بالنسبة إلى notion_query_data_source، يجب أن تطابق أسماء خصائص التصفية والترتيب قاعدة البيانات تمامًا, استعلِم مرّة بلا مرشّح لاكتشاف الأسماء الحقيقية.
  • الكتابة على المحتوى فقط. أدوات الكتابة تعدّل محتويات الصفحات وخصائصها؛ ولا تدير أعضاء مساحة العمل أو الأذونات أو الفوترة.

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

  • البحث لا يُعيد شيئًا, الصفحة غير مشارَكة. أضِف AnyBot عبر قائمة الصفحة ... ← Connections.
  • «الاتصال لم يعد صالحًا», انتهت صلاحية رمز OAuth أو أُلغي في Notion. أعِد الربط من التكاملات.
  • الوكيل لا يكتب, التكامل في وضع القراءة فقط، أو أنّ الأداة خاصة بالمالك والسائل زائر. وكلا الحالتين بحكم التصميم.

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

هل عليّ مشاركة كل صفحة على حدة؟ لا, شارِك صفحة أب فتأتي صفحاتها الفرعية معها.

هل يستطيع زائر الموقع التعديل في Notion لديّ؟ أبدًا. أدوات الكتابة الأربع جميعها خاصة بالمالك.

أين تُنشأ الصفحات الجديدة؟ في قاعدة البيانات أو الصفحة الأب التي تسمّيها, أو في قاعدة البيانات / الصفحة الأب الافتراضية التي تضبطها على التكامل.

التالي