From c5e03df2940955ec7ae4f3e2ee83fc84d81b1645 Mon Sep 17 00:00:00 2001 From: HynLcc Date: Mon, 21 Sep 2026 15:58:47 +0800 Subject: [PATCH] docs: connector event triggers, routine trigger kinds, third-party app credits Add the "when connector event received" automation trigger page in every locale, document the routine trigger choice between a schedule and a connector event, and note that third-party app calls consume space credits. Co-Authored-By: Claude Opus 5 --- ar/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ ar/basic/credential.mdx | 6 ++ de/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ de/basic/credential.mdx | 6 ++ docs.json | 11 +++ en/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ en/basic/credential.mdx | 6 ++ es/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ es/basic/credential.mdx | 6 ++ fr/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ fr/basic/credential.mdx | 6 ++ it/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ it/basic/credential.mdx | 6 ++ ja/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ ja/basic/credential.mdx | 6 ++ ru/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ ru/basic/credential.mdx | 6 ++ tr/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ tr/basic/credential.mdx | 6 ++ uk/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ uk/basic/credential.mdx | 6 ++ zh/basic/ai/routine.mdx | 36 +++++---- .../trigger/external/connector-event.mdx | 74 +++++++++++++++++++ zh/basic/credential.mdx | 6 ++ 34 files changed, 1144 insertions(+), 143 deletions(-) create mode 100644 ar/basic/automation/trigger/external/connector-event.mdx create mode 100644 de/basic/automation/trigger/external/connector-event.mdx create mode 100644 en/basic/automation/trigger/external/connector-event.mdx create mode 100644 es/basic/automation/trigger/external/connector-event.mdx create mode 100644 fr/basic/automation/trigger/external/connector-event.mdx create mode 100644 it/basic/automation/trigger/external/connector-event.mdx create mode 100644 ja/basic/automation/trigger/external/connector-event.mdx create mode 100644 ru/basic/automation/trigger/external/connector-event.mdx create mode 100644 tr/basic/automation/trigger/external/connector-event.mdx create mode 100644 uk/basic/automation/trigger/external/connector-event.mdx create mode 100644 zh/basic/automation/trigger/external/connector-event.mdx diff --git a/ar/basic/ai/routine.mdx b/ar/basic/ai/routine.mdx index eadfaeea..f46e391e 100644 --- a/ar/basic/ai/routine.mdx +++ b/ar/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: دع Cuppy ينفّذ مطالبة وفق جدول زمني، ور متاح في جميع خطط السحابة؛ أما النسخة المستضافة ذاتيًا فتتطلب خطة Business أو أعلى. -يسلّم الروتين مطالبة إلى Cuppy ويكررها وفق جدول زمني، وهو ما يناسب الأعمال التي لا ينبغي لأحد أن يبدأها يدويًا: تقرير يومي، تنظيف دوري للسجلات المنتهية، ملخّص أسبوعي. كل تشغيل هو محادثة ذكاء اصطناعي كاملة، لذا يستطيع الروتين كل ما تستطيعه المحادثة، بما في ذلك قراءة الجداول والكتابة فيها واستدعاء المهارات وإنشاء الملفات. +يسلّم الروتين مطالبة إلى Cuppy ويكررها، إما وفق جدول زمني أو كلما أبلغ تطبيق خارجي متصل عن حدث، وهو ما يناسب الأعمال التي لا ينبغي لأحد أن يبدأها يدويًا: تقرير يومي، تنظيف دوري للسجلات المنتهية، أرشفة رسالة بريد فور وصولها. كل تشغيل هو محادثة ذكاء اصطناعي كاملة، لذا يستطيع الروتين كل ما تستطيعه المحادثة، بما في ذلك قراءة الجداول والكتابة فيها واستدعاء المهارات وإنشاء الملفات. الروتين مورد داخل المشروع، ويظهر في الشريط الجانبي الأيمن إلى جانب الجداول والتطبيقات والأتمتة. -تُستثار الأتمتة بحدث، مثل تغيّر سجل أو إرسال نموذج أو Webhook، وتنفّذ الخطوات التي أعددتها مسبقًا. أما الروتين فيُستثار بالوقت وحده، وينفّذ مطالبة يفسّرها الوكيل بنفسه. اختر الأتمتة حين تحتاج إلى خطوات ثابتة ونتيجة متوقّعة، واختر الروتين حين تريد أن يقرّر الوكيل في كل مرة ما يفعله بالبيانات الحالية. +تنفّذ الأتمتة الخطوات التي أعددتها مسبقًا، بينما ينفّذ الروتين مطالبة يفسّرها الوكيل بنفسه. وكلاهما يمكن أن يُستثار بالوقت، وكلاهما يمكن أن يُستثار بحدث من تطبيق خارجي متصل. اختر الأتمتة حين تحتاج إلى خطوات ثابتة ونتيجة متوقّعة، واختر الروتين حين تريد أن يقرّر الوكيل في كل مرة ما يفعله بالبيانات الحالية. ## إنشاء روتين @@ -20,29 +20,37 @@ description: دع Cuppy ينفّذ مطالبة وفق جدول زمني، ور صِف في **المطالبة** ما ينبغي أن يفعله كل تشغيل. المطالبة هي التعليمات الكاملة للتشغيل الواحد، لذا اذكر مصدر البيانات وطريقة المعالجة ووجهة النتيجة. مثال: «لخّص السجلات المضافة أمس إلى جدول المهام، وجمّعها حسب المسؤول، واكتب الملخّص في جدول التقرير اليومي». - - اختر تكرارًا ضمن **الجدولة**، واضبط **البداية** و**النهاية (اختياري)** عند الحاجة. + + اختر ضمن **المُشغِّل** إما **حسب جدول زمني** أو **عند حدث من الموصِّل**، ثم املأ إعدادات النوع الذي اخترته. - انقر **تفعيل**. يجب أن تكون الإعدادات محفوظة مسبقًا، وأن يتضمّن الجدول موعدًا قادمًا. + انقر **تفعيل**. يجب أن تكون الإعدادات محفوظة مسبقًا: فـ**حسب جدول زمني** يتطلّب موعدًا قادمًا، و**عند حدث من الموصِّل** يتطلّب حسابًا صالحًا للاستخدام. ## الإعدادات -إلى جانب المطالبة والجدولة، يتضمّن النموذج هذه الإعدادات: +إلى جانب المطالبة والمُشغِّل، يتضمّن النموذج هذه الإعدادات: | الإعداد | الوصف | | --- | --- | | **النموذج** | النموذج ومستوى الذكاء اللذان يعمل بهما هذا الروتين. اترك **النموذج الافتراضي** لاستخدام نموذج المحادثة الافتراضي للمساحة | | **المحادثة** | **محادثة جديدة لكل تشغيل** تُبقي عمليات التشغيل مستقلّة بعضها عن بعض؛ و**متابعة محادثة التشغيل السابق** تنقل سياق عمليات التشغيل السابقة، وهو ما يناسب العمل الذي يحتاج إلى الرجوع إلى النتيجة السابقة | -| **البداية** / **النهاية (اختياري)** | حدود الجدول. من دون وقت انتهاء يستمر الروتين بلا أجل | +| **البداية** / **النهاية (اختياري)** | حدود الجدول، وتُستخدم مع **حسب جدول زمني** فقط. من دون وقت انتهاء يستمر الروتين بلا أجل | يُسجَّل النموذج ومستوى الذكاء عند الحفظ، ولذلك يُظهر سجل التشغيل ما عمل به كل تشغيل فعليًا. +### المُشغِّل + +يشغّل **حسب جدول زمني** الروتين في الأوقات التي تحدّدها، وإعداداته في قسم الجدولة أدناه. + +ويشغّله **عند حدث من الموصِّل** مرة واحدة كلما أبلغ تطبيق خارجي متصل عن حدث، مثل وصول رسالة بريد جديدة أو فتح مشكلة جديدة. اختر التطبيق والحدث و**الحساب** الذي يستقبله والمعلمات التي يطلبها الحدث؛ والإعداد هنا مطابق لمُشغِّل الأتمتة الموصوف في [عند تلقي حدث من الموصِّل](/ar/basic/automation/trigger/external/connector-event). والروتين على هذا المُشغِّل ليس له وقت **التشغيل التالي**، ولا يستخدم الجدول ولا حدوده. + +وعند سحب منح الحساب أو إزالة الحساب المتصل أو إيقاف التطبيق للاشتراك، يعرض الروتين **تم قطع الاشتراك** ويتوقف عن استقبال الأحداث، ويُرسل Teable إشعارًا إلى العضو الذي حدّثه آخر مرة. وإعادة توصيل الحساب نفسه تعيد بناء الاشتراك تلقائيًا؛ أما للانتقال إلى حساب آخر فاختره في المُشغِّل ثم احفظ. + ### الجدولة -اختر التكرار من الإعدادات الجاهزة: **كل ساعة** عند دقيقة محدّدة، و**يوميًا** و**أيام العمل** عند وقت محدّد، و**أسبوعيًا** في يوم من الأسبوع ووقت، و**شهريًا** في يوم ووقت. +تُستخدم الجدولة مع **حسب جدول زمني** فقط. اختر التكرار من الإعدادات الجاهزة: **كل ساعة** عند دقيقة محدّدة، و**يوميًا** و**أيام العمل** عند وقت محدّد، و**أسبوعيًا** في يوم من الأسبوع ووقت، و**شهريًا** في يوم ووقت. لما هو أدقّ من ذلك، اختر **مخصص (RRULE)** واكتب قاعدة وفق RFC 5545، مثل `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. وللقاعدة المخصّصة هذه الحدود: @@ -56,15 +64,17 @@ description: دع Cuppy ينفّذ مطالبة وفق جدول زمني، ور ## المسودّة والتحديث والتشغيل الفوري -الروتين الجديد مسودّة، ولا يعمل وفق الجدول حتى تفعّله. وعند تعديل روتين مفعَّل تُحفظ التغييرات كمسودّة أيضًا، بينما تواصل النسخة العاملة التشغيل بالإعدادات القديمة: انقر **تحديث** لتطبيقها، أو **تجاهل التغييرات** للتخلّص منها. +الروتين الجديد مسودّة، ولا يعمل من تلقاء نفسه حتى تفعّله. وعند تعديل روتين مفعَّل تُحفظ التغييرات كمسودّة أيضًا، بينما تواصل النسخة العاملة التشغيل بالإعدادات القديمة: انقر **تحديث** لتطبيقها، أو **تجاهل التغييرات** للتخلّص منها. + +يُنفّذ **تشغيل الآن** مرة واحدة من دون انتظار المُشغِّل، وهو مفيد للتحقّق من المطالبة. ولا يمكن تشغيل الروتين يدويًا مرة أخرى قبل انتهاء تشغيله السابق. -يُنفّذ **تشغيل الآن** مرة واحدة من دون انتظار الجدول، وهو مفيد للتحقّق من المطالبة. ولا يمكن تشغيل الروتين يدويًا مرة أخرى قبل انتهاء تشغيله السابق. +وفي روتين يعمل بحدث من الموصِّل ولم يُفعَّل بعد، يعرض **تشغيل الآن** بدلًا من ذلك **بانتظار حدث**: أطلِق ذلك الحدث في التطبيق، فيستخدمه Teable لتشغيل واحد يظهر بعدها في سجل التشغيل. ولإنهاء الانتظار انقر **إيقاف الانتظار**. أما الروتين المفعَّل فيستقبل أحداثه أصلًا، فلا يحتاج إلى ذلك ولا يسمح به. -أوقف المفتاح لتعطيله؛ عندها يتوقّف الجدول عن الاستثارة، ويبقى سجل التشغيل الحالي كما هو. +أوقف المفتاح لتعطيله؛ عندها يتوقّف الروتين عن الاستثارة، ويبقى سجل التشغيل الحالي كما هو. ## سجل التشغيل -افتح الروتين وانتقل إلى **سجل التشغيل**. يمكن تصفية القائمة حسب الحالة والنطاق الزمني، وهو ما يساعد على تحديد إخفاق بعينه؛ وعند اختيار تشغيل تظهر أوقات التخطيط والبدء والانتهاء والمدة، إضافةً إلى محادثة ذلك التشغيل كاملة. +افتح الروتين وانتقل إلى **سجل التشغيل**. يمكن تصفية القائمة حسب الحالة والنطاق الزمني، وهو ما يساعد على تحديد إخفاق بعينه؛ وعند اختيار تشغيل يظهر **معرّف التشغيل** و**المُشغِّل** ومحادثة ذلك التشغيل كاملة. ويكون **المُشغِّل** إما **مجدول** أو **حدث** أو **يدوي**، ويعرض التشغيل المجدول إضافةً إلى ذلك الوقت **المخطط** الذي جرى من أجله. تُعرض حالات التشغيل كالآتي: **في قائمة الانتظار**، **قيد التشغيل**، **مكتمل**، **فشل**، **ملغى**. وتظهر **ملغى** حين يقاطع أحدهم ذلك التشغيل، أو حين يكون الروتين أو مشروعه قد حُذف. @@ -103,7 +113,7 @@ description: دع Cuppy ينفّذ مطالبة وفق جدول زمني، ور - نعم. بعد تثبيت القالب تُفعَّل روتيناته كما تُفعَّل مسارات العمل فيه. أما الجدول الذي لا موعد قادم له فيبقى مسودّة. + الروتينات المجدولة تعمل. فبعد تثبيت القالب تُفعَّل كما تُفعَّل سير العمل، ويبقى الجدول الذي لا موعد قادم له مسودّة. أما روتينات حدث الموصِّل فلا تُفعَّل تلقائيًا: إذ لا تنتقل بيانات الاعتماد مع القالب، فاختر حسابك أولًا ثم فعّله. diff --git a/ar/basic/automation/trigger/external/connector-event.mdx b/ar/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..75ef158f --- /dev/null +++ b/ar/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "عند تلقي حدث من الموصِّل" +description: "تشغيل سير العمل عندما يُبلغ تطبيق خارجي متصل عن حدث" +--- + +متاح في جميع خطط السحابة؛ أما الاستضافة الذاتية فتتطلّب خطة الأعمال أو أعلى، مع تفعيل أحداث الموصِّل من قِبل مَن يدير عملية النشر. + +ابدأ سير العمل انطلاقًا مما يحدث داخل تطبيق متصل مثل GitHub أو Gmail أو Slack: وصول رسالة بريد جديدة، أو فتح مشكلة، أو نشر رسالة. يسلّم التطبيق الحدث إلى Teable مباشرة، فلا تحتاج إلى استضافة عنوان Webhook ولا إلى الاستعلام الدوري عن التغييرات. + +## الإنشاء بالذكاء الاصطناعي + +افتح محادثة الذكاء الاصطناعي في الشريط الجانبي الأيمن لأي جدول واشرح ما تحتاج إليه. + +يتولّى الذكاء الاصطناعي كل شيء: يختار المُشغِّل المناسب، ويربط الحقول ذات الصلة، ويُعدّ الإجراءات. + +اشرح الهدف مرة واحدة ليصبح سير العمل جاهزًا من دون إعداد يدوي. + +**مثال:** *"عند فتح مشكلة جديدة في مستودع GitHub، أنشئ سجلًا في جدول المهام"* + +## كيفية الإعداد + + + + أنشئ سير عمل واختر **عند تلقي حدث من الموصِّل** مُشغِّلًا له. + + + اختر التطبيق ضمن **التطبيق**، ثم الحدث المحدّد ضمن **الحدث**. لكل حدث في القائمة وصف من سطر واحد وشارة، وتجد شرح الشارات أدناه. + + + اختر ضمن **الحساب** أيَّ حساب متصل يستقبل الحدث. وإن لم تكن قد وصلت هذا التطبيق من قبل، فوصِّله من القائمة نفسها: يُمنح الاتصال الجديد لسير العمل هذا تلقائيًا. + + + عبّئ **المعلمات** التي يطلبها الحدث، مثل مستودع أو قناة أو وسم. والحقول المعلّمة بـ * إلزامية. ثم انقر **حفظ**. + + + أضف الإجراءات التالية ثم شغّل سير العمل. يُنشأ الاشتراك عند التفعيل، لذا لا تستقبل المسودّة شيئًا. + + + +وعند تغيير التطبيق أو الحدث تُمسح الخطوات التالية، وتتوقّف المتغيرات التي كانت تشير إلى الحدث السابق عن العمل، فتحتاج تلك الخطوات إلى إعداد من جديد. + +## شارات الأحداث + +| الشارة | المعنى | +| --- | --- | +| **فوري** | يدفع التطبيق الحدث، فيصل بعد وقوعه بقليل | +| **استطلاع · قد يتأخر بضع دقائق** | يستعلم Teable من التطبيق دوريًا، فلا تعتمد على هذه الأحداث حين يكون التوقيت مهمًا | +| **يُشغَّل كثيرًا** | يقع هذا الحدث كثيرًا في الاستخدام الفعلي، وكل وقوع يُحتسب تشغيلًا للأتمتة | +| **مُهمَل** | أوقف التطبيق دعم هذا الحدث وقد يتوقف عن إرساله، فاختر حدثًا آخر | + +## البيانات المتاحة بعد الاستثارة + +يصل الحدث نفسه إلى المتغيّر **event**، وتُدرجه الخطوات التالية عبر **+**. وبعد الإعداد مباشرةً يكون المتغيّر فارغًا: إذ يجب أن يصل حدث حقيقي أولًا. انقر **اختبار المُشغِّل**، وحين تعرض اللوحة **بانتظار حدث** اذهب إلى التطبيق وأطلِق الحدث هناك. وقد يستغرق الحدث من نوع الاستطلاع بضع دقائق. + +ويبقى الحدث الواصل على المُشغِّل بوصفه بيانات نموذجية، فتستطيع الخطوات التالية الرجوع إلى حقوله. ولإنهاء الانتظار مبكرًا انقر **إيقاف الانتظار**؛ وبعد نحو 30 دقيقة من دون حدث تعرض اللوحة **توقف الانتظار دون وصول أي حدث.** + +## عند انقطاع الاتصال + +يتوقّف المُشغِّل عن استقبال الأحداث عند سحب منح الحساب، أو إزالة الحساب المتصل، أو إيقاف التطبيق للاشتراك (انتهاء صلاحية بيانات الاعتماد أو اشتراك غير سليم)، أو تعذّر إنشاء الاشتراك. ولا يُغلَق سير العمل نفسه، لكن لا يقع أي تشغيل جديد حتى تتم المعالجة. + +ويُرسل Teable إشعارًا إلى العضو الذي عدّل سير العمل آخر مرة، وتعرض لوحة المُشغِّل **غير متصل — أعد توصيل الحساب أو اختر حسابًا آخر**. وتختلف المعالجة بحسب السبب: + +- انقر **إعادة الربط** على الحساب نفسه ضمن **الإعدادات** ← **التكاملات**، فيُعاد بناء الاشتراك تلقائيًا. +- ولاستخدام حساب آخر، عُد إلى المُشغِّل واختر **الحساب** من جديد ثم احفظ. +- وإن تعذّر إنشاء الاشتراك، فتحقّق من المعلمات ثم احفظ مرة أخرى لإعادة المحاولة. + +## بعد النسخ أو الاستيراد + +لا تنتقل بيانات الاعتماد مع سير العمل. فبعد نسخ سير عمل، أو استيراد مشروع أو نسخه، يعرض المُشغِّل **الحساب غير مصرح به**: اختر حسابًا من حساباتك واحفظ ليتمكّن سير العمل من الاشتراك من جديد. + +## مستندات ذات صلة + +- [بيانات الاعتماد وعمليات التكامل](/ar/basic/credential) +- [روتين](/ar/basic/ai/routine) diff --git a/ar/basic/credential.mdx b/ar/basic/credential.mdx index 80b921fa..95693276 100644 --- a/ar/basic/credential.mdx +++ b/ar/basic/credential.mdx @@ -63,6 +63,12 @@ description: أدر اتصالاتك وأسرارك وامنحها للتطبي عند لصق قيمة تشبه المفتاح في أحد حقول الأتمتة، يحفظها Teable بوصفها سرًّا لك ويترك مكانها مرجعًا، فلا يصل النص الصريح إلى إعدادات سير العمل. وإذا أردت إبقاء النص كما هو، فانقر على **تراجع** في التنبيه. +## أرصدة استدعاءات التطبيقات الخارجية + +يستهلك استدعاء تطبيق خارجي عبر اتصال أرصدةَ المساحة، سواء جاء الاستدعاء من محادثة الذكاء الاصطناعي أو من تطبيق أو من أتمتة. وتظهر هذه الاستهلاكات في **ملخص استخدام الأرصدة** في صفحة الفوترة تحت النوع **تطبيقات الجهات الخارجية**. + +معظم التطبيقات تكلّف القليل جدًا في الاستدعاء الواحد. أما التطبيقات التي تحاسب Teable على كل عنصر مُعاد أو على كل طلب، مثل X، فتكلفة الاستدعاء الواحد فيها أعلى بوضوح. ولا تُحتسب الاستدعاءات الفاشلة، ولا البحث عن الأدوات المتاحة. وعند نفاد أرصدة المساحة تُرفض هذه الاستدعاءات. + ## بطاقات التفويض في محادثة الذكاء الاصطناعي عندما يحتاج الذكاء الاصطناعي إلى حساب خارجي، يثبّت في المحادثة بطاقة عنوانها **هذه المهمة تتطلب تفويضًا** وينتظر تصرّفك قبل أن تُكمل الجولة. والبطاقات نوعان، بحسب من يحتاج بيانات الاعتماد. diff --git a/de/basic/ai/routine.mdx b/de/basic/ai/routine.mdx index a923934a..45e28f2a 100644 --- a/de/basic/ai/routine.mdx +++ b/de/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Cuppy führt einen Prompt nach Zeitplan aus; das Ergebnis jedes Lau In allen Cloud-Plänen verfügbar; Self-Hosted erfordert Business oder höher. -Eine Routine übergibt Cuppy einen Prompt und wiederholt ihn nach Zeitplan. Das eignet sich für Arbeit, die niemand von Hand anstoßen soll: ein täglicher Bericht, das regelmäßige Aufräumen abgelaufener Datensätze, eine wöchentliche Auswertung. Jeder Lauf ist ein vollständiger KI-Chat, eine Routine kann also alles, was der KI-Chat kann, einschließlich Lesen und Schreiben von Tabellen, Aufrufen von Skills und Erzeugen von Dateien. +Eine Routine übergibt Cuppy einen Prompt und wiederholt ihn, entweder nach Zeitplan oder immer dann, wenn eine verbundene Drittanbieter-App ein Ereignis meldet. Das eignet sich für Arbeit, die niemand von Hand anstoßen soll: ein täglicher Bericht, das regelmäßige Aufräumen abgelaufener Datensätze, das Ablegen einer eingehenden E-Mail. Jeder Lauf ist ein vollständiger KI-Chat, eine Routine kann also alles, was der KI-Chat kann, einschließlich Lesen und Schreiben von Tabellen, Aufrufen von Skills und Erzeugen von Dateien. Eine Routine ist eine Ressource innerhalb eines Projekts und steht in der linken Seitenleiste neben Tabellen, Apps und Automatisierungen. -Eine Automatisierung wird durch ein Ereignis ausgelöst, etwa eine Datensatzänderung, ein Formular oder einen Webhook, und führt die Schritte aus, die Sie vorher konfiguriert haben. Eine Routine wird nur durch die Zeit ausgelöst und führt einen Prompt aus, den der Agent selbst auslegt. Nehmen Sie eine Automatisierung, wenn Sie feste Schritte und ein vorhersagbares Ergebnis brauchen; nehmen Sie eine Routine, wenn der Agent jedes Mal selbst entscheiden soll, was mit den aktuellen Daten zu tun ist. +Eine Automatisierung führt die Schritte aus, die Sie vorher konfiguriert haben, eine Routine dagegen einen Prompt, den der Agent selbst auslegt. Beide können nach Zeitplan ausgelöst werden, und beide durch ein Ereignis aus einer verbundenen Drittanbieter-App. Nehmen Sie eine Automatisierung, wenn Sie feste Schritte und ein vorhersagbares Ergebnis brauchen; nehmen Sie eine Routine, wenn der Agent jedes Mal selbst entscheiden soll, was mit den aktuellen Daten zu tun ist. ## Routine erstellen @@ -20,29 +20,37 @@ Eine Routine ist eine Ressource innerhalb eines Projekts und steht in der linken Beschreiben Sie unter **Prompt**, was jeder Lauf tun soll. Der Prompt ist die vollständige Anweisung für einen Lauf, nennen Sie also die Datenquelle, die Verarbeitung und das Ziel des Ergebnisses. Zum Beispiel: „Werte die Datensätze aus, die gestern in der Tabelle Aufgaben angelegt wurden, gruppiere sie nach zuständiger Person und schreibe die Auswertung in die Tabelle Tagesbericht.“ - - Wählen Sie unter **Zeitplan** eine Frequenz und setzen Sie bei Bedarf **Beginn** und **Ende (optional)**. + + Wählen Sie unter **Auslöser** entweder **Nach Zeitplan** oder **Bei Connector-Ereignis** und füllen Sie die Einstellungen der jeweiligen Art aus. - Klicken Sie auf **Aktivieren**. Die Konfiguration muss gespeichert sein, und der Zeitplan muss einen künftigen Termin enthalten. + Klicken Sie auf **Aktivieren**. Die Konfiguration muss gespeichert sein: **Nach Zeitplan** braucht einen künftigen Termin, **Bei Connector-Ereignis** ein nutzbares Konto. ## Einstellungen -Neben Prompt und Zeitplan enthält das Formular diese Einstellungen: +Neben Prompt und Auslöser enthält das Formular diese Einstellungen: | Einstellung | Beschreibung | | --- | --- | | **Modell** | Modell und Denkstufe dieser Routine. Bei **Standardmodell** gilt das Standard-Chatmodell des Space | | **Chat** | **Neuer Chat für jeden Lauf** hält die Läufe voneinander unabhängig; **Chat des vorherigen Laufs fortsetzen** trägt den Kontext früherer Läufe weiter und eignet sich für Aufgaben, die auf das letzte Ergebnis Bezug nehmen | -| **Beginn** / **Ende (optional)** | Die Grenzen des Zeitplans. Ohne Endzeit läuft die Routine unbegrenzt weiter | +| **Beginn** / **Ende (optional)** | Die Grenzen des Zeitplans, nur für **Nach Zeitplan**. Ohne Endzeit läuft die Routine unbegrenzt weiter | Modell und Denkstufe werden beim Speichern mit festgehalten, deshalb zeigt der Ausführungsverlauf, womit ein Lauf tatsächlich gelaufen ist. +### Auslöser + +**Nach Zeitplan** führt die Routine zu den Zeiten aus, die Sie festlegen; die Einstellungen dazu stehen unten unter Zeitplan. + +**Bei Connector-Ereignis** führt sie einmal aus, sobald eine verbundene Drittanbieter-App ein Ereignis meldet, etwa eine neue E-Mail oder ein neues Issue. Wählen Sie die App, das Ereignis, das **Konto**, das es empfängt, und die Parameter, die das Ereignis verlangt; konfiguriert wird das genau wie der Auslöser der Automatisierung, beschrieben unter [Wenn ein Connector-Ereignis eingeht](/de/basic/automation/trigger/external/connector-event). Eine Routine mit diesem Auslöser hat keine **Nächste Ausführung** und nutzt weder den Zeitplan noch dessen Grenzen. + +Wird die Freigabe des Kontos entzogen, das verbundene Konto entfernt oder das Abonnement von der App gestoppt, meldet die Routine **Abonnement getrennt** und empfängt keine Ereignisse mehr; Teable benachrichtigt das Mitglied, das sie zuletzt aktualisiert hat. Verbinden Sie dasselbe Konto erneut, baut sich das Abonnement von selbst wieder auf; für ein anderes Konto wählen Sie es im Auslöser aus und speichern. + ### Zeitplan -Wählen Sie eine Frequenz aus den Vorlagen: **Stündlich** zu einer bestimmten Minute, **Täglich** und **Werktags** zu einer bestimmten Uhrzeit, **Wöchentlich** an einem Wochentag mit Uhrzeit, **Monatlich** an einem Tag mit Uhrzeit. +Der Zeitplan gilt nur für **Nach Zeitplan**. Wählen Sie eine Frequenz aus den Vorlagen: **Stündlich** zu einer bestimmten Minute, **Täglich** und **Werktags** zu einer bestimmten Uhrzeit, **Wöchentlich** an einem Wochentag mit Uhrzeit, **Monatlich** an einem Tag mit Uhrzeit. Für alles Genauere wählen Sie **Benutzerdefiniert (RRULE)** und schreiben eine RFC-5545-Regel, etwa `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. Für eigene Regeln gelten diese Grenzen: @@ -56,15 +64,17 @@ Ein Zeitplan wird in der Zeitzone der Person ausgewertet, die die Routine angele ## Entwurf, Aktualisierung und sofortige Ausführung -Eine neue Routine ist ein Entwurf und läuft erst nach dem Aktivieren nach Zeitplan. Bearbeiten Sie eine aktive Routine, wird die Änderung ebenfalls als Entwurf gespeichert, während die aktive Fassung weiter mit der alten Konfiguration läuft: Mit **Aktualisieren** übernehmen Sie sie, mit **Änderungen verwerfen** verwerfen Sie sie. +Eine neue Routine ist ein Entwurf und läuft erst nach dem Aktivieren von selbst. Bearbeiten Sie eine aktive Routine, wird die Änderung ebenfalls als Entwurf gespeichert, während die aktive Fassung weiter mit der alten Konfiguration läuft: Mit **Aktualisieren** übernehmen Sie sie, mit **Änderungen verwerfen** verwerfen Sie sie. + +**Jetzt ausführen** führt einmal aus, ohne auf den Auslöser zu warten; das eignet sich zum Prüfen eines Prompts. Solange der vorherige Lauf nicht beendet ist, lässt sich eine Routine nicht erneut von Hand starten. -**Jetzt ausführen** führt einmal aus, ohne auf den Zeitplan zu warten; das eignet sich zum Prüfen eines Prompts. Solange der vorherige Lauf nicht beendet ist, lässt sich eine Routine nicht erneut von Hand starten. +Bei einer noch nicht aktivierten Routine mit Connector-Ereignis zeigt **Jetzt ausführen** stattdessen **Warten auf ein Ereignis**: Lösen Sie das Ereignis in der App aus, und Teable führt die Routine mit dem eingehenden Ereignis einmal aus; der Lauf erscheint dann im Ausführungsverlauf. Mit **Nicht mehr warten** brechen Sie das Warten ab. Eine aktive Routine empfängt ihre Ereignisse ohnehin und braucht das weder, noch lässt sie es zu. -Zum Deaktivieren schalten Sie den Schalter aus. Der Zeitplan löst dann nicht mehr aus, der bestehende Ausführungsverlauf bleibt erhalten. +Zum Deaktivieren schalten Sie den Schalter aus. Die Routine löst dann nicht mehr aus, der bestehende Ausführungsverlauf bleibt erhalten. ## Ausführungsverlauf -Öffnen Sie die Routine und wechseln Sie zu **Ausführungsverlauf**. Die Liste lässt sich nach Status und Zeitraum filtern, was das Auffinden eines bestimmten Fehlschlags erleichtert; zu einem ausgewählten Lauf sehen Sie geplante, gestartete und beendete Zeit, die Dauer sowie den vollständigen Chat dieses Laufs. +Öffnen Sie die Routine und wechseln Sie zu **Ausführungsverlauf**. Die Liste lässt sich nach Status und Zeitraum filtern, was das Auffinden eines bestimmten Fehlschlags erleichtert; zu einem ausgewählten Lauf sehen Sie die **Lauf-ID**, den **Auslöser** und den vollständigen Chat dieses Laufs. Der **Auslöser** steht auf **Geplant**, **Ereignis** oder **Manuell**; ein geplanter Lauf zeigt zusätzlich unter **Geplant** den Termin an, den er bedient hat. Läufe werden als **In der Warteschlange**, **Läuft**, **Abgeschlossen**, **Fehlgeschlagen** oder **Abgebrochen** ausgewiesen. **Abgebrochen** erscheint, wenn jemand den Lauf unterbrochen hat oder wenn die Routine oder ihr Projekt gelöscht wurde. @@ -103,7 +113,7 @@ Nicht jeder erfolglose Lauf zählt dabei mit: Läufe, die übersprungen wurden, - Ja. Nach der Installation einer Vorlage werden deren Routinen ebenso eingeschaltet wie deren Workflows. Ein Zeitplan ohne künftigen Termin bleibt ein Entwurf. + Geplante schon. Nach der Installation einer Vorlage werden sie ebenso eingeschaltet wie deren Workflows, und ein Zeitplan ohne künftigen Termin bleibt ein Entwurf. Routinen mit Connector-Ereignis werden nicht eingeschaltet: Zugangsdaten kommen mit einer Vorlage nicht mit, wählen Sie also erst ein eigenes Konto aus. diff --git a/de/basic/automation/trigger/external/connector-event.mdx b/de/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..1f9297c8 --- /dev/null +++ b/de/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "Wenn ein Connector-Ereignis eingeht" +description: "Einen Workflow starten, wenn eine verbundene Drittanbieter-App ein Ereignis meldet" +--- + +In allen Cloud-Tarifen verfügbar; Self-Hosted erfordert Business oder höher, und der Betreiber der Installation muss Connector-Ereignisse einschalten. + +Starten Sie einen Workflow aus etwas, das in einer verbundenen App wie GitHub, Gmail oder Slack passiert: eine neue E-Mail kommt an, ein Issue wird eröffnet, eine Nachricht wird gepostet. Die App liefert das Ereignis direkt an Teable, Sie müssen also keine Webhook-URL betreiben und nichts abfragen. + +## Mit KI erstellen + +Öffnen Sie den KI-Chat in der rechten Seitenleiste einer beliebigen Tabelle und beschreiben Sie, was Sie brauchen. + +Die KI erledigt den Rest: Sie wählt den passenden Auslöser, ordnet die betroffenen Felder zu und richtet die Aktionen ein. + +Beschreiben Sie das Ziel einmal, und der Workflow steht, ganz ohne manuelle Konfiguration. + +**Beispiel:** *"Wenn in meinem GitHub-Repository ein neues Issue eröffnet wird, lege einen Datensatz in der Tabelle Aufgaben an"* + +## So richten Sie es ein + + + + Legen Sie einen Workflow an und wählen Sie **Wenn ein Connector-Ereignis eingeht** als Auslöser. + + + Wählen Sie die App unter **App** und danach das konkrete Ereignis unter **Ereignis**. Jedes Ereignis in der Liste trägt eine kurze Beschreibung und ein Kennzeichen; die Kennzeichen sind unten erklärt. + + + Wählen Sie unter **Konto**, welches verbundene Konto das Ereignis empfängt. Haben Sie diese App noch nie verbunden, verbinden Sie sie aus derselben Auswahl heraus: die neue Verbindung wird dem Workflow automatisch freigegeben. + + + Füllen Sie die **Parameter** aus, die das Ereignis verlangt, etwa ein Repository, einen Kanal oder ein Label. Mit * markierte Felder sind Pflicht. Klicken Sie danach auf **Speichern**. + + + Ergänzen Sie die folgenden Aktionen und schalten Sie den Workflow ein. Das Abonnement entsteht erst beim Aktivieren, ein Entwurf empfängt also nichts. + + + +Wechseln Sie App oder Ereignis, werden die nachfolgenden Schritte geleert, und Variablen, die auf das vorherige Ereignis verwiesen, lassen sich nicht mehr auflösen; diese Schritte müssen dann neu konfiguriert werden. + +## Kennzeichen der Ereignisse + +| Kennzeichen | Bedeutung | +| --- | --- | +| **Sofort** | Die App schickt das Ereignis, es trifft kurz nach seinem Eintreten ein | +| **Abfrage · kann einige Minuten dauern** | Teable fragt die App regelmäßig ab; verlassen Sie sich darauf nicht, wenn es auf das Timing ankommt | +| **Löst häufig aus** | Dieses Ereignis tritt in der Praxis oft ein, und jedes Auslösen zählt als Automatisierungslauf | +| **Veraltet** | Die App hat das Ereignis als veraltet markiert und sendet es möglicherweise nicht mehr; wählen Sie ein anderes | + +## Daten nach dem Auslösen + +Das Ereignis selbst landet in der Variable **event**, die nachfolgende Schritte über **+** einfügen. Direkt nach dem Konfigurieren ist die Variable noch leer: es muss erst ein echtes Ereignis eintreffen. Klicken Sie auf **Auslöser testen**, und sobald das Panel **Warten auf ein Ereignis** zeigt, lösen Sie es in der App aus. Bei einem Abfrage-Ereignis kann das einige Minuten dauern. + +Das eingetroffene Ereignis bleibt als Beispieldatensatz am Auslöser, sodass die folgenden Schritte seine Felder ansprechen können. Mit **Nicht mehr warten** brechen Sie früher ab; nach etwa 30 Minuten ohne Ereignis meldet das Panel **Das Warten wurde beendet, ohne dass ein Ereignis eingetroffen ist.** + +## Wenn die Verbindung abreißt + +Der Auslöser empfängt keine Ereignisse mehr, wenn die Freigabe des Kontos entzogen wird, das verbundene Konto entfernt wird, die App das Abonnement stoppt (abgelaufene Zugangsdaten oder ein nicht funktionierendes Abonnement) oder das Abonnement nicht angelegt werden konnte. Der Workflow selbst wird nicht abgeschaltet, es läuft aber nichts Neues, bis er wiederhergestellt ist. + +Teable benachrichtigt das Mitglied, das den Workflow zuletzt bearbeitet hat, und das Auslöser-Panel zeigt **Getrennt – verbinden Sie das Konto erneut oder wählen Sie ein anderes**. Je nach Ursache stellen Sie ihn so wieder her: + +- Klicken Sie unter **Einstellungen** → **Integrationen** bei demselben Konto auf **Neu verbinden**; das Abonnement baut sich von selbst wieder auf. +- Für ein anderes Konto gehen Sie zurück zum Auslöser, wählen ein anderes **Konto** und speichern. +- Ließ sich das Abonnement nicht anlegen, prüfen Sie die Parameter und speichern erneut, um es nochmals zu versuchen. + +## Nach einer Kopie oder einem Import + +Zugangsdaten wandern nicht mit einem Workflow mit. Nachdem Sie einen Workflow kopiert oder ein Projekt importiert oder kopiert haben, meldet der Auslöser **Konto nicht autorisiert**: Wählen Sie eines Ihrer eigenen Konten und speichern Sie, bevor der Workflow wieder abonnieren kann. + +## Verwandte Dokumente + +- [Zugangsdaten und Integrationen](/de/basic/credential) +- [Routine](/de/basic/ai/routine) diff --git a/de/basic/credential.mdx b/de/basic/credential.mdx index 0be03d7d..14ceba57 100644 --- a/de/basic/credential.mdx +++ b/de/basic/credential.mdx @@ -63,6 +63,12 @@ Solange ein Projekt noch nicht verbundene Integrationen hat, erscheint oben auf Fügen Sie in ein Eingabefeld einer Automatisierung etwas ein, das wie ein Schlüssel aussieht, speichert Teable es als Ihr Secret und lässt an der Stelle einen Verweis stehen, sodass der Klartext nicht in der Workflow-Konfiguration landet. Soll der Text so bleiben, wie Sie ihn eingefügt haben, klicken Sie im Hinweis auf **Rückgängig**. +## Guthaben für Aufrufe von Drittanbieter-Apps + +Ein Aufruf einer Drittanbieter-App über eine Verbindung verbraucht Guthaben des Space, gleich ob er aus dem KI-Chat, einer App oder einer Automatisierung kommt. Auf der Abrechnungsseite stehen diese Posten in der **Guthabenübersicht** unter dem Typ **Drittanbieter-Apps**. + +Die meisten Apps kosten pro Aufruf sehr wenig. Apps, die Teable pro zurückgegebener Ressource oder pro Anfrage abrechnen, etwa X, kosten für einen einzelnen Aufruf deutlich mehr. Fehlgeschlagene Aufrufe werden nicht berechnet, das Nachschlagen verfügbarer Tools ebenso wenig. Ist das Guthaben des Space aufgebraucht, werden solche Aufrufe abgelehnt. + ## Autorisierungskarten im KI-Chat Braucht die KI ein externes Konto, heftet sie eine Karte mit der Überschrift **Für diese Aufgabe ist eine Autorisierung erforderlich** an die Unterhaltung und wartet, bevor der Durchlauf weitergeht. Welche Karte erscheint, hängt davon ab, wer die Zugangsdaten braucht. diff --git a/docs.json b/docs.json index e14e7884..b6d4c9c5 100644 --- a/docs.json +++ b/docs.json @@ -597,6 +597,7 @@ "en/basic/automation/trigger/external/scheduled-time", "en/basic/automation/trigger/forms/button-click", "en/basic/automation/trigger/external/webhook-received", + "en/basic/automation/trigger/external/connector-event", { "group": "When email received", "pages": [ @@ -974,6 +975,7 @@ "zh/basic/automation/trigger/external/scheduled-time", "zh/basic/automation/trigger/forms/button-click", "zh/basic/automation/trigger/external/webhook-received", + "zh/basic/automation/trigger/external/connector-event", { "group": "邮件接收时", "pages": [ @@ -1351,6 +1353,7 @@ "ru/basic/automation/trigger/external/scheduled-time", "ru/basic/automation/trigger/forms/button-click", "ru/basic/automation/trigger/external/webhook-received", + "ru/basic/automation/trigger/external/connector-event", { "group": "При получении письма", "pages": [ @@ -1727,6 +1730,7 @@ "de/basic/automation/trigger/external/scheduled-time", "de/basic/automation/trigger/forms/button-click", "de/basic/automation/trigger/external/webhook-received", + "de/basic/automation/trigger/external/connector-event", { "group": "Beim Eingang einer E-Mail", "pages": [ @@ -2103,6 +2107,7 @@ "fr/basic/automation/trigger/external/scheduled-time", "fr/basic/automation/trigger/forms/button-click", "fr/basic/automation/trigger/external/webhook-received", + "fr/basic/automation/trigger/external/connector-event", { "group": "À la réception d’un e-mail", "pages": [ @@ -2479,6 +2484,7 @@ "es/basic/automation/trigger/external/scheduled-time", "es/basic/automation/trigger/forms/button-click", "es/basic/automation/trigger/external/webhook-received", + "es/basic/automation/trigger/external/connector-event", { "group": "Al recibir un correo electrónico", "pages": [ @@ -2855,6 +2861,7 @@ "it/basic/automation/trigger/external/scheduled-time", "it/basic/automation/trigger/forms/button-click", "it/basic/automation/trigger/external/webhook-received", + "it/basic/automation/trigger/external/connector-event", { "group": "Alla ricezione di un'email", "pages": [ @@ -3231,6 +3238,7 @@ "ja/basic/automation/trigger/external/scheduled-time", "ja/basic/automation/trigger/forms/button-click", "ja/basic/automation/trigger/external/webhook-received", + "ja/basic/automation/trigger/external/connector-event", { "group": "メール受信時", "pages": [ @@ -3607,6 +3615,7 @@ "tr/basic/automation/trigger/external/scheduled-time", "tr/basic/automation/trigger/forms/button-click", "tr/basic/automation/trigger/external/webhook-received", + "tr/basic/automation/trigger/external/connector-event", { "group": "E-posta alındığında", "pages": [ @@ -3983,6 +3992,7 @@ "uk/basic/automation/trigger/external/scheduled-time", "uk/basic/automation/trigger/forms/button-click", "uk/basic/automation/trigger/external/webhook-received", + "uk/basic/automation/trigger/external/connector-event", { "group": "Після отримання листа", "pages": [ @@ -4359,6 +4369,7 @@ "ar/basic/automation/trigger/external/scheduled-time", "ar/basic/automation/trigger/forms/button-click", "ar/basic/automation/trigger/external/webhook-received", + "ar/basic/automation/trigger/external/connector-event", { "group": "عند استلام بريد إلكتروني", "pages": [ diff --git a/en/basic/ai/routine.mdx b/en/basic/ai/routine.mdx index 26149109..06a49303 100644 --- a/en/basic/ai/routine.mdx +++ b/en/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Let Cuppy run a prompt on a schedule and review the result of every Available on all Cloud plans; Self-Hosted requires Business or higher. -A routine hands a prompt to Cuppy and repeats it on a schedule, which suits work that nobody needs to trigger by hand: a daily report, a periodic cleanup of expired records, a weekly roll-up. Every run is a full AI chat, so a routine can do everything AI chat can, including reading and writing tables, calling skills, and producing files. +A routine hands a prompt to Cuppy and repeats it, either on a schedule or whenever a connected third-party app reports an event. That suits work nobody needs to trigger by hand: a daily report, a periodic cleanup of expired records, filing a new email as it arrives. Every run is a full AI chat, so a routine can do everything AI chat can, including reading and writing tables, calling skills, and producing files. A routine is a resource inside a project and sits in the left sidebar next to tables, apps, and automations. -An automation fires on an event such as a record change, a form submission, or a webhook, and runs the steps you configured in advance. A routine fires only on time, and runs a prompt the agent interprets itself. Use an automation when you need fixed steps and predictable output; use a routine when you want the agent to decide what to do with the current data each time. +An automation runs the steps you configured in advance, while a routine runs a prompt the agent interprets itself. Both can fire on a schedule, and both can fire on an event from a connected third-party app. Use an automation when you need fixed steps and predictable output; use a routine when you want the agent to decide what to do with the current data each time. ## Create a Routine @@ -20,29 +20,37 @@ A routine is a resource inside a project and sits in the left sidebar next to ta Describe what each run should do in **Prompt**. The prompt is the entire instruction for a run, so state where the data comes from, how to process it, and where the result goes. For example, "Summarize records added to the Tasks table yesterday, group them by owner, and write the summary to the Daily Report table." - - Choose a frequency under **Schedule**, and set **Starting** and **Ending (optional)** as needed. + + Under **Trigger**, choose **On a schedule** or **On a connector event**, then fill in the settings that kind needs. - Click **Activate**. The configuration must be saved first, and the schedule must have a future occurrence. + Click **Activate**. The configuration must be saved first: **On a schedule** needs a future occurrence, and **On a connector event** needs a usable account. ## Settings -Besides the prompt and the schedule, the form carries these settings: +Besides the prompt and the trigger, the form carries these settings: | Setting | Description | | --- | --- | | **Model** | The model and effort level this routine runs on. Leave **Default model** to use the space's default chat model | | **Chat** | **New chat for every run** keeps runs independent of each other; **Continue the previous run's chat** carries the context of earlier runs forward, which suits work that needs to refer to the last result | -| **Starting** / **Ending (optional)** | The bounds of the schedule. Without an end time the routine keeps running indefinitely | +| **Starting** / **Ending (optional)** | The bounds of the schedule, used by **On a schedule** only. Without an end time the routine keeps running indefinitely | The model and effort level are recorded when you save, so run history shows what each run actually used. +### Trigger + +**On a schedule** runs the routine at the times you set, configured under Schedule below. + +**On a connector event** runs it once whenever a connected third-party app reports an event, such as a new email or a new issue. Pick the app, the event, the **Account** that receives it, and whatever parameters the event takes; it is configured exactly like the automation trigger, described in [When Connector Event Received](/en/basic/automation/trigger/external/connector-event). A routine on this trigger has no **Next run** time and uses neither the schedule nor the bounds. + +If the account grant is revoked, the connected account is removed, or the app stops the subscription, the routine reports **Subscription disconnected** and stops receiving events, and Teable notifies the member who last updated it. Reconnecting the same account rebuilds the subscription on its own; to use a different one, pick another account and save. + ### Schedule -Pick a frequency from the presets: **Hourly** at a given minute, **Daily** and **Weekdays** at a given time, **Weekly** on a weekday and time, **Monthly** on a day and time. +The schedule is used by **On a schedule** only. Pick a frequency from the presets: **Hourly** at a given minute, **Daily** and **Weekdays** at a given time, **Weekly** on a weekday and time, **Monthly** on a day and time. For anything more specific, choose **Custom (RRULE)** and write an RFC 5545 rule, such as `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. A custom rule has these limits: @@ -56,15 +64,17 @@ A schedule is evaluated in the timezone of whoever created the routine and does ## Drafts, Updates, and Running Now -A new routine is a draft and does not run on schedule until you activate it. When you edit an active routine, the change is also saved as a draft while the live version keeps running on the old configuration: click **Update** to apply it, or **Discard changes** to drop it. +A new routine is a draft and does not run by itself until you activate it. When you edit an active routine, the change is also saved as a draft while the live version keeps running on the old configuration: click **Update** to apply it, or **Discard changes** to drop it. + +**Run now** executes once without waiting for the trigger, which is useful for checking a prompt. A routine cannot be run by hand again until its previous run has finished. -**Run now** executes once without waiting for the schedule, which is useful for checking a prompt. A routine cannot be run by hand again until its previous run has finished. +On a connector-event routine that is not yet active, **Run now** shows **Waiting for an event** instead: go into the app and do something that fires the event, and Teable uses the one it receives for a single run, which then appears in run history. Click **Stop waiting** to end the wait early. An active routine already receives its events, so it neither needs nor allows this. -Turn the switch off to deactivate. The schedule stops firing, and existing run history is kept. +Turn the switch off to deactivate. The routine stops firing, and existing run history is kept. ## Run History -Open the routine and switch to **Run history**. The run list can be filtered by status and time range, which helps locate a particular failure; selecting a run shows its planned, started, and finished times, its duration, and the full conversation of that run. +Open the routine and switch to **Run history**. The run list can be filtered by status and time range, which helps locate a particular failure; selecting a run shows its **Run ID**, its **Trigger**, and the full conversation of that run. **Trigger** reads **Scheduled**, **Event**, or **Manual**, and a **Scheduled** run also shows the **Planned** time it served. Runs are reported as **Queued**, **Running**, **Completed**, **Failed**, or **Canceled**. **Canceled** appears when someone interrupted that run, or when the routine or its project has been deleted. @@ -103,7 +113,7 @@ Not every unsuccessful run counts toward that total: runs skipped because the pr - Yes. After a template install its routines are switched on the way its workflows are. A schedule with no future occurrence stays a draft. + Scheduled ones do. After a template install they are switched on the way its workflows are, and a schedule with no future occurrence stays a draft. Connector-event routines are not switched on: credentials do not come over with a template, so pick one of your own accounts before activating. diff --git a/en/basic/automation/trigger/external/connector-event.mdx b/en/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..48dc9abf --- /dev/null +++ b/en/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "When Connector Event Received" +description: "Run a workflow when a connected third-party app reports an event" +--- + +Available on all Cloud plans; Self-Hosted requires Business or higher, with connector events turned on by whoever runs the deployment. + +Start a workflow from something that happens inside a connected app such as GitHub, Gmail, or Slack: a new email arrives, an issue is opened, a message is posted. The app delivers the event to Teable directly, so you do not have to host a webhook URL or poll for changes. + +## Build with AI + +Open AI chat in the right sidebar of any table and describe what you need. + +AI handles everything: it picks the right trigger, maps the relevant fields, and sets up the actions. + +Describe the goal once and the workflow is ready, with no manual configuration. + +**Example:** *"When a new issue is opened in my GitHub repo, create a record in the Tasks table"* + +## How to Set It Up + + + + Create a workflow and choose **When connector event received** as the trigger. + + + Pick the app under **App**, then the specific event under **Event**. Every event in the list carries a one-line summary and a badge; the badges are explained below. + + + Under **Account**, pick which connected account receives the event. If you have never connected this app, connect it from the same dropdown: the new connection is granted to this workflow automatically. + + + Fill in the **Parameters** the event needs, such as a repository, a channel, or a label. Fields marked * are required. Click **Save** when you are done. + + + Add the actions that follow, then turn the workflow on. The subscription is created when the workflow is activated, so a draft receives nothing. + + + +Changing the app or the event clears the steps after the trigger, and variables that referenced the previous event stop resolving, so those steps have to be configured again. + +## Event Badges + +| Badge | What it means | +| --- | --- | +| **Instant** | The app pushes the event, which arrives shortly after it happens | +| **Polling · may take a few minutes** | Teable asks the app periodically, so do not rely on these events where timing matters | +| **High volume** | This event fires often in practice, and every firing counts as an automation run | +| **Deprecated** | The app has deprecated this event and may stop sending it, so choose another one | + +## Data Available After the Trigger + +The event itself lands in the **event** variable, which later steps insert through **+**. The variable is empty right after you configure the trigger: an actual event has to arrive first. Click **Test trigger**, and once the panel shows **Waiting for an event**, go into the app and do something that fires it. A polling event may take a few minutes. + +The event that arrives stays on the trigger as sample data, so later steps can reference its fields. Click **Stop waiting** to end the wait early; after about 30 minutes without an event the panel reports **Stopped waiting. No event arrived.** + +## When the Connection Drops + +The trigger stops receiving events when the account grant is revoked, the connected account is removed, the app stops the subscription (expired credentials or an unhealthy subscription), or the subscription could not be created. The workflow itself is not switched off, but nothing new runs until it is restored. + +Teable notifies the member who last edited the workflow, and the trigger panel shows **Disconnected — reconnect the account or pick another one**. Restore it according to the cause: + +- Click **Reconnect** on the same account under **Settings** → **Integrations**, and the subscription is rebuilt on its own. +- To use a different account, go back to the trigger, pick another **Account**, and save. +- When the subscription failed to be created, check the parameters and save again to retry. + +## After a Copy or an Import + +Credentials do not travel with a workflow. After you copy a workflow, or import or copy a project, the trigger reads **Account not authorized**: pick one of your own accounts and save before the workflow can subscribe again. + +## Related Docs + +- [Credentials and Integrations](/en/basic/credential) +- [Routine](/en/basic/ai/routine) diff --git a/en/basic/credential.mdx b/en/basic/credential.mdx index 0a56bb76..58244660 100644 --- a/en/basic/credential.mdx +++ b/en/basic/credential.mdx @@ -63,6 +63,12 @@ When a project still has integrations that are not connected, a strip at the top Paste something that looks like a key into an automation input field and Teable stores it as your secret, leaving a reference in place, so the plaintext never lands in the workflow configuration. Click **Undo** in the notice if you would rather keep the text as typed. +## Credits for Third-Party App Calls + +Calling a third-party app through a connection consumes the space's credits, whether the call comes from AI chat, an app, or an automation. These charges are listed under type **Third-party apps** in **Credit usage summary** on the billing page. + +Most apps cost very little per call. Apps that bill Teable per returned resource or per request, such as X, cost noticeably more for a single call. Failed calls are not charged, and neither is looking up available tools. Once the space runs out of credits, these calls are refused. + ## Authorization Cards in AI Chat When AI needs an external account, it pins a card headed **Authorization required for this task** to the conversation and waits for you before the turn goes on. Which card you get depends on who needs the credential. diff --git a/es/basic/ai/routine.mdx b/es/basic/ai/routine.mdx index 97a9e592..b5a459a7 100644 --- a/es/basic/ai/routine.mdx +++ b/es/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Deja que Cuppy ejecute un prompt según una programación y revisa Disponible en todos los planes de Cloud; la versión autoalojada requiere el plan Business o uno superior. -Una rutina entrega un prompt a Cuppy y lo repite según una programación, lo que encaja con el trabajo que nadie debería lanzar a mano: un informe diario, una limpieza periódica de registros caducados, un resumen semanal. Cada ejecución es un chat de IA completo, así que una rutina puede hacer todo lo que hace el chat de IA, incluido leer y escribir tablas, invocar habilidades y generar archivos. +Una rutina entrega un prompt a Cuppy y lo repite, ya sea según una programación o cada vez que una app de terceros conectada informa un evento. Eso encaja con el trabajo que nadie debería lanzar a mano: un informe diario, una limpieza periódica de registros caducados, archivar un correo en cuanto llega. Cada ejecución es un chat de IA completo, así que una rutina puede hacer todo lo que hace el chat de IA, incluido leer y escribir tablas, invocar habilidades y generar archivos. Una rutina es un recurso dentro de un proyecto y aparece en la barra lateral izquierda junto a las tablas, las aplicaciones y las automatizaciones. -Una automatización se dispara con un evento, como un cambio en un registro, el envío de un formulario o un webhook, y ejecuta los pasos que configuraste de antemano. Una rutina se dispara solo con el tiempo y ejecuta un prompt que el agente interpreta por su cuenta. Usa una automatización cuando necesites pasos fijos y un resultado previsible; usa una rutina cuando quieras que el agente decida cada vez qué hacer con los datos actuales. +Una automatización ejecuta los pasos que configuraste de antemano, mientras que una rutina ejecuta un prompt que el agente interpreta por su cuenta. Ambas pueden dispararse según una programación y ambas pueden dispararse con un evento de una app de terceros conectada. Usa una automatización cuando necesites pasos fijos y un resultado previsible; usa una rutina cuando quieras que el agente decida cada vez qué hacer con los datos actuales. ## Crear una rutina @@ -20,29 +20,37 @@ Una rutina es un recurso dentro de un proyecto y aparece en la barra lateral izq Describe en **Prompt** lo que debe hacer cada ejecución. El prompt es la instrucción completa de una ejecución, así que indica de dónde salen los datos, cómo procesarlos y dónde va el resultado. Por ejemplo: «Resume los registros añadidos ayer a la tabla Tareas, agrúpalos por responsable y escribe el resumen en la tabla Informe diario». - - Elige una frecuencia en **Programación** y define **Inicio** y **Fin (opcional)** si lo necesitas. + + En **Activador**, elige **Según programación** o **Por evento de conector** y rellena los ajustes que pide cada opción. - Haz clic en **Activar**. La configuración debe estar guardada y la programación debe tener alguna ocurrencia futura. + Haz clic en **Activar**. La configuración debe estar guardada: **Según programación** necesita alguna ocurrencia futura y **Por evento de conector** necesita una cuenta utilizable. ## Ajustes -Además del prompt y la programación, el formulario incluye estos ajustes: +Además del prompt y el activador, el formulario incluye estos ajustes: | Ajuste | Descripción | | --- | --- | | **Modelo** | El modelo y el nivel de inteligencia con los que se ejecuta esta rutina. Deja **Modelo predeterminado** para usar el modelo de chat predeterminado del espacio | | **Chat** | **Nuevo chat en cada ejecución** mantiene las ejecuciones independientes entre sí; **Continuar el chat de la ejecución anterior** arrastra el contexto de las ejecuciones previas, lo que encaja con el trabajo que necesita consultar el resultado anterior | -| **Inicio** / **Fin (opcional)** | Los límites de la programación. Sin hora de fin, la rutina sigue ejecutándose de forma indefinida | +| **Inicio** / **Fin (opcional)** | Los límites de la programación, solo para **Según programación**. Sin hora de fin, la rutina sigue ejecutándose de forma indefinida | El modelo y el nivel de inteligencia quedan registrados al guardar, por eso el historial de ejecuciones muestra con qué se ejecutó realmente cada una. +### Activador + +**Según programación** ejecuta la rutina en los horarios que definas, configurados más abajo en Programación. + +**Por evento de conector** la ejecuta una vez cada vez que una app de terceros conectada informa un evento, como un correo nuevo o una incidencia nueva. Elige la app, el evento, la **Cuenta** que lo recibe y los parámetros que pida el evento; se configura igual que el activador de la automatización, descrito en [Al recibir un evento de conector](/es/basic/automation/trigger/external/connector-event). Una rutina con este activador no tiene hora de **Próxima ejecución** y no usa la programación ni sus límites. + +Si se revoca la concesión de la cuenta, se elimina la cuenta conectada o la app detiene la suscripción, la rutina muestra **Suscripción desconectada** y deja de recibir eventos, y Teable avisa al miembro que la actualizó por última vez. Al volver a conectar la misma cuenta, la suscripción se reconstruye sola; para usar otra cuenta, selecciónala en el activador y guarda. + ### Programación -Elige una frecuencia entre los ajustes preestablecidos: **Cada hora** en un minuto concreto, **Cada día** y **Días laborables** a una hora concreta, **Cada semana** en un día de la semana y una hora, **Cada mes** en un día y una hora. +La programación solo se usa con **Según programación**. Elige una frecuencia entre los ajustes preestablecidos: **Cada hora** en un minuto concreto, **Cada día** y **Días laborables** a una hora concreta, **Cada semana** en un día de la semana y una hora, **Cada mes** en un día y una hora. Para algo más específico, elige **Personalizada (RRULE)** y escribe una regla RFC 5545, como `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. Una regla personalizada tiene estos límites: @@ -56,15 +64,17 @@ Una programación se evalúa en la zona horaria de quien creó la rutina y no si ## Borradores, actualizaciones y ejecución inmediata -Una rutina nueva es un borrador y no se ejecuta según la programación hasta que la activas. Cuando editas una rutina activa, el cambio también se guarda como borrador mientras la versión en curso sigue con la configuración anterior: haz clic en **Actualizar** para aplicarlo o en **Descartar los cambios** para desecharlo. +Una rutina nueva es un borrador y no se ejecuta por su cuenta hasta que la activas. Cuando editas una rutina activa, el cambio también se guarda como borrador mientras la versión en curso sigue con la configuración anterior: haz clic en **Actualizar** para aplicarlo o en **Descartar los cambios** para desecharlo. + +**Ejecutar ahora** lanza una ejecución sin esperar al activador, algo útil para comprobar un prompt. Una rutina no se puede volver a lanzar a mano hasta que termine su ejecución anterior. -**Ejecutar ahora** lanza una ejecución sin esperar a la programación, algo útil para comprobar un prompt. Una rutina no se puede volver a lanzar a mano hasta que termine su ejecución anterior. +En una rutina por evento de conector que todavía no está activa, **Ejecutar ahora** muestra **Esperando un evento**: dispara ese evento en la app y Teable usará el que reciba para una única ejecución, que luego aparece en el historial. Haz clic en **Dejar de esperar** para cortar la espera. Una rutina activa ya recibe sus eventos, así que no lo necesita ni lo admite. -Apaga el interruptor para desactivarla. La programación deja de dispararse y el historial de ejecuciones existente se conserva. +Apaga el interruptor para desactivarla. La rutina deja de dispararse y el historial de ejecuciones existente se conserva. ## Historial de ejecuciones -Abre la rutina y ve a **Historial de ejecuciones**. La lista se puede filtrar por estado e intervalo de tiempo, lo que ayuda a localizar un fallo concreto; al seleccionar una ejecución verás sus horas de planificación, inicio y fin, su duración y el chat completo de esa ejecución. +Abre la rutina y ve a **Historial de ejecuciones**. La lista se puede filtrar por estado e intervalo de tiempo, lo que ayuda a localizar un fallo concreto; al seleccionar una ejecución verás su **ID de ejecución**, su **Activador** y el chat completo de esa ejecución. El **Activador** indica **Programado**, **Evento** o **Manual**, y una ejecución programada muestra además la hora **Planificada** a la que correspondía. Las ejecuciones se informan como **En cola**, **En ejecución**, **Completada**, **Fallida** o **Cancelada**. **Cancelada** aparece cuando alguien interrumpió esa ejecución, o cuando se ha eliminado la rutina o su proyecto. @@ -103,7 +113,7 @@ No toda ejecución sin éxito cuenta para ese total: las ejecuciones omitidas po - Sí. Tras instalar una plantilla, sus rutinas se encienden igual que sus flujos de trabajo. Una programación sin ocurrencias futuras se queda en borrador. + Las programadas sí. Tras instalar una plantilla se encienden igual que sus flujos de trabajo, y una programación sin ocurrencias futuras se queda en borrador. Las rutinas por evento de conector no se encienden: las credenciales no llegan con la plantilla, así que elige una cuenta tuya antes de activarlas. diff --git a/es/basic/automation/trigger/external/connector-event.mdx b/es/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..a0e99f1c --- /dev/null +++ b/es/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "Al recibir un evento de conector" +description: "Ejecuta un flujo de trabajo cuando una aplicación de terceros conectada informa un evento" +--- + +Disponible en todos los planes de la nube; la versión autoalojada requiere el plan Business o superior y que quien gestiona el despliegue habilite los eventos de conector. + +Arranca un flujo de trabajo a partir de algo que ocurre dentro de una aplicación conectada como GitHub, Gmail o Slack: llega un correo, se abre una incidencia, se publica un mensaje. La aplicación entrega el evento directamente a Teable, así que no tienes que alojar una URL de webhook ni consultar cambios. + +## Crear con IA + +Abre el chat de IA en la barra lateral derecha de cualquier tabla y describe lo que necesitas. + +La IA se encarga de todo: elige el activador adecuado, asigna los campos pertinentes y configura las acciones. + +Describe el objetivo una vez y el flujo queda listo, sin configuración manual. + +**Ejemplo:** *"Cuando se abra una incidencia nueva en mi repositorio de GitHub, crea un registro en la tabla Tareas"* + +## Cómo configurarlo + + + + Crea un flujo de trabajo y elige **Al recibir un evento de conector** como activador. + + + Selecciona la aplicación en **App** y después el evento concreto en **Evento**. Cada evento de la lista lleva una descripción breve y una etiqueta; las etiquetas se explican más abajo. + + + En **Cuenta**, elige qué cuenta conectada recibe el evento. Si nunca has conectado esta aplicación, conéctala desde el mismo desplegable: la conexión nueva se concede automáticamente a este flujo de trabajo. + + + Rellena los **Parámetros** que pide el evento, como un repositorio, un canal o una etiqueta. Los campos marcados con * son obligatorios. Haz clic en **Guardar** cuando termines. + + + Añade las acciones siguientes y enciende el flujo de trabajo. La suscripción se crea al activarlo, así que un borrador no recibe nada. + + + +Al cambiar la aplicación o el evento se vacían los pasos posteriores y las variables que apuntaban al evento anterior dejan de resolverse, de modo que esos pasos hay que configurarlos de nuevo. + +## Etiquetas de los eventos + +| Etiqueta | Qué significa | +| --- | --- | +| **Instantáneo** | La aplicación envía el evento, que llega poco después de producirse | +| **Sondeo · puede tardar unos minutos** | Teable consulta la aplicación cada cierto tiempo, así que no cuentes con estos eventos cuando el momento importa | +| **Se activa a menudo** | En la práctica este evento se dispara mucho, y cada disparo cuenta como una ejecución de automatización | +| **Obsoleto** | La aplicación marcó el evento como obsoleto y podría dejar de enviarlo, así que elige otro | + +## Datos disponibles tras el activador + +El evento en sí llega a la variable **event**, que los pasos posteriores insertan con **+**. Justo después de configurar el activador la variable está vacía: antes tiene que llegar un evento real. Haz clic en **Probar activador** y, cuando el panel muestre **Esperando un evento**, entra en la aplicación y haz algo que lo dispare. Un evento de sondeo puede tardar unos minutos. + +El evento recibido se queda en el activador como dato de ejemplo, para que los pasos siguientes puedan usar sus campos. Haz clic en **Dejar de esperar** para cortar la espera; tras unos 30 minutos sin eventos, el panel indica **Se dejó de esperar sin recibir ningún evento.** + +## Cuando se corta la conexión + +El activador deja de recibir eventos si se revoca la concesión de la cuenta, se elimina la cuenta conectada, la aplicación detiene la suscripción (credenciales caducadas o una suscripción que no funciona) o la suscripción no se pudo crear. El flujo de trabajo no se apaga, pero no se produce ninguna ejecución nueva hasta restablecerlo. + +Teable avisa al miembro que editó el flujo por última vez y el panel del activador muestra **Desconectado: vuelve a conectar la cuenta o elige otra**. Restablécelo según la causa: + +- Haz clic en **Volver a conectar** sobre esa misma cuenta en **Ajustes** → **Integraciones**: la suscripción se reconstruye sola. +- Para usar otra cuenta, vuelve al activador, elige otra **Cuenta** y guarda. +- Si la suscripción no se pudo crear, revisa los parámetros y guarda de nuevo para reintentarlo. + +## Después de copiar o importar + +Las credenciales no acompañan al flujo de trabajo. Tras copiar un flujo, o importar o copiar un proyecto, el activador indica **Cuenta no autorizada**: elige una cuenta tuya y guarda antes de que el flujo pueda volver a suscribirse. + +## Documentos relacionados + +- [Credenciales e integraciones](/es/basic/credential) +- [Rutina](/es/basic/ai/routine) diff --git a/es/basic/credential.mdx b/es/basic/credential.mdx index b6f87c92..afce928a 100644 --- a/es/basic/credential.mdx +++ b/es/basic/credential.mdx @@ -63,6 +63,12 @@ Mientras un proyecto tenga integraciones sin conectar, en la parte superior de l Si pegas algo que parece una clave en un campo de una automatización, Teable lo guarda como secreto tuyo y deja una referencia en su lugar, de modo que el texto sin formato no acaba en la configuración del flujo de trabajo. Si prefieres conservar el texto tal cual, haz clic en **Deshacer** en el aviso. +## Créditos de las llamadas a aplicaciones de terceros + +Llamar a una aplicación de terceros a través de una conexión consume créditos del espacio, venga la llamada del chat de IA, de una aplicación o de una automatización. Estos cargos aparecen bajo el tipo **Aplicaciones de terceros** en el **Resumen de uso de créditos** de la página de facturación. + +La mayoría de las aplicaciones cuesta muy poco por llamada. Las que facturan a Teable por recurso devuelto o por solicitud, como X, salen bastante más caras en una sola llamada. Las llamadas fallidas no se cobran, y tampoco la consulta de las herramientas disponibles. Cuando el espacio se queda sin créditos, estas llamadas se rechazan. + ## Tarjetas de autorización en el Chat de IA Cuando la IA necesita una cuenta externa, fija en la conversación una tarjeta encabezada por **Se requiere autorización para esta tarea** y espera a que respondas antes de seguir con el turno. Hay dos tipos, según quién necesite la credencial. diff --git a/fr/basic/ai/routine.mdx b/fr/basic/ai/routine.mdx index 7bee9f09..52f59188 100644 --- a/fr/basic/ai/routine.mdx +++ b/fr/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Laissez Cuppy exécuter un prompt selon une planification et consul Disponible avec tous les forfaits Cloud ; l’auto-hébergement nécessite Business ou une offre supérieure. -Une routine confie un prompt à Cuppy et le répète selon une planification, ce qui convient au travail que personne ne devrait déclencher à la main : un rapport quotidien, un nettoyage périodique des enregistrements expirés, une synthèse hebdomadaire. Chaque exécution est une conversation d’IA complète : une routine peut donc tout ce que peut la conversation d’IA, y compris lire et écrire des tables, appeler des compétences et produire des fichiers. +Une routine confie un prompt à Cuppy et le répète, soit selon une planification, soit chaque fois qu’une application tierce connectée signale un événement. Cela convient au travail que personne ne devrait déclencher à la main : un rapport quotidien, un nettoyage périodique des enregistrements expirés, le classement d’un e-mail dès son arrivée. Chaque exécution est une conversation d’IA complète : une routine peut donc tout ce que peut la conversation d’IA, y compris lire et écrire des tables, appeler des compétences et produire des fichiers. Une routine est une ressource du projet et figure dans la barre latérale gauche, aux côtés des tables, des applications et des automatisations. -Une automatisation se déclenche sur un événement, par exemple une modification d’enregistrement, l’envoi d’un formulaire ou un webhook, et exécute les étapes que vous avez configurées à l’avance. Une routine se déclenche uniquement sur le temps et exécute un prompt que l’agent interprète lui-même. Prenez une automatisation quand il vous faut des étapes fixes et un résultat prévisible ; prenez une routine quand vous voulez que l’agent décide à chaque fois quoi faire des données du moment. +Une automatisation exécute les étapes que vous avez configurées à l’avance, tandis qu’une routine exécute un prompt que l’agent interprète lui-même. Toutes deux peuvent se déclencher selon une planification, et toutes deux sur un événement provenant d’une application tierce connectée. Prenez une automatisation quand il vous faut des étapes fixes et un résultat prévisible ; prenez une routine quand vous voulez que l’agent décide à chaque fois quoi faire des données du moment. ## Créer une routine @@ -20,29 +20,37 @@ Une routine est une ressource du projet et figure dans la barre latérale gauche Décrivez dans **Prompt** ce que doit faire chaque exécution. Le prompt constitue l’instruction complète d’une exécution : indiquez d’où viennent les données, comment les traiter et où va le résultat. Par exemple : « Synthétise les enregistrements ajoutés hier dans la table Tâches, regroupe-les par responsable et écris la synthèse dans la table Rapport quotidien. » - - Choisissez une fréquence sous **Planification** et renseignez **Début** et **Fin (facultatif)** si nécessaire. + + Sous **Déclencheur**, choisissez **Selon une planification** ou **Sur événement de connecteur**, puis renseignez les réglages propres à ce choix. - Cliquez sur **Activer**. La configuration doit être enregistrée et la planification doit comporter une occurrence à venir. + Cliquez sur **Activer**. La configuration doit être enregistrée : **Selon une planification** exige une occurrence à venir, et **Sur événement de connecteur** un compte utilisable. ## Réglages -Outre le prompt et la planification, le formulaire comporte ces réglages : +Outre le prompt et le déclencheur, le formulaire comporte ces réglages : | Réglage | Description | | --- | --- | | **Modèle** | Le modèle et le niveau d’intelligence sur lesquels tourne cette routine. Laissez **Modèle par défaut** pour utiliser le modèle de conversation par défaut de l’espace | | **Conversation** | **Nouvelle conversation à chaque exécution** garde les exécutions indépendantes les unes des autres ; **Poursuivre la conversation de l’exécution précédente** reporte le contexte des exécutions passées, ce qui convient au travail qui doit s’appuyer sur le résultat précédent | -| **Début** / **Fin (facultatif)** | Les bornes de la planification. Sans heure de fin, la routine continue indéfiniment | +| **Début** / **Fin (facultatif)** | Les bornes de la planification, utilisées uniquement par **Selon une planification**. Sans heure de fin, la routine continue indéfiniment | Le modèle et le niveau d’intelligence sont enregistrés au moment de la sauvegarde : l’historique d’exécution montre donc sur quoi chaque exécution a réellement tourné. +### Déclencheur + +**Selon une planification** exécute la routine aux heures que vous définissez, réglées plus bas sous Planification. + +**Sur événement de connecteur** l’exécute une fois chaque fois qu’une application tierce connectée signale un événement, par exemple un nouvel e-mail ou un nouveau ticket. Choisissez l’application, l’événement, le **Compte** qui le reçoit et les paramètres demandés par l’événement ; la configuration est la même que pour le déclencheur d’automatisation, décrit dans [Lorsqu’un événement de connecteur est reçu](/fr/basic/automation/trigger/external/connector-event). Une routine sur ce déclencheur n’a pas d’heure de **Prochaine exécution** et n’utilise ni la planification ni ses bornes. + +Si l’autorisation du compte est révoquée, si le compte connecté est supprimé ou si l’application arrête l’abonnement, la routine affiche **Abonnement déconnecté** et cesse de recevoir des événements ; Teable prévient le membre qui l’a mise à jour en dernier. Reconnecter le même compte reconstruit l’abonnement tout seul ; pour en utiliser un autre, sélectionnez-le dans le déclencheur et enregistrez. + ### Planification -Choisissez une fréquence parmi les préréglages : **Toutes les heures** à une minute donnée, **Tous les jours** et **Jours ouvrés** à une heure donnée, **Toutes les semaines** un jour de semaine à une heure, **Tous les mois** un jour à une heure. +La planification ne sert qu’à **Selon une planification**. Choisissez une fréquence parmi les préréglages : **Toutes les heures** à une minute donnée, **Tous les jours** et **Jours ouvrés** à une heure donnée, **Toutes les semaines** un jour de semaine à une heure, **Tous les mois** un jour à une heure. Pour quelque chose de plus précis, choisissez **Personnalisée (RRULE)** et écrivez une règle RFC 5545, par exemple `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. Une règle personnalisée est soumise à ces limites : @@ -56,15 +64,17 @@ Une planification est évaluée dans le fuseau horaire de la personne qui a cré ## Brouillons, mises à jour et exécution immédiate -Une routine nouvellement créée est un brouillon et ne s’exécute selon la planification qu’une fois activée. Quand vous modifiez une routine active, la modification est elle aussi enregistrée en brouillon tandis que la version en service continue avec l’ancienne configuration : cliquez sur **Mettre à jour** pour l’appliquer, ou sur **Abandonner les modifications** pour la jeter. +Une routine nouvellement créée est un brouillon et ne s’exécute d’elle-même qu’une fois activée. Quand vous modifiez une routine active, la modification est elle aussi enregistrée en brouillon tandis que la version en service continue avec l’ancienne configuration : cliquez sur **Mettre à jour** pour l’appliquer, ou sur **Abandonner les modifications** pour la jeter. + +**Exécuter maintenant** lance une exécution sans attendre le déclencheur, ce qui sert à vérifier un prompt. Une routine ne peut pas être relancée à la main tant que son exécution précédente n’est pas terminée. -**Exécuter maintenant** lance une exécution sans attendre la planification, ce qui sert à vérifier un prompt. Une routine ne peut pas être relancée à la main tant que son exécution précédente n’est pas terminée. +Sur une routine à événement de connecteur pas encore activée, **Exécuter maintenant** affiche plutôt **En attente d’un événement** : déclenchez cet événement dans l’application, et Teable s’en sert pour une exécution unique, qui apparaît ensuite dans l’historique. Cliquez sur **Arrêter d’attendre** pour interrompre l’attente. Une routine active reçoit déjà ses événements : elle n’en a pas besoin et ne l’autorise pas. -Coupez l’interrupteur pour la désactiver : la planification cesse de se déclencher et l’historique d’exécution existant est conservé. +Coupez l’interrupteur pour la désactiver : la routine cesse de se déclencher et l’historique d’exécution existant est conservé. ## Historique d’exécution -Ouvrez la routine et passez à **Historique d’exécution**. La liste se filtre par statut et par période, ce qui aide à retrouver un échec précis ; en sélectionnant une exécution, vous voyez ses heures de planification, de démarrage et de fin, sa durée et la conversation complète de cette exécution. +Ouvrez la routine et passez à **Historique d’exécution**. La liste se filtre par statut et par période, ce qui aide à retrouver un échec précis ; en sélectionnant une exécution, vous voyez son **ID d’exécution**, son **Déclencheur** et la conversation complète de cette exécution. Le **Déclencheur** indique **Planifié**, **Événement** ou **Manuel**, et une exécution planifiée affiche en plus l’heure **Planifiée** à laquelle elle correspondait. Les exécutions sont signalées comme **En file d’attente**, **En cours**, **Terminée**, **Échec** ou **Annulée**. **Annulée** apparaît lorsque quelqu’un a interrompu cette exécution, ou lorsque la routine ou son projet a été supprimé. @@ -103,7 +113,7 @@ Toutes les exécutions sans succès ne comptent pas dans ce total : celles ignor - Oui. Après l’installation d’un modèle, ses routines sont activées comme le sont ses workflows. Une planification sans occurrence à venir reste un brouillon. + Les routines planifiées, oui. Après l’installation d’un modèle, elles sont activées comme le sont ses workflows, et une planification sans occurrence à venir reste un brouillon. Les routines à événement de connecteur ne sont pas activées : les identifiants n’arrivent pas avec le modèle, choisissez donc d’abord un compte à vous. diff --git a/fr/basic/automation/trigger/external/connector-event.mdx b/fr/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..0f768677 --- /dev/null +++ b/fr/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "Lorsqu’un événement de connecteur est reçu" +description: "Exécuter un workflow lorsqu’une application tierce connectée signale un événement" +--- + +Disponible sur toutes les formules Cloud ; l’auto-hébergement exige la formule Business ou supérieure, avec les événements de connecteur activés par l’exploitant de l’installation. + +Démarrez un workflow à partir de ce qui se passe dans une application connectée comme GitHub, Gmail ou Slack : un e-mail arrive, un ticket est ouvert, un message est publié. L’application livre l’événement directement à Teable : vous n’avez ni URL de webhook à héberger ni interrogation à mettre en place. + +## Créer avec l’IA + +Ouvrez le chat IA dans la barre latérale droite de n’importe quelle table et décrivez ce dont vous avez besoin. + +L’IA s’occupe de tout : elle choisit le bon déclencheur, associe les champs concernés et configure les actions. + +Décrivez l’objectif une fois et le workflow est prêt, sans configuration manuelle. + +**Exemple :** *"Quand un nouveau ticket est ouvert dans mon dépôt GitHub, crée un enregistrement dans la table Tâches"* + +## Comment le configurer + + + + Créez un workflow et choisissez **Lorsqu'un événement de connecteur est reçu** comme déclencheur. + + + Sélectionnez l’application sous **Application**, puis l’événement précis sous **Événement**. Chaque événement de la liste porte un résumé d’une ligne et un badge ; les badges sont expliqués plus bas. + + + Sous **Compte**, choisissez quel compte connecté reçoit l’événement. Si vous n’avez jamais connecté cette application, connectez-la depuis la même liste : la nouvelle connexion est accordée automatiquement à ce workflow. + + + Renseignez les **Paramètres** demandés par l’événement, par exemple un dépôt, un canal ou une étiquette. Les champs marqués * sont obligatoires. Cliquez ensuite sur **Enregistrer**. + + + Ajoutez les actions qui suivent, puis activez le workflow. L’abonnement est créé à l’activation : un brouillon ne reçoit rien. + + + +Changer l’application ou l’événement vide les étapes suivantes, et les variables qui faisaient référence à l’événement précédent cessent d’être résolues : ces étapes sont donc à reconfigurer. + +## Badges des événements + +| Badge | Signification | +| --- | --- | +| **Instantané** | L’application pousse l’événement, qui arrive peu après sa survenue | +| **Interrogation · peut prendre quelques minutes** | Teable interroge l’application périodiquement : ne comptez pas dessus quand le délai compte | +| **Se déclenche souvent** | Cet événement survient beaucoup en pratique, et chaque déclenchement compte comme une exécution d’automatisation | +| **Obsolète** | L’application a rendu l’événement obsolète et pourrait cesser de l’envoyer : choisissez-en un autre | + +## Données disponibles après le déclencheur + +L’événement lui-même arrive dans la variable **event**, que les étapes suivantes insèrent via **+**. Juste après la configuration, la variable est vide : un véritable événement doit d’abord arriver. Cliquez sur **Tester le déclencheur** et, dès que le panneau affiche **En attente d’un événement**, allez le déclencher dans l’application. Un événement par interrogation peut mettre quelques minutes. + +L’événement reçu reste sur le déclencheur comme donnée d’exemple, de sorte que les étapes suivantes puissent utiliser ses champs. Cliquez sur **Arrêter d’attendre** pour interrompre l’attente ; après une trentaine de minutes sans événement, le panneau indique **L’attente s’est arrêtée sans qu’aucun événement n’arrive.** + +## Quand la connexion est rompue + +Le déclencheur cesse de recevoir des événements lorsque l’autorisation du compte est révoquée, que le compte connecté est supprimé, que l’application arrête l’abonnement (identifiants expirés ou abonnement défaillant) ou que l’abonnement n’a pas pu être créé. Le workflow n’est pas désactivé, mais plus aucune exécution n’a lieu tant qu’il n’est pas rétabli. + +Teable prévient le membre qui a modifié le workflow en dernier, et le panneau du déclencheur affiche **Déconnecté — reconnectez le compte ou choisissez-en un autre**. Rétablissez-le selon la cause : + +- Cliquez sur **Reconnecter** pour ce même compte dans **Paramètres** → **Intégrations** : l’abonnement se reconstruit tout seul. +- Pour utiliser un autre compte, revenez au déclencheur, choisissez un autre **Compte** et enregistrez. +- Si l’abonnement n’a pas pu être créé, vérifiez les paramètres et enregistrez à nouveau pour réessayer. + +## Après une copie ou un import + +Les identifiants ne suivent pas un workflow. Après avoir copié un workflow, ou importé ou copié un projet, le déclencheur affiche **Compte non autorisé** : choisissez l’un de vos comptes et enregistrez pour que le workflow puisse se réabonner. + +## Documents liés + +- [Identifiants et intégrations](/fr/basic/credential) +- [Routine](/fr/basic/ai/routine) diff --git a/fr/basic/credential.mdx b/fr/basic/credential.mdx index e6c3b1af..dc8aa607 100644 --- a/fr/basic/credential.mdx +++ b/fr/basic/credential.mdx @@ -63,6 +63,12 @@ Tant qu’un projet a des intégrations non connectées, un bandeau en haut de l Si vous collez dans un champ d’automatisation une valeur qui ressemble à une clé, Teable l’enregistre comme votre secret et laisse une référence à la place, de sorte que le texte en clair n’entre pas dans la configuration du workflow. Pour conserver le texte tel quel, cliquez sur **Annuler** dans la notification. +## Crédits des appels aux applications tierces + +Appeler une application tierce via une connexion consomme les crédits de l’espace, que l’appel vienne du Chat IA, d’une application ou d’une automatisation. Ces débits figurent sous le type **Applications tierces** dans le **Récapitulatif d’utilisation des crédits** de la page de facturation. + +La plupart des applications coûtent très peu par appel. Celles qui facturent Teable par ressource renvoyée ou par requête, comme X, reviennent nettement plus cher pour un seul appel. Les appels en échec ne sont pas facturés, pas plus que la recherche des outils disponibles. Une fois les crédits de l’espace épuisés, ces appels sont refusés. + ## Cartes d’autorisation dans le Chat IA Quand l’IA a besoin d’un compte externe, elle épingle dans la conversation une carte intitulée **Autorisation requise pour cette tâche** et attend votre réponse avant de poursuivre le tour. Il en existe deux sortes, selon qui a besoin de l’identifiant. diff --git a/it/basic/ai/routine.mdx b/it/basic/ai/routine.mdx index c8e4c881..c0abdd9b 100644 --- a/it/basic/ai/routine.mdx +++ b/it/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Lascia che Cuppy esegua un prompt secondo una pianificazione e cont Disponibile in tutti i piani Cloud; la versione self-hosted richiede il piano Business o superiore. -Una routine affida un prompt a Cuppy e lo ripete secondo una pianificazione: si presta al lavoro che nessuno dovrebbe avviare a mano, come un report giornaliero, una pulizia periodica dei record scaduti, un riepilogo settimanale. Ogni esecuzione è una chat IA completa, quindi una routine può fare tutto ciò che fa la chat IA, incluso leggere e scrivere tabelle, richiamare skill e produrre file. +Una routine affida un prompt a Cuppy e lo ripete, secondo una pianificazione oppure ogni volta che un'app di terze parti collegata segnala un evento: si presta al lavoro che nessuno dovrebbe avviare a mano, come un report giornaliero, una pulizia periodica dei record scaduti, l'archiviazione di una email appena arriva. Ogni esecuzione è una chat IA completa, quindi una routine può fare tutto ciò che fa la chat IA, incluso leggere e scrivere tabelle, richiamare skill e produrre file. Una routine è una risorsa del progetto e compare nella barra laterale sinistra accanto a tabelle, app e automazioni. -Un'automazione si attiva su un evento, per esempio la modifica di un record, l'invio di un modulo o un webhook, ed esegue i passaggi che hai configurato in anticipo. Una routine si attiva solo sul tempo ed esegue un prompt che l'agente interpreta da sé. Usa un'automazione quando servono passaggi fissi e un esito prevedibile; usa una routine quando vuoi che sia l'agente a decidere ogni volta cosa fare con i dati del momento. +Un'automazione esegue i passaggi che hai configurato in anticipo, mentre una routine esegue un prompt che l'agente interpreta da sé. Entrambe possono attivarsi secondo una pianificazione ed entrambe su un evento proveniente da un'app di terze parti collegata. Usa un'automazione quando servono passaggi fissi e un esito prevedibile; usa una routine quando vuoi che sia l'agente a decidere ogni volta cosa fare con i dati del momento. ## Creare una routine @@ -20,29 +20,37 @@ Una routine è una risorsa del progetto e compare nella barra laterale sinistra Descrivi in **Prompt** che cosa deve fare ogni esecuzione. Il prompt è l'istruzione completa di un'esecuzione: indica da dove arrivano i dati, come elaborarli e dove va il risultato. Per esempio: «Riepiloga i record aggiunti ieri alla tabella Attività, raggruppali per responsabile e scrivi il riepilogo nella tabella Report giornaliero». - - Scegli una frequenza in **Pianificazione** e imposta **Inizio** e **Fine (facoltativo)** se necessario. + + In **Attivatore** scegli **In base a una pianificazione** oppure **Su evento del connettore**, poi compila le impostazioni richieste da quella scelta. - Fai clic su **Attiva**. La configurazione deve essere già salvata e la pianificazione deve avere un'occorrenza futura. + Fai clic su **Attiva**. La configurazione deve essere già salvata: **In base a una pianificazione** richiede un'occorrenza futura, **Su evento del connettore** un account utilizzabile. ## Impostazioni -Oltre al prompt e alla pianificazione, il modulo contiene queste impostazioni: +Oltre al prompt e all'attivatore, il modulo contiene queste impostazioni: | Impostazione | Descrizione | | --- | --- | | **Modello** | Il modello e il livello di intelligenza con cui gira questa routine. Lascia **Modello predefinito** per usare il modello di chat predefinito dello spazio | | **Chat** | **Nuova chat a ogni esecuzione** mantiene le esecuzioni indipendenti tra loro; **Continua la chat dell'esecuzione precedente** porta avanti il contesto delle esecuzioni passate e si presta al lavoro che deve riferirsi al risultato precedente | -| **Inizio** / **Fine (facoltativo)** | I limiti della pianificazione. Senza orario di fine la routine prosegue a tempo indeterminato | +| **Inizio** / **Fine (facoltativo)** | I limiti della pianificazione, usati solo da **In base a una pianificazione**. Senza orario di fine la routine prosegue a tempo indeterminato | Modello e livello di intelligenza vengono registrati al salvataggio, perciò la cronologia delle esecuzioni mostra su che cosa ha girato davvero ciascuna. +### Attivatore + +**In base a una pianificazione** esegue la routine negli orari che imposti, configurati più sotto in Pianificazione. + +**Su evento del connettore** la esegue una volta ogni volta che un'app di terze parti collegata segnala un evento, per esempio una nuova email o una nuova issue. Scegli l'app, l'evento, l'**Account** che lo riceve e i parametri richiesti dall'evento; la configurazione è la stessa dell'attivatore dell'automazione, descritto in [Alla ricezione di un evento del connettore](/it/basic/automation/trigger/external/connector-event). Una routine su questo attivatore non ha un orario di **Prossima esecuzione** e non usa né la pianificazione né i suoi limiti. + +Se la concessione dell'account viene revocata, se l'account collegato viene rimosso o se l'app interrompe la sottoscrizione, la routine segnala **Sottoscrizione disconnessa** e smette di ricevere eventi, e Teable avvisa il membro che l'ha aggiornata per ultimo. Ricollegando lo stesso account la sottoscrizione si ricostruisce da sola; per usarne un altro, selezionalo nell'attivatore e salva. + ### Pianificazione -Scegli una frequenza tra i preset: **Ogni ora** a un minuto preciso, **Ogni giorno** e **Giorni feriali** a un orario preciso, **Ogni settimana** in un giorno della settimana e a un orario, **Ogni mese** in un giorno e a un orario. +La pianificazione serve solo a **In base a una pianificazione**. Scegli una frequenza tra i preset: **Ogni ora** a un minuto preciso, **Ogni giorno** e **Giorni feriali** a un orario preciso, **Ogni settimana** in un giorno della settimana e a un orario, **Ogni mese** in un giorno e a un orario. Per qualcosa di più specifico scegli **Personalizzata (RRULE)** e scrivi una regola RFC 5545, per esempio `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. Una regola personalizzata ha questi limiti: @@ -56,15 +64,17 @@ Una pianificazione viene valutata nel fuso orario di chi ha creato la routine e ## Bozze, aggiornamenti ed esecuzione immediata -Una routine appena creata è una bozza e non gira secondo la pianificazione finché non la attivi. Quando modifichi una routine attiva, anche la modifica viene salvata come bozza mentre la versione in servizio continua con la vecchia configurazione: fai clic su **Aggiorna** per applicarla o su **Scarta le modifiche** per eliminarla. +Una routine appena creata è una bozza e non gira da sola finché non la attivi. Quando modifichi una routine attiva, anche la modifica viene salvata come bozza mentre la versione in servizio continua con la vecchia configurazione: fai clic su **Aggiorna** per applicarla o su **Scarta le modifiche** per eliminarla. + +**Esegui ora** avvia un'esecuzione senza attendere l'attivatore, utile per verificare un prompt. Una routine non può essere riavviata a mano finché l'esecuzione precedente non è terminata. -**Esegui ora** avvia un'esecuzione senza attendere la pianificazione, utile per verificare un prompt. Una routine non può essere riavviata a mano finché l'esecuzione precedente non è terminata. +Su una routine a evento del connettore non ancora attiva, **Esegui ora** mostra invece **In attesa di un evento**: attiva quell'evento nell'app e Teable userà quello che riceve per una sola esecuzione, che comparirà poi nella cronologia. Fai clic su **Smetti di attendere** per interrompere l'attesa. Una routine attiva riceve già i suoi eventi, quindi non ne ha bisogno e non lo consente. -Spegni l'interruttore per disattivarla: la pianificazione smette di scattare e la cronologia delle esecuzioni esistente resta. +Spegni l'interruttore per disattivarla: la routine smette di scattare e la cronologia delle esecuzioni esistente resta. ## Cronologia delle esecuzioni -Apri la routine e passa a **Cronologia delle esecuzioni**. L'elenco si filtra per stato e intervallo di tempo, il che aiuta a individuare un guasto preciso; selezionando un'esecuzione vedi orario pianificato, di avvio e di fine, la durata e la chat completa di quell'esecuzione. +Apri la routine e passa a **Cronologia delle esecuzioni**. L'elenco si filtra per stato e intervallo di tempo, il che aiuta a individuare un guasto preciso; selezionando un'esecuzione vedi il suo **ID esecuzione**, il suo **Attivatore** e la chat completa di quell'esecuzione. L'**Attivatore** riporta **Pianificato**, **Evento** o **Manuale**, e un'esecuzione pianificata mostra anche l'orario **Pianificata** a cui corrispondeva. Le esecuzioni sono riportate come **In coda**, **In esecuzione**, **Completata**, **Non riuscita** o **Annullata**. **Annullata** compare quando qualcuno ha interrotto quell'esecuzione, oppure quando la routine o il suo progetto sono stati eliminati. @@ -103,7 +113,7 @@ Non ogni esecuzione senza esito conta in quel totale: quelle saltate perché la - Sì. Dopo l'installazione di un modello le sue routine vengono accese come i suoi workflow. Una pianificazione senza occorrenze future resta una bozza. + Quelle pianificate sì. Dopo l'installazione di un modello vengono accese come i suoi workflow, e una pianificazione senza occorrenze future resta una bozza. Le routine a evento del connettore non vengono accese: le credenziali non arrivano con il modello, quindi scegli prima un account tuo. diff --git a/it/basic/automation/trigger/external/connector-event.mdx b/it/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..d29a4192 --- /dev/null +++ b/it/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "Alla ricezione di un evento del connettore" +description: "Esegui un workflow quando un'app di terze parti collegata segnala un evento" +--- + +Disponibile in tutti i piani Cloud; la versione self-hosted richiede il piano Business o superiore e che chi gestisce l'installazione abiliti gli eventi del connettore. + +Fai partire un workflow da qualcosa che accade dentro un'app collegata come GitHub, Gmail o Slack: arriva una nuova email, viene aperta una issue, viene pubblicato un messaggio. L'app consegna l'evento direttamente a Teable, quindi non devi ospitare un URL webhook né interrogare nulla. + +## Creare con l'IA + +Apri la chat IA nella barra laterale destra di una tabella qualsiasi e descrivi ciò che ti serve. + +All'IA pensa a tutto: sceglie l'attivatore giusto, mappa i campi pertinenti e imposta le azioni. + +Descrivi l'obiettivo una volta e il workflow è pronto, senza configurazione manuale. + +**Esempio:** *"Quando viene aperta una nuova issue nel mio repository GitHub, crea un record nella tabella Attività"* + +## Come configurarlo + + + + Crea un workflow e scegli **Alla ricezione di un evento del connettore** come attivatore. + + + Seleziona l'app in **App**, poi l'evento specifico in **Evento**. Ogni evento dell'elenco riporta una riga di descrizione e un'etichetta; le etichette sono spiegate più sotto. + + + In **Account** scegli quale account collegato riceve l'evento. Se non hai mai collegato questa app, collegala dallo stesso menu: la nuova connessione viene concessa automaticamente a questo workflow. + + + Compila i **Parametri** richiesti dall'evento, per esempio un repository, un canale o un'etichetta. I campi con * sono obbligatori. Al termine fai clic su **Salva**. + + + Aggiungi le azioni successive, poi accendi il workflow. La sottoscrizione nasce all'attivazione, quindi una bozza non riceve nulla. + + + +Cambiando app o evento i passaggi successivi vengono svuotati e le variabili che facevano riferimento all'evento precedente smettono di risolversi: quei passaggi vanno riconfigurati. + +## Etichette degli eventi + +| Etichetta | Che cosa significa | +| --- | --- | +| **Istantaneo** | L'app invia l'evento, che arriva poco dopo essersi verificato | +| **Polling · può richiedere qualche minuto** | Teable interroga l'app periodicamente, quindi non contarci quando il tempismo conta | +| **Si attiva spesso** | Nella pratica questo evento scatta molto, e ogni scatto conta come un'esecuzione di automazione | +| **Deprecato** | L'app ha deprecato l'evento e potrebbe smettere di inviarlo: scegline un altro | + +## Dati disponibili dopo l'attivatore + +L'evento vero e proprio finisce nella variabile **event**, che i passaggi successivi inseriscono con **+**. Subito dopo la configurazione la variabile è vuota: deve prima arrivare un evento reale. Fai clic su **Prova attivatore** e, quando il pannello mostra **In attesa di un evento**, vai nell'app e fai qualcosa che lo scateni. Un evento in polling può richiedere qualche minuto. + +L'evento arrivato resta sull'attivatore come dato di esempio, così i passaggi seguenti possono usarne i campi. Fai clic su **Smetti di attendere** per interrompere l'attesa; dopo circa 30 minuti senza eventi il pannello riporta **Attesa terminata senza ricevere eventi.** + +## Quando la connessione cade + +L'attivatore smette di ricevere eventi se la concessione dell'account viene revocata, se l'account collegato viene rimosso, se l'app interrompe la sottoscrizione (credenziali scadute o sottoscrizione non funzionante) o se la sottoscrizione non è stata creata. Il workflow non viene spento, ma non produce nuove esecuzioni finché non lo ripristini. + +Teable avvisa il membro che ha modificato il workflow per ultimo e il pannello dell'attivatore mostra **Disconnesso: ricollega l'account o scegline un altro**. Ripristinalo in base alla causa: + +- Fai clic su **Ricollega** sullo stesso account in **Impostazioni** → **Integrazioni**: la sottoscrizione si ricostruisce da sola. +- Per usare un altro account, torna all'attivatore, scegli un altro **Account** e salva. +- Se la sottoscrizione non è stata creata, controlla i parametri e salva di nuovo per riprovare. + +## Dopo una copia o un'importazione + +Le credenziali non viaggiano con il workflow. Dopo aver copiato un workflow, o importato o copiato un progetto, l'attivatore riporta **Account non autorizzato**: scegli un account tuo e salva prima che il workflow possa sottoscriversi di nuovo. + +## Documenti correlati + +- [Credenziali e integrazioni](/it/basic/credential) +- [Routine](/it/basic/ai/routine) diff --git a/it/basic/credential.mdx b/it/basic/credential.mdx index 5e44ae16..9cfb71bd 100644 --- a/it/basic/credential.mdx +++ b/it/basic/credential.mdx @@ -63,6 +63,12 @@ Finché un progetto ha integrazioni non collegate, in cima alla pagina compare u Se incolli in un campo di un'Automazione qualcosa che somiglia a una chiave, Teable lo salva come tuo segreto e lascia un riferimento al suo posto, così il testo in chiaro non finisce nella configurazione del flusso di lavoro. Se preferisci mantenere il testo così com'è, fai clic su **Annulla** nell'avviso. +## Crediti per le chiamate ad app di terze parti + +Chiamare un'app di terze parti tramite una connessione consuma i crediti dello spazio, sia che la chiamata arrivi da AI Chat, da un'app o da un'Automazione. Questi addebiti compaiono sotto il tipo **App di terze parti** nel **Riepilogo dell'utilizzo dei crediti** della pagina di fatturazione. + +La maggior parte delle app costa pochissimo per chiamata. Quelle che fatturano a Teable per risorsa restituita o per richiesta, come X, costano sensibilmente di più per una singola chiamata. Le chiamate fallite non vengono addebitate, e nemmeno la ricerca degli strumenti disponibili. Quando i crediti dello spazio finiscono, queste chiamate vengono rifiutate. + ## Schede di autorizzazione in AI Chat Quando l'IA ha bisogno di un account esterno, fissa nella conversazione una scheda intitolata **Autorizzazione richiesta per questa attività** e aspetta una tua risposta prima di proseguire il turno. Le schede sono due, a seconda di chi ha bisogno della credenziale. diff --git a/ja/basic/ai/routine.mdx b/ja/basic/ai/routine.mdx index 3d23ea53..f69fc15a 100644 --- a/ja/basic/ai/routine.mdx +++ b/ja/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Cuppy がプロンプトをスケジュールどおりに実行し クラウド版はすべてのプランで利用可能。セルフホスト版はビジネスプラン以上が必要です。 -ルーティンはプロンプトを Cuppy に渡し、スケジュールに従って繰り返し実行します。日次レポートの作成、期限切れレコードの定期的な整理、週次の集計など、人が手動で起動しなくてよい作業に向いています。各実行は AI チャットそのものなので、テーブルの読み書き、スキルの呼び出し、ファイルの生成など、AI チャットでできることはすべて使えます。 +ルーティンはプロンプトを Cuppy に渡し、スケジュールに従って、あるいは連携したサードパーティアプリでイベントが起きたときに、繰り返し実行します。日次レポートの作成、期限切れレコードの定期的な整理、届いたメールの仕分けなど、人が手動で起動しなくてよい作業に向いています。各実行は AI チャットそのものなので、テーブルの読み書き、スキルの呼び出し、ファイルの生成など、AI チャットでできることはすべて使えます。 ルーティンはプロジェクト内のリソースで、テーブル・アプリ・オートメーションと並んで左サイドバーに表示されます。 -オートメーションはレコードの変更、フォームの送信、Webhook などのイベントで起動し、あらかじめ設定した手順を実行します。ルーティンは時刻だけで起動し、エージェント自身が解釈するプロンプトを実行します。手順が固定で結果が予測できる必要があるならオートメーション、そのときのデータを見てエージェントに判断させたいならルーティンを選びます。 +オートメーションはあらかじめ設定した手順を実行し、ルーティンはエージェント自身が解釈するプロンプトを実行します。どちらも時刻で起動でき、連携したサードパーティアプリのイベントでも起動できます。手順が固定で結果が予測できる必要があるならオートメーション、そのときのデータを見てエージェントに判断させたいならルーティンを選びます。 ## ルーティンを作成する @@ -20,29 +20,37 @@ description: Cuppy がプロンプトをスケジュールどおりに実行し **プロンプト** に、各回の実行で行うことを記述します。プロンプトは 1 回の実行の指示すべてなので、データの取得元、処理方法、結果の書き出し先まで書きます。たとえば「タスクテーブルに昨日追加されたレコードを集計し、担当者ごとにまとめて日報テーブルに書き込む」のように指定します。 - - **スケジュール** で頻度を選び、必要に応じて **開始** と **終了(任意)** を設定します。 + + **トリガー** で **スケジュール** か **コネクタイベント** を選び、選んだ方式の設定を入力します。 - **有効にする** をクリックします。事前に設定が保存されていること、スケジュールに今後の実行予定があることが必要です。 + **有効にする** をクリックします。事前に設定が保存されている必要があり、**スケジュール** では今後の実行予定が、**コネクタイベント** では使用できるアカウントが必要です。 ## 設定項目 -プロンプトとスケジュール以外に、フォームには次の設定があります。 +プロンプトとトリガー以外に、フォームには次の設定があります。 | 設定 | 説明 | | --- | --- | | **モデル** | このルーティンが使うモデルと知能レベル。**デフォルトモデル** のままにするとスペースの既定のチャットモデルを使います | | **チャット** | **実行ごとに新しいチャット** は各回を互いに独立させます。**前回の実行のチャットを続ける** はこれまでの実行の文脈を引き継ぐため、前回の結果を参照する必要がある作業に向きます | -| **開始** / **終了(任意)** | スケジュールの範囲。終了時刻を設定しなければ無期限に実行し続けます | +| **開始** / **終了(任意)** | スケジュールの範囲で、**スケジュール** のときだけ使います。終了時刻を設定しなければ無期限に実行し続けます | 保存時にそのときのモデルと知能レベルも記録されるため、実行履歴では各回が実際に何で動いたかを確認できます。 +### トリガー + +**スケジュール** は、設定した時刻にルーティンを実行します。設定方法は下のスケジュールを参照してください。 + +**コネクタイベント** は、連携したサードパーティアプリでイベントが起きるたびに 1 回実行します。たとえば新着メールや新しい Issue です。アプリ、イベント、イベントを受け取る **アカウント**、イベントが求めるパラメーターを選ぶだけで、設定方法はオートメーションのトリガーと同じです。詳しくは [コネクタイベントを受信したとき](/ja/basic/automation/trigger/external/connector-event) を参照してください。このトリガーのルーティンには **次回実行** の時刻がなく、スケジュールや開始・終了時刻も使いません。 + +アカウントの付与が取り消された、連携アカウントが削除された、アプリ側がサブスクリプションを停止したといった場合、ルーティンは **サブスクリプションが切断されました** と表示してイベントの受信を止め、最後に更新したメンバーに Teable から通知が届きます。同じアカウントを再接続すればサブスクリプションは自動的に作り直されます。別のアカウントに変える場合は、トリガーでアカウントを選び直して保存してください。 + ### スケジュール -頻度はプリセットから選べます。**毎時** は分を、**毎日** と **平日** は時刻を、**毎週** は曜日と時刻を、**毎月** は日と時刻を指定します。 +スケジュールは **スケジュール** のときだけ使います。頻度はプリセットから選べます。**毎時** は分を、**毎日** と **平日** は時刻を、**毎週** は曜日と時刻を、**毎月** は日と時刻を指定します。 より細かい条件が必要な場合は **カスタム(RRULE)** を選び、`FREQ=DAILY;BYHOUR=9;BYMINUTE=0` のような RFC 5545 のルールを記述します。カスタムルールには次の制限があります。 @@ -56,15 +64,17 @@ description: Cuppy がプロンプトをスケジュールどおりに実行し ## 下書き・更新・今すぐ実行 -作成直後のルーティンは下書きで、有効にするまでスケジュール実行されません。有効なルーティンを編集した場合も変更はまず下書きとして保存され、稼働中のバージョンは元の設定のまま動き続けます。**更新** をクリックすると反映され、**変更を破棄** をクリックすると変更は取り消されます。 +作成直後のルーティンは下書きで、有効にするまで自動では実行されません。有効なルーティンを編集した場合も変更はまず下書きとして保存され、稼働中のバージョンは元の設定のまま動き続けます。**更新** をクリックすると反映され、**変更を破棄** をクリックすると変更は取り消されます。 + +**今すぐ実行** を使うと、トリガーを待たずに 1 回実行できます。プロンプトの確認に便利です。前回の実行が終わるまでは、同じルーティンを手動で再実行できません。 -**今すぐ実行** を使うと、スケジュールを待たずに 1 回実行できます。プロンプトの確認に便利です。前回の実行が終わるまでは、同じルーティンを手動で再実行できません。 +まだ有効にしていないコネクタイベントのルーティンで **今すぐ実行** をクリックすると、**イベントを待機中** と表示されます。アプリでそのイベントを発生させると、Teable は受信したイベントで 1 回だけ実行し、結果は実行履歴に入ります。待機をやめるときは **待機をやめる** をクリックします。すでに有効なルーティンはイベントを受信しているため、この操作は不要で、実行もできません。 -スイッチをオフにすると停止します。以後スケジュールは起動せず、既存の実行履歴はそのまま残ります。 +スイッチをオフにすると停止します。以後ルーティンは起動せず、既存の実行履歴はそのまま残ります。 ## 実行履歴 -ルーティンを開いて **実行履歴** に切り替えます。実行の一覧はステータスと期間で絞り込めるため、特定の失敗を見つけやすくなります。実行を選ぶと、予定時刻・開始時刻・終了時刻・所要時間と、その実行のチャット全体を確認できます。 +ルーティンを開いて **実行履歴** に切り替えます。実行の一覧はステータスと期間で絞り込めるため、特定の失敗を見つけやすくなります。実行を選ぶと、**実行 ID**、**トリガー**、その実行のチャット全体を確認できます。**トリガー** は **スケジュール**、**イベント**、**手動** のいずれかで、スケジュール実行の場合は対応する **予定** 時刻も表示されます。 実行のステータスは **待機中**、**実行中**、**完了**、**失敗**、**キャンセル** のいずれかです。**キャンセル** は、その実行を誰かが中断した場合、またはルーティンや所属するプロジェクトが削除された場合に表示されます。 @@ -103,7 +113,7 @@ description: Cuppy がプロンプトをスケジュールどおりに実行し - されます。テンプレートのインストール後、ルーティンはワークフローと同じように有効化されます。今後の実行予定がないスケジュールは下書きのまま残ります。 + スケジュールのルーティンは有効化されます。テンプレートのインストール後、ワークフローと同じように有効化され、今後の実行予定がないスケジュールは下書きのまま残ります。コネクタイベントのルーティンは自動では有効化されません。認証情報はテンプレートでは引き継がれないため、先に自分のアカウントを選んでから有効にしてください。 diff --git a/ja/basic/automation/trigger/external/connector-event.mdx b/ja/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..76253f3e --- /dev/null +++ b/ja/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "コネクタイベントを受信したとき" +description: "連携したサードパーティアプリがイベントを通知したときにワークフローを実行する" +--- + +クラウド版は全プランで利用できます。セルフホスト版はビジネスプラン以上が必要で、さらに運用者がコネクタイベントを有効にしている必要があります。 + +GitHub、Gmail、Slack など連携済みアプリで起きたことをワークフローの起点にできます。新着メールの受信、Issue の作成、メッセージの投稿などです。イベントはアプリから Teable に直接届くため、Webhook の URL を用意したり、変更を定期的に取りに行ったりする必要はありません。 + +## AI で作成する + +任意のテーブルの右サイドバーで AI チャットを開き、やりたいことを説明します。 + +AI が適切なトリガーの選択、関連フィールドのマッピング、アクションの設定まで行います。 + +目的を一度伝えるだけでワークフローが整い、手動設定は不要です。 + +**例：** *「GitHub リポジトリに新しい Issue が作成されたら、タスクテーブルにレコードを作成して」* + +## 設定手順 + + + + ワークフローを新規作成し、トリガーに **コネクタイベントを受信したとき** を選びます。 + + + **アプリ** で対象のアプリを選び、続けて **イベント** で具体的なイベントを選びます。一覧の各イベントには 1 行の説明とラベルが付いています。ラベルの意味は下記のとおりです。 + + + **アカウント** で、どの連携アカウントでイベントを受け取るかを選びます。そのアプリをまだ接続していない場合は、同じドロップダウンからその場で接続できます。接続したアカウントは自動的にこのワークフローへ付与されます。 + + + リポジトリ、チャンネル、ラベルなど、イベントが求める **パラメーター** を入力します。* の付いた項目は必須です。入力後に **保存** をクリックします。 + + + 後続のアクションを追加し、ワークフローをオンにします。サブスクリプションは有効化した時点で作成されるため、下書きのままではイベントを受け取りません。 + + + +アプリやイベントを変更すると、後続のステップはクリアされ、元のイベントを参照していた変数も解決できなくなるため、それらのステップは設定し直しが必要です。 + +## イベントのラベル + +| ラベル | 意味 | +| --- | --- | +| **即時** | アプリがイベントを送信し、発生後まもなく届きます | +| **ポーリング · 数分遅れることがあります** | Teable が定期的にアプリへ問い合わせます。時間にシビアな処理では当てにしないでください | +| **頻繁に発生** | 実運用で発生回数が多いイベントです。発生ごとにオートメーションの実行回数を消費します | +| **非推奨** | アプリがこのイベントを非推奨にしており、今後送信されなくなる可能性があります。別のイベントを選んでください | + +## トリガー後に使えるデータ + +イベント本体は **event** 変数に入り、後続のステップから **+** で挿入できます。設定した直後はこの変数がまだ空で、実際のイベントが 1 件届く必要があります。**トリガーをテスト** をクリックし、パネルに **イベントを待機中** と表示されたら、アプリ側でそのイベントを発生させてください。ポーリングのイベントでは数分かかる場合があります。 + +届いたイベントはサンプルデータとしてトリガーに残るため、後続のステップからそのフィールドを参照できます。待機を途中でやめるときは **待機をやめる** をクリックします。約 30 分経ってもイベントが届かない場合、パネルには **イベントを受信しないまま待機を終了しました。** と表示されます。 + +## 接続が切れたとき + +アカウントの付与が取り消された、連携アカウントが削除された、アプリ側がサブスクリプションを停止した（認証情報の期限切れ、またはサブスクリプションの不調）、サブスクリプションを作成できなかった、といった場合、トリガーはイベントの受信を停止します。ワークフローのスイッチ自体はオフになりませんが、復旧するまで新しい実行は発生しません。 + +Teable は最後にこのワークフローを編集したメンバーに通知し、トリガーのパネルには **切断されました。アカウントを再接続するか、別のアカウントを選択してください** と表示されます。原因に応じて次のように復旧します。 + +- **設定** → **統合** で同じアカウントの **再接続** をクリックすると、サブスクリプションは自動的に作り直されます。 +- 別のアカウントに変える場合は、トリガーに戻って **アカウント** を選び直し、保存します。 +- サブスクリプションを作成できなかった場合は、パラメーターを確認して保存し直すと再試行されます。 + +## コピーやインポートの後 + +認証情報はワークフローには引き継がれません。ワークフローを複製したり、プロジェクトをインポート・複製したりすると、トリガーに **アカウント未認可** と表示されます。自分のアカウントを選んで保存すると、ワークフローは再びサブスクライブできるようになります。 + +## 関連ドキュメント + +- [認証情報と連携](/ja/basic/credential) +- [ルーティン](/ja/basic/ai/routine) diff --git a/ja/basic/credential.mdx b/ja/basic/credential.mdx index 972136ed..f1f93ff2 100644 --- a/ja/basic/credential.mdx +++ b/ja/basic/credential.mdx @@ -63,6 +63,12 @@ description: 自分の接続とシークレットを管理し、必要なアプ オートメーションの入力欄にキーらしき文字列を貼り付けると、Teableはそれを自分のシークレットとして保存し、その場には参照だけを残します。平文がワークフローの設定に残ることはありません。貼り付けたままにしたい場合は、通知の**元に戻す**をクリックします。 +## サードパーティアプリ呼び出しのクレジット + +接続を介してサードパーティアプリを呼び出すと、スペースのクレジットを消費します。AI チャット、アプリ、オートメーションのいずれからの呼び出しでも計上され、請求ページの **クレジット使用量** に種別 **サードパーティアプリ** として表示されます。 + +ほとんどのアプリは 1 回あたりの消費がごくわずかです。X のように返却件数やリクエスト単位で Teable に課金するアプリは、1 回の呼び出しでも消費が目立って大きくなります。失敗した呼び出しは課金されず、利用できるツールの検索も課金されません。スペースのクレジットが尽きると、これらの呼び出しは拒否されます。 + ## AIチャットでの認可カード AIが外部アカウントを必要とする場合、**このタスクには認証が必要です** と書かれたカードが会話に固定され、対応するまでそのターンは先に進みません。カードは、その認証情報を誰が使うかによって2種類あります。 diff --git a/ru/basic/ai/routine.mdx b/ru/basic/ai/routine.mdx index 788c1c01..810087ea 100644 --- a/ru/basic/ai/routine.mdx +++ b/ru/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Cuppy выполняет промпт по расписанию, а Доступно на всех облачных тарифах; для self-hosted требуется тариф Business или выше. -Рутина передаёт промпт Cuppy и повторяет его по расписанию. Это подходит для работы, которую никто не должен запускать вручную: ежедневный отчёт, регулярная чистка устаревших записей, еженедельная сводка. Каждый запуск — это полноценный чат с ИИ, поэтому рутине доступно всё то же, что и чату: чтение и запись таблиц, вызов навыков, создание файлов. +Рутина передаёт промпт Cuppy и повторяет его: по расписанию либо каждый раз, когда подключённое стороннее приложение сообщает о событии. Это подходит для работы, которую никто не должен запускать вручную: ежедневный отчёт, регулярная чистка устаревших записей, разбор письма сразу после получения. Каждый запуск — это полноценный чат с ИИ, поэтому рутине доступно всё то же, что и чату: чтение и запись таблиц, вызов навыков, создание файлов. Рутина — это ресурс внутри проекта, она стоит в левой боковой панели рядом с таблицами, приложениями и автоматизациями. -Автоматизация срабатывает на событие — изменение записи, отправку формы, вебхук — и выполняет заранее настроенные шаги. Рутина срабатывает только по времени и выполняет промпт, который агент трактует сам. Берите автоматизацию, когда нужны фиксированные шаги и предсказуемый результат; берите рутину, когда агент должен каждый раз сам решать, что делать с текущими данными. +Автоматизация выполняет заранее настроенные шаги, а рутина выполняет промпт, который агент трактует сам. Обе могут срабатывать по расписанию и обе — по событию из подключённого стороннего приложения. Берите автоматизацию, когда нужны фиксированные шаги и предсказуемый результат; берите рутину, когда агент должен каждый раз сам решать, что делать с текущими данными. ## Создание рутины @@ -20,29 +20,37 @@ description: Cuppy выполняет промпт по расписанию, а Опишите в поле **Промпт**, что должен делать каждый запуск. Промпт — это полная инструкция для запуска, поэтому укажите источник данных, порядок обработки и место для результата. Например: «Собери записи, добавленные вчера в таблицу Задачи, сгруппируй их по ответственным и запиши сводку в таблицу Ежедневный отчёт». - - Выберите частоту в разделе **Расписание** и при необходимости укажите **Начало** и **Окончание (необязательно)**. + + В поле **Триггер** выберите **По расписанию** или **По событию коннектора**, затем заполните настройки выбранного варианта. - Нажмите **Активировать**. Конфигурация должна быть сохранена, а в расписании должен быть хотя бы один будущий запуск. + Нажмите **Активировать**. Конфигурация должна быть сохранена: для варианта **По расписанию** нужен будущий запуск, для варианта **По событию коннектора** — пригодный аккаунт. ## Настройки -Помимо промпта и расписания форма содержит следующие настройки: +Помимо промпта и триггера форма содержит следующие настройки: | Настройка | Описание | | --- | --- | | **Модель** | Модель и уровень интеллекта, на которых работает эта рутина. Оставьте **Модель по умолчанию**, чтобы использовать модель чата, заданную в пространстве | | **Чат** | **Новый чат для каждого запуска** оставляет запуски независимыми друг от друга; **Продолжить чат предыдущего запуска** переносит контекст прошлых запусков и подходит для работы, которой нужен предыдущий результат | -| **Начало** / **Окончание (необязательно)** | Границы расписания. Без времени окончания рутина работает бессрочно | +| **Начало** / **Окончание (необязательно)** | Границы расписания, используются только вариантом **По расписанию**. Без времени окончания рутина работает бессрочно | Модель и уровень интеллекта фиксируются при сохранении, поэтому в истории выполнения видно, на чём фактически работал каждый запуск. +### Триггер + +**По расписанию** запускает рутину в заданное вами время; настройки описаны ниже в разделе «Расписание». + +**По событию коннектора** запускает её один раз всякий раз, когда подключённое стороннее приложение сообщает о событии: пришло письмо, заведена задача. Выберите приложение, событие, **Аккаунт**, который его получает, и параметры, которые требует событие; настраивается это так же, как триггер автоматизации, описанный в разделе [При получении события коннектора](/ru/basic/automation/trigger/external/connector-event). У рутины на этом триггере нет времени **Следующий запуск**, и она не использует ни расписание, ни его границы. + +Если выдачу аккаунта отозвали, подключённый аккаунт удалили или приложение остановило подписку, рутина показывает **Подписка отключена** и перестаёт получать события, а Teable уведомляет участника, который обновлял её последним. После повторного подключения того же аккаунта подписка восстанавливается сама; чтобы перейти на другой аккаунт, выберите его в триггере и сохраните. + ### Расписание -Частоту можно выбрать из готовых вариантов: **Ежечасно** с указанием минуты, **Ежедневно** и **По будням** с указанием времени, **Еженедельно** с указанием дня недели и времени, **Ежемесячно** с указанием числа и времени. +Расписание используется только вариантом **По расписанию**. Частоту можно выбрать из готовых вариантов: **Ежечасно** с указанием минуты, **Ежедневно** и **По будням** с указанием времени, **Еженедельно** с указанием дня недели и времени, **Ежемесячно** с указанием числа и времени. Для более точных условий выберите **Пользовательская (RRULE)** и напишите правило RFC 5545, например `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. У пользовательского правила есть ограничения: @@ -56,15 +64,17 @@ description: Cuppy выполняет промпт по расписанию, а ## Черновики, обновление и запуск вручную -Новая рутина — это черновик, и по расписанию она не запускается, пока вы её не активируете. При редактировании активной рутины изменение тоже сохраняется черновиком, а работающая версия продолжает использовать прежнюю конфигурацию: нажмите **Обновить**, чтобы применить его, или **Отменить изменения**, чтобы отказаться. +Новая рутина — это черновик, и сама она не запускается, пока вы её не активируете. При редактировании активной рутины изменение тоже сохраняется черновиком, а работающая версия продолжает использовать прежнюю конфигурацию: нажмите **Обновить**, чтобы применить его, или **Отменить изменения**, чтобы отказаться. + +**Запустить сейчас** выполняет рутину однократно, не дожидаясь триггера, — так удобно проверять промпт. Пока предыдущий запуск не завершился, запустить рутину вручную повторно нельзя. -**Запустить сейчас** выполняет рутину однократно, не дожидаясь расписания, — так удобно проверять промпт. Пока предыдущий запуск не завершился, запустить рутину вручную повторно нельзя. +Для ещё не активированной рутины на событии коннектора **Запустить сейчас** вместо запуска показывает **Ожидание события**: вызовите это событие в приложении, и Teable выполнит рутину один раз на полученном событии, а запуск появится в истории. Чтобы прервать ожидание, нажмите **Прекратить ожидание**. Активная рутина и так получает свои события, поэтому ей это не нужно и не разрешено. -Чтобы остановить рутину, выключите переключатель. Расписание перестанет срабатывать, а накопленная история выполнения сохранится. +Чтобы остановить рутину, выключите переключатель. Она перестанет срабатывать, а накопленная история выполнения сохранится. ## История выполнения -Откройте рутину и перейдите на вкладку **История выполнения**. Список запусков фильтруется по статусу и периоду, что помогает найти конкретный сбой; у выбранного запуска видно запланированное время, время начала и завершения, длительность и полный чат этого запуска. +Откройте рутину и перейдите на вкладку **История выполнения**. Список запусков фильтруется по статусу и периоду, что помогает найти конкретный сбой; у выбранного запуска видно **ID запуска**, **Триггер** и полный чат этого запуска. В поле **Триггер** стоит **По расписанию**, **По событию** или **Вручную**, а у запуска по расписанию дополнительно показано время **Запланирован**. Запуски отмечаются как **В очереди**, **Выполняется**, **Завершён**, **Ошибка** или **Отменено**. **Отменено** появляется, когда запуск кто-то прервал либо когда рутина или её проект были удалены. @@ -103,7 +113,7 @@ Teable отправляет уведомление, когда запуск за - Да. После установки шаблона его рутины включаются так же, как и его рабочие процессы. Расписание без будущих запусков остаётся черновиком. + Те, что по расписанию, — да. После установки шаблона они включаются так же, как и его рабочие процессы, а расписание без будущих запусков остаётся черновиком. Рутины на событии коннектора не включаются: учётные данные с шаблоном не переносятся, поэтому сначала выберите свой аккаунт. diff --git a/ru/basic/automation/trigger/external/connector-event.mdx b/ru/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..a69dcead --- /dev/null +++ b/ru/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "При получении события коннектора" +description: "Запуск рабочего процесса, когда подключённое стороннее приложение сообщает о событии" +--- + +Доступно на всех облачных тарифах; для self-hosted нужен тариф Business или выше, а события коннектора должен включить тот, кто обслуживает установку. + +Начните рабочий процесс с того, что происходит внутри подключённого приложения — GitHub, Gmail, Slack: пришло письмо, заведена задача, опубликовано сообщение. Приложение доставляет событие прямо в Teable, поэтому вам не нужно держать URL вебхука и не нужно ничего опрашивать. + +## Сборка с помощью ИИ + +Откройте чат с ИИ в правой панели любой таблицы и опишите, что вам нужно. + +ИИ сделает всё сам: выберет подходящий триггер, сопоставит нужные поля и настроит действия. + +Опишите цель один раз, и рабочий процесс готов, без ручной настройки. + +**Пример:** *«Когда в моём репозитории GitHub заводят новую задачу, создай запись в таблице Задачи»* + +## Как настроить + + + + Создайте рабочий процесс и выберите триггер **При получении события коннектора**. + + + Укажите приложение в поле **Приложение**, затем конкретное событие в поле **Событие**. У каждого события в списке есть короткое описание и метка; метки разобраны ниже. + + + В поле **Аккаунт** укажите, какой подключённый аккаунт получает событие. Если это приложение ещё не подключено, подключите его прямо из этого списка: новое подключение автоматически выдаётся этому рабочему процессу. + + + Заполните **Параметры**, которые требует событие: репозиторий, канал, метку. Поля со знаком * обязательны. Затем нажмите **Сохранить**. + + + Добавьте следующие действия и включите рабочий процесс. Подписка создаётся при активации, поэтому черновик ничего не получает. + + + +Если сменить приложение или событие, последующие шаги очищаются, а переменные, ссылавшиеся на прежнее событие, перестают разрешаться, так что эти шаги придётся настроить заново. + +## Метки событий + +| Метка | Что означает | +| --- | --- | +| **Мгновенно** | Приложение само отправляет событие, и оно приходит вскоре после того, как произошло | +| **Опрос · может занять несколько минут** | Teable периодически опрашивает приложение, поэтому не полагайтесь на такие события там, где важна скорость | +| **Срабатывает часто** | На практике это событие происходит помногу, и каждое срабатывание считается запуском автоматизации | +| **Устарело** | Приложение пометило событие как устаревшее и может перестать его отправлять, выберите другое | + +## Данные, доступные после триггера + +Само событие попадает в переменную **event**, которую последующие шаги вставляют через **+**. Сразу после настройки переменная пуста: сначала должно прийти настоящее событие. Нажмите **Проверить триггер**, дождитесь надписи **Ожидание события** на панели и вызовите это событие в приложении. Событие типа «опрос» может прийти через несколько минут. + +Пришедшее событие остаётся на триггере как образец данных, поэтому следующие шаги могут обращаться к его полям. Чтобы прервать ожидание, нажмите **Прекратить ожидание**; примерно через 30 минут без события панель сообщит **Ожидание завершено, событие не пришло.** + +## Если подключение оборвалось + +Триггер перестаёт получать события, если выдачу аккаунта отозвали, подключённый аккаунт удалили, приложение остановило подписку (истекли учётные данные или подписка неисправна) либо подписку не удалось создать. Сам рабочий процесс не выключается, но новых запусков не будет, пока всё не восстановят. + +Teable уведомляет участника, который последним редактировал рабочий процесс, а на панели триггера появляется **Отключено — переподключите аккаунт или выберите другой**. Восстанавливайте по причине: + +- Нажмите **Переподключить** у того же аккаунта в разделе **Настройки** → **Интеграции**: подписка восстановится сама. +- Чтобы перейти на другой аккаунт, вернитесь в триггер, выберите другой **Аккаунт** и сохраните. +- Если подписку не удалось создать, проверьте параметры и сохраните ещё раз, чтобы повторить попытку. + +## После копирования или импорта + +Учётные данные не переносятся вместе с рабочим процессом. После копирования процесса либо импорта или копирования проекта триггер показывает **Аккаунт не авторизован**: выберите свой аккаунт и сохраните, и тогда рабочий процесс снова сможет подписаться. + +## Смежные документы + +- [Учётные данные и интеграции](/ru/basic/credential) +- [Рутина](/ru/basic/ai/routine) diff --git a/ru/basic/credential.mdx b/ru/basic/credential.mdx index 819a9159..2a06ba0d 100644 --- a/ru/basic/credential.mdx +++ b/ru/basic/credential.mdx @@ -63,6 +63,12 @@ description: Управляйте своими подключениями и с Если вставить в поле автоматизации строку, похожую на ключ, Teable сохранит её как ваш секрет и оставит на месте ссылку, поэтому открытый текст не попадёт в конфигурацию рабочего процесса. Чтобы оставить текст как есть, нажмите **Отменить** в уведомлении. +## Кредиты за вызовы сторонних приложений + +Вызов стороннего приложения через подключение расходует кредиты пространства — неважно, идёт ли вызов из ИИ-чата, из приложения или из автоматизации. Эти списания попадают в **Суммарное использование кредитов** на странице оплаты под типом **Сторонние приложения**. + +Большинство приложений стоит очень немного за вызов. Приложения, которые выставляют Teable счёт за каждый возвращённый объект или за каждый запрос, например X, обходятся за один вызов заметно дороже. Неудавшиеся вызовы не списываются, поиск доступных инструментов тоже. Когда кредиты пространства заканчиваются, такие вызовы отклоняются. + ## Карточки авторизации в ИИ-чате Когда ИИ нужен внешний аккаунт, он закрепляет в беседе карточку с заголовком **Для этой задачи требуется авторизация** и ждёт вашего действия, прежде чем продолжить ход. Карточек две — в зависимости от того, кому нужны учётные данные. diff --git a/tr/basic/ai/routine.mdx b/tr/basic/ai/routine.mdx index b474392a..453e6205 100644 --- a/tr/basic/ai/routine.mdx +++ b/tr/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Cuppy bir prompt'u zamanlamaya göre çalıştırsın, her çalış Tüm Cloud planlarında kullanılabilir; self-hosted için Business veya üzeri gerekir. -Rutin, bir prompt'u Cuppy'ye devreder ve zamanlamaya göre tekrarlar. Bu, kimsenin elle başlatmasına gerek olmayan işler için uygundur: günlük rapor, süresi dolmuş kayıtların düzenli temizliği, haftalık özet. Her çalıştırma eksiksiz bir AI sohbetidir; dolayısıyla bir rutin, tablo okuyup yazmak, beceri çağırmak ve dosya üretmek dahil AI sohbetin yaptığı her şeyi yapabilir. +Rutin, bir prompt'u Cuppy'ye devreder ve onu ya zamanlamaya göre ya da bağlı bir üçüncü taraf uygulama bir olay bildirdiğinde tekrarlar. Bu, kimsenin elle başlatmasına gerek olmayan işler için uygundur: günlük rapor, süresi dolmuş kayıtların düzenli temizliği, gelen bir e-postanın anında dosyalanması. Her çalıştırma eksiksiz bir AI sohbetidir; dolayısıyla bir rutin, tablo okuyup yazmak, beceri çağırmak ve dosya üretmek dahil AI sohbetin yaptığı her şeyi yapabilir. Rutin, proje içindeki bir kaynaktır ve sol kenar çubuğunda tablolar, uygulamalar ve otomasyonların yanında yer alır. -Otomasyon; kayıt değişikliği, form gönderimi veya webhook gibi bir olayla tetiklenir ve önceden yapılandırdığınız adımları çalıştırır. Rutin yalnızca zamanla tetiklenir ve ajanın kendisinin yorumladığı bir prompt'u çalıştırır. Sabit adımlara ve öngörülebilir sonuca ihtiyacınız varsa otomasyonu; ajanın her seferinde güncel veriye bakıp kendisi karar vermesini istiyorsanız rutini seçin. +Otomasyon, önceden yapılandırdığınız adımları çalıştırır; rutin ise ajanın kendisinin yorumladığı bir prompt'u çalıştırır. İkisi de zamanlamayla tetiklenebilir, ikisi de bağlı bir üçüncü taraf uygulamadan gelen bir olayla tetiklenebilir. Sabit adımlara ve öngörülebilir sonuca ihtiyacınız varsa otomasyonu; ajanın her seferinde güncel veriye bakıp kendisi karar vermesini istiyorsanız rutini seçin. ## Rutin oluşturma @@ -20,29 +20,37 @@ Rutin, proje içindeki bir kaynaktır ve sol kenar çubuğunda tablolar, uygulam **Prompt** alanında her çalıştırmanın ne yapacağını anlatın. Prompt, bir çalıştırmanın tüm talimatıdır; bu yüzden verinin nereden geldiğini, nasıl işleneceğini ve sonucun nereye yazılacağını belirtin. Örneğin: "Görevler tablosuna dün eklenen kayıtları özetle, sorumluya göre grupla ve özeti Günlük Rapor tablosuna yaz." - - **Zamanlama** altında bir sıklık seçin, gerekiyorsa **Başlangıç** ve **Bitiş (isteğe bağlı)** değerlerini girin. + + **Tetikleyici** altında **Zamanlamaya göre** veya **Bağlayıcı olayında** seçeneğini belirleyin, ardından o türün istediği ayarları doldurun. - **Etkinleştir** düğmesine tıklayın. Yapılandırmanın kaydedilmiş olması ve zamanlamada gelecekte bir çalıştırmanın bulunması gerekir. + **Etkinleştir** düğmesine tıklayın. Yapılandırmanın kaydedilmiş olması gerekir: **Zamanlamaya göre** için gelecekte bir çalıştırma, **Bağlayıcı olayında** için kullanılabilir bir hesap gerekir. ## Ayarlar -Prompt ve zamanlamanın dışında formda şu ayarlar bulunur: +Prompt ve tetikleyicinin dışında formda şu ayarlar bulunur: | Ayar | Açıklama | | --- | --- | | **Model** | Bu rutinin çalıştığı model ve zekâ düzeyi. **Varsayılan model** bırakıldığında alanın varsayılan sohbet modeli kullanılır | | **Sohbet** | **Her çalıştırmada yeni sohbet**, çalıştırmaları birbirinden bağımsız tutar; **Önceki çalıştırmanın sohbetine devam et**, önceki çalıştırmaların bağlamını taşır ve son sonuca başvurması gereken işler için uygundur | -| **Başlangıç** / **Bitiş (isteğe bağlı)** | Zamanlamanın sınırları. Bitiş zamanı verilmezse rutin süresiz çalışmaya devam eder | +| **Başlangıç** / **Bitiş (isteğe bağlı)** | Zamanlamanın sınırları; yalnızca **Zamanlamaya göre** için kullanılır. Bitiş zamanı verilmezse rutin süresiz çalışmaya devam eder | Model ve zekâ düzeyi kaydederken birlikte yazılır; bu sayede çalıştırma geçmişinde her çalıştırmanın gerçekte neyle çalıştığı görünür. +### Tetikleyici + +**Zamanlamaya göre**, rutini belirlediğiniz saatlerde çalıştırır; ayarları aşağıdaki Zamanlama bölümündedir. + +**Bağlayıcı olayında**, bağlı bir üçüncü taraf uygulama bir olay bildirdiğinde rutini bir kez çalıştırır; örneğin yeni bir e-posta ya da yeni bir sorun kaydı. Uygulamayı, olayı, olayı alacak **Hesap** değerini ve olayın istediği parametreleri seçmeniz yeterlidir; yapılandırma, [Bağlayıcı olayı alındığında](/tr/basic/automation/trigger/external/connector-event) bölümünde anlatılan otomasyon tetikleyicisiyle aynıdır. Bu tetikleyicideki bir rutinin **Sonraki çalıştırma** saati olmaz; zamanlamayı ve sınırlarını da kullanmaz. + +Hesap yetkisi geri alındığında, bağlı hesap kaldırıldığında ya da uygulama aboneliği durdurduğunda rutin **Abonelik kesildi** durumuna geçer ve olay almayı bırakır; Teable, rutini en son güncelleyen üyeye bildirim gönderir. Aynı hesabı yeniden bağladığınızda abonelik kendiliğinden kurulur; başka bir hesaba geçmek için tetikleyicide hesabı yeniden seçip kaydedin. + ### Zamanlama -Sıklığı hazır seçeneklerden belirleyin: dakikası verilen **Saatlik**, saati verilen **Günlük** ve **Hafta içi**, gün ve saati verilen **Haftalık**, ayın günü ve saati verilen **Aylık**. +Zamanlama yalnızca **Zamanlamaya göre** için kullanılır. Sıklığı hazır seçeneklerden belirleyin: dakikası verilen **Saatlik**, saati verilen **Günlük** ve **Hafta içi**, gün ve saati verilen **Haftalık**, ayın günü ve saati verilen **Aylık**. Daha özel bir kurala ihtiyaç duyarsanız **Özel (RRULE)** seçeneğini seçip `FREQ=DAILY;BYHOUR=9;BYMINUTE=0` gibi bir RFC 5545 kuralı yazın. Özel kuralın sınırları şunlardır: @@ -56,15 +64,17 @@ Zamanlama, rutini oluşturan kişinin saat dilimine göre hesaplanır ve görün ## Taslak, güncelleme ve hemen çalıştırma -Yeni oluşturulan rutin bir taslaktır ve siz etkinleştirene kadar zamanlamaya göre çalışmaz. Etkin bir rutini düzenlediğinizde değişiklik yine taslak olarak kaydedilir, yayındaki sürüm eski yapılandırmayla çalışmayı sürdürür: uygulamak için **Güncelle**, vazgeçmek için **Değişiklikleri sil** düğmesine tıklayın. +Yeni oluşturulan rutin bir taslaktır ve siz etkinleştirene kadar kendiliğinden çalışmaz. Etkin bir rutini düzenlediğinizde değişiklik yine taslak olarak kaydedilir, yayındaki sürüm eski yapılandırmayla çalışmayı sürdürür: uygulamak için **Güncelle**, vazgeçmek için **Değişiklikleri sil** düğmesine tıklayın. + +**Şimdi çalıştır**, tetikleyiciyi beklemeden bir kez çalıştırır; prompt'u denemek için elverişlidir. Önceki çalıştırma bitmeden aynı rutin elle yeniden çalıştırılamaz. -**Şimdi çalıştır**, zamanlamayı beklemeden bir kez çalıştırır; prompt'u denemek için elverişlidir. Önceki çalıştırma bitmeden aynı rutin elle yeniden çalıştırılamaz. +Henüz etkinleştirilmemiş bir bağlayıcı olayı rutininde **Şimdi çalıştır**, bunun yerine **Olay bekleniyor** gösterir: uygulamada o olayı tetikleyin; Teable gelen olayı kullanarak rutini bir kez çalıştırır ve çalıştırma geçmişe düşer. Beklemeyi kesmek için **Beklemeyi durdur** düğmesine tıklayın. Etkin bir rutin olaylarını zaten alır; bu yüzden buna ne ihtiyacı vardır ne de izin verilir. -Durdurmak için anahtarı kapatın. Zamanlama artık tetiklenmez, mevcut çalıştırma geçmişi korunur. +Durdurmak için anahtarı kapatın. Rutin artık tetiklenmez, mevcut çalıştırma geçmişi korunur. ## Çalıştırma Geçmişi -Rutini açıp **Çalıştırma Geçmişi** sekmesine geçin. Liste duruma ve tarih aralığına göre filtrelenebilir; bu, belirli bir hatayı bulmayı kolaylaştırır. Bir çalıştırmayı seçtiğinizde planlanan, başlangıç ve bitiş zamanlarını, süreyi ve o çalıştırmanın tüm sohbetini görürsünüz. +Rutini açıp **Çalıştırma Geçmişi** sekmesine geçin. Liste duruma ve tarih aralığına göre filtrelenebilir; bu, belirli bir hatayı bulmayı kolaylaştırır. Bir çalıştırmayı seçtiğinizde **Çalıştırma kimliği**, **Tetikleyici** ve o çalıştırmanın tüm sohbeti görünür. **Tetikleyici**; **Zamanlanmış**, **Olay** veya **Manuel** olur ve zamanlanmış bir çalıştırma ayrıca karşılık geldiği **Planlanan** saati gösterir. Çalıştırmalar **Sırada**, **Çalışıyor**, **Tamamlandı**, **Başarısız** veya **İptal** olarak bildirilir. **İptal**, çalıştırmayı birinin durdurduğu ya da rutinin veya projesinin silindiği durumlarda görünür. @@ -103,7 +113,7 @@ Her başarısız çalıştırma bu sayıya girmez: önceki çalıştırma sürd - Çalışır. Şablon kurulduktan sonra rutinleri, iş akışları gibi açılır. Gelecekte çalıştırması bulunmayan bir zamanlama taslak olarak kalır. + Zamanlanmış olanlar çalışır. Şablon kurulduktan sonra iş akışları gibi açılırlar ve gelecekte çalıştırması bulunmayan bir zamanlama taslak olarak kalır. Bağlayıcı olayı rutinleri açılmaz: kimlik bilgileri şablonla birlikte gelmediğinden, etkinleştirmeden önce kendi hesabınızı seçin. diff --git a/tr/basic/automation/trigger/external/connector-event.mdx b/tr/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..3854c346 --- /dev/null +++ b/tr/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "Bağlayıcı olayı alındığında" +description: "Bağlı bir üçüncü taraf uygulama bir olay bildirdiğinde iş akışını çalıştırın" +--- + +Tüm bulut planlarında kullanılabilir; kendi sunucunuzda barındırılan sürüm için Business veya üzeri bir plan gerekir ve bağlayıcı olaylarının kurulumu yöneten tarafça açılmış olması gerekir. + +Bir iş akışını, GitHub, Gmail veya Slack gibi bağlı bir uygulamada olup bitenden başlatın: yeni bir e-posta gelir, bir sorun kaydı açılır, bir mesaj gönderilir. Olayı uygulama doğrudan Teable'a iletir; bu yüzden bir webhook adresi barındırmanız ya da değişiklikleri yoklamanız gerekmez. + +## AI ile oluşturma + +Herhangi bir tablonun sağ kenar çubuğunda AI sohbetini açın ve ne istediğinizi anlatın. + +Gerisini AI halleder: doğru tetikleyiciyi seçer, ilgili alanları eşler ve eylemleri kurar. + +Hedefi bir kez anlatın, iş akışı elle yapılandırmaya gerek kalmadan hazır olsun. + +**Örnek:** *"GitHub depomda yeni bir sorun kaydı açıldığında Görevler tablosunda bir kayıt oluştur"* + +## Nasıl kurulur + + + + Bir iş akışı oluşturun ve tetikleyici olarak **Bağlayıcı olayı alındığında** seçeneğini belirleyin. + + + **Uygulama** altında uygulamayı, ardından **Olay** altında belirli olayı seçin. Listedeki her olayın tek satırlık bir açıklaması ve bir etiketi vardır; etiketler aşağıda açıklanmıştır. + + + **Hesap** altında olayı hangi bağlı hesabın alacağını seçin. Bu uygulamayı hiç bağlamadıysanız aynı açılır listeden bağlayın: yeni bağlantı bu iş akışına kendiliğinden verilir. + + + Olayın istediği **Parametreler** alanını doldurun; örneğin bir depo, bir kanal veya bir etiket. * işaretli alanlar zorunludur. Bitirince **Kaydet** düğmesine tıklayın. + + + Sonraki eylemleri ekleyip iş akışını açın. Abonelik iş akışı etkinleştirildiğinde kurulur, dolayısıyla bir taslak hiçbir şey almaz. + + + +Uygulamayı ya da olayı değiştirdiğinizde sonraki adımlar temizlenir ve önceki olaya başvuran değişkenler artık çözümlenmez; bu adımları yeniden yapılandırmanız gerekir. + +## Olay etiketleri + +| Etiket | Anlamı | +| --- | --- | +| **Anında** | Olayı uygulama gönderir ve olay, gerçekleştikten kısa süre sonra ulaşır | +| **Yoklama · birkaç dakika sürebilir** | Teable uygulamayı düzenli aralıklarla yoklar; zamanlamanın önemli olduğu yerlerde bu olaylara güvenmeyin | +| **Sık tetiklenir** | Bu olay uygulamada çok sık gerçekleşir ve her tetiklenme bir otomasyon çalıştırması sayılır | +| **Kullanım dışı** | Uygulama bu olayı kullanım dışı bıraktı ve göndermeyi durdurabilir; başka bir olay seçin | + +## Tetikleyiciden sonra kullanılabilen veriler + +Olayın kendisi **event** değişkenine düşer; sonraki adımlar bunu **+** ile ekler. Tetikleyiciyi yapılandırdıktan hemen sonra değişken boştur: önce gerçek bir olayın gelmesi gerekir. **Tetikleyiciyi test et** düğmesine tıklayın ve panel **Olay bekleniyor** gösterdiğinde uygulamaya gidip olayı tetikleyin. Yoklamalı bir olayın ulaşması birkaç dakika sürebilir. + +Gelen olay örnek veri olarak tetikleyicide kalır, böylece sonraki adımlar alanlarına başvurabilir. Beklemeyi erken bitirmek için **Beklemeyi durdur** düğmesine tıklayın; yaklaşık 30 dakika boyunca olay gelmezse panelde **Hiçbir olay gelmeden bekleme sona erdi.** yazar. + +## Bağlantı koptuğunda + +Hesap yetkisi geri alındığında, bağlı hesap kaldırıldığında, uygulama aboneliği durdurduğunda (kimlik bilgilerinin süresi dolmuş ya da abonelik sağlıksız) veya abonelik oluşturulamadığında tetikleyici olay almayı bırakır. İş akışının kendisi kapanmaz, ama düzelene kadar yeni bir çalıştırma olmaz. + +Teable, iş akışını en son düzenleyen üyeye bildirim gönderir; tetikleyici panelinde de **Bağlantı kesildi — hesabı yeniden bağlayın veya başka birini seçin** yazar. Nedene göre düzeltin: + +- **Ayarlar** → **Entegrasyonlar** altında aynı hesapta **Yeniden bağla** düğmesine tıklayın; abonelik kendiliğinden kurulur. +- Başka bir hesap kullanacaksanız tetikleyiciye dönüp başka bir **Hesap** seçin ve kaydedin. +- Abonelik oluşturulamadıysa parametreleri kontrol edip yeniden kaydedin; böylece yeniden denenir. + +## Kopyalama veya içe aktarmadan sonra + +Kimlik bilgileri iş akışıyla birlikte taşınmaz. Bir iş akışını kopyaladıktan ya da bir projeyi içe aktardıktan veya kopyaladıktan sonra tetikleyicide **Hesap yetkilendirilmedi** yazar: kendi hesaplarınızdan birini seçip kaydedin ki iş akışı yeniden abone olabilsin. + +## İlgili belgeler + +- [Kimlik Bilgileri ve Entegrasyonlar](/tr/basic/credential) +- [Rutin](/tr/basic/ai/routine) diff --git a/tr/basic/credential.mdx b/tr/basic/credential.mdx index 0d496792..fa882bb8 100644 --- a/tr/basic/credential.mdx +++ b/tr/basic/credential.mdx @@ -63,6 +63,12 @@ Bir projede bağlanmamış entegrasyonlar kaldığı sürece sayfanın üstünde Bir otomasyon giriş alanına anahtara benzeyen bir değer yapıştırdığınızda Teable bunu sizin gizli anahtarınız olarak kaydeder ve yerinde bir referans bırakır; böylece düz metin iş akışı yapılandırmasına girmez. Metnin olduğu gibi kalmasını isterseniz bildirimdeki **Geri al**'a tıklayın. +## Üçüncü taraf uygulama çağrılarının kredisi + +Bir bağlantı üzerinden üçüncü taraf uygulama çağırmak alanın kredisinden düşer; çağrı ister AI Chat'ten, ister bir uygulamadan, ister bir otomasyondan gelsin. Bu harcamalar faturalandırma sayfasındaki **Kredi Kullanım Bilgileri** bölümünde **Üçüncü taraf uygulamalar** türü altında listelenir. + +Uygulamaların çoğu çağrı başına çok az harcar. X gibi dönen kayıt ya da istek başına Teable'a fatura kesen uygulamalarda tek bir çağrı gözle görülür biçimde pahalıdır. Başarısız çağrılar ücretlendirilmez, kullanılabilir araçların aranması da öyle. Alanın kredisi bittiğinde bu çağrılar reddedilir. + ## AI Chat'te yetkilendirme kartları AI'ın bir dış hesaba ihtiyacı olduğunda sohbete **Bu görev için yetkilendirme gerekli** başlıklı bir kart sabitlenir ve siz karşılık verene kadar tur ilerlemez. Kimlik bilgisine kimin ihtiyaç duyduğuna göre iki tür kart vardır. diff --git a/uk/basic/ai/routine.mdx b/uk/basic/ai/routine.mdx index 7b746c25..7cdf09e6 100644 --- a/uk/basic/ai/routine.mdx +++ b/uk/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: Cuppy виконує промпт за розкладом, а ре Доступно на всіх хмарних тарифах; для self-hosted потрібен тариф Business або вищий. -Рутина передає промпт Cuppy і повторює його за розкладом. Це підходить для роботи, яку ніхто не має запускати вручну: щоденний звіт, регулярне прибирання застарілих записів, тижнева зведення. Кожен запуск — це повноцінний чат з ШІ, тож рутині доступне все те саме, що й чату: читання і запис таблиць, виклик навичок, створення файлів. +Рутина передає промпт Cuppy і повторює його: за розкладом або щоразу, коли під'єднаний сторонній застосунок повідомляє про подію. Це підходить для роботи, яку ніхто не має запускати вручну: щоденний звіт, регулярне прибирання застарілих записів, розбір листа одразу після отримання. Кожен запуск — це повноцінний чат з ШІ, тож рутині доступне все те саме, що й чату: читання і запис таблиць, виклик навичок, створення файлів. Рутина — це ресурс усередині проєкту, вона стоїть на лівій бічній панелі поруч із таблицями, застосунками та автоматизаціями. -Автоматизація спрацьовує на подію — зміну запису, надсилання форми, вебхук — і виконує наперед налаштовані кроки. Рутина спрацьовує лише за часом і виконує промпт, який агент тлумачить сам. Беріть автоматизацію, коли потрібні фіксовані кроки й передбачуваний результат; беріть рутину, коли агент має щоразу сам вирішувати, що робити з поточними даними. +Автоматизація виконує наперед налаштовані кроки, а рутина виконує промпт, який агент тлумачить сам. Обидві можуть спрацьовувати за розкладом і обидві — за подією з під'єднаного стороннього застосунку. Беріть автоматизацію, коли потрібні фіксовані кроки й передбачуваний результат; беріть рутину, коли агент має щоразу сам вирішувати, що робити з поточними даними. ## Створення рутини @@ -20,29 +20,37 @@ description: Cuppy виконує промпт за розкладом, а ре Опишіть у полі **Промпт**, що має робити кожен запуск. Промпт — це повна інструкція для запуску, тож зазначте джерело даних, порядок обробки та місце для результату. Наприклад: «Збери записи, додані вчора до таблиці Завдання, згрупуй їх за відповідальними і запиши зведення до таблиці Щоденний звіт». - - Виберіть частоту в розділі **Розклад** і за потреби вкажіть **Початок** та **Завершення (необов'язково)**. + + У полі **Тригер** виберіть **За розкладом** або **За подією конектора**, після чого заповніть налаштування вибраного варіанта. - Натисніть **Активувати**. Конфігурація має бути збережена, а в розкладі має бути хоча б один майбутній запуск. + Натисніть **Активувати**. Конфігурація має бути збережена: для варіанта **За розкладом** потрібен майбутній запуск, для варіанта **За подією конектора** — придатний обліковий запис. ## Налаштування -Крім промпта й розкладу, форма містить такі налаштування: +Крім промпта й тригера, форма містить такі налаштування: | Налаштування | Опис | | --- | --- | | **Модель** | Модель і рівень інтелекту, на яких працює ця рутина. Залиште **Модель за замовчуванням**, щоб використати модель чату, задану в просторі | | **Чат** | **Новий чат для кожного запуску** лишає запуски незалежними один від одного; **Продовжити чат попереднього запуску** переносить контекст минулих запусків і підходить для роботи, якій потрібен попередній результат | -| **Початок** / **Завершення (необов'язково)** | Межі розкладу. Без часу завершення рутина працює безстроково | +| **Початок** / **Завершення (необов'язково)** | Межі розкладу, які використовує лише варіант **За розкладом**. Без часу завершення рутина працює безстроково | Модель і рівень інтелекту фіксуються під час збереження, тому в історії запусків видно, на чому фактично працював кожен запуск. +### Тригер + +**За розкладом** запускає рутину в заданий вами час; налаштування описані нижче в розділі «Розклад». + +**За подією конектора** запускає її один раз щоразу, коли під'єднаний сторонній застосунок повідомляє про подію: надійшов лист, створено задачу. Виберіть застосунок, подію, **Обліковий запис**, який її отримує, і параметри, яких вимагає подія; налаштовується це так само, як тригер автоматизації, описаний у розділі [Під час отримання події конектора](/uk/basic/automation/trigger/external/connector-event). Рутина на цьому тригері не має часу **Наступний запуск** і не використовує ні розклад, ні його межі. + +Якщо надання облікового запису відкликано, під'єднаний обліковий запис видалено або застосунок зупинив підписку, рутина показує **Підписку від'єднано** і перестає отримувати події, а Teable сповіщає учасника, який оновлював її останнім. Після повторного під'єднання того самого облікового запису підписка відновлюється сама; щоб перейти на інший, виберіть його в тригері та збережіть. + ### Розклад -Частоту можна вибрати з готових варіантів: **Щогодини** із зазначенням хвилини, **Щодня** і **У будні** із зазначенням часу, **Щотижня** із зазначенням дня тижня й часу, **Щомісяця** із зазначенням числа й часу. +Розклад використовує лише варіант **За розкладом**. Частоту можна вибрати з готових варіантів: **Щогодини** із зазначенням хвилини, **Щодня** і **У будні** із зазначенням часу, **Щотижня** із зазначенням дня тижня й часу, **Щомісяця** із зазначенням числа й часу. Для точніших умов виберіть **Користувацька (RRULE)** і напишіть правило RFC 5545, наприклад `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. Користувацьке правило має такі обмеження: @@ -56,15 +64,17 @@ description: Cuppy виконує промпт за розкладом, а ре ## Чернетки, оновлення та запуск вручну -Нова рутина — це чернетка, і за розкладом вона не запускається, доки ви її не активуєте. Коли ви редагуєте активну рутину, зміна теж зберігається чернеткою, а робоча версія продовжує працювати з попередньою конфігурацією: натисніть **Оновити**, щоб застосувати її, або **Відхилити зміни**, щоб відмовитися. +Нова рутина — це чернетка, і сама вона не запускається, доки ви її не активуєте. Коли ви редагуєте активну рутину, зміна теж зберігається чернеткою, а робоча версія продовжує працювати з попередньою конфігурацією: натисніть **Оновити**, щоб застосувати її, або **Відхилити зміни**, щоб відмовитися. + +**Запустити зараз** виконує рутину один раз, не чекаючи на тригер, — так зручно перевіряти промпт. Доки попередній запуск не завершився, запустити рутину вручну ще раз не вийде. -**Запустити зараз** виконує рутину один раз, не чекаючи на розклад, — так зручно перевіряти промпт. Доки попередній запуск не завершився, запустити рутину вручну ще раз не вийде. +Для ще не активованої рутини на події конектора **Запустити зараз** натомість показує **Очікування події**: викличте цю подію в застосунку, і Teable виконає рутину один раз на отриманій події, а запуск з'явиться в історії. Щоб припинити очікування, натисніть **Припинити очікування**. Активна рутина й так отримує свої події, тому їй це не потрібно й не дозволено. -Щоб зупинити рутину, вимкніть перемикач. Розклад більше не спрацьовуватиме, а наявна історія запусків збережеться. +Щоб зупинити рутину, вимкніть перемикач. Вона більше не спрацьовуватиме, а наявна історія запусків збережеться. ## Історія запусків -Відкрийте рутину і перейдіть на вкладку **Історія запусків**. Список запусків фільтрується за статусом і періодом, що допомагає знайти конкретний збій; у вибраного запуску видно запланований час, час початку й завершення, тривалість і повний чат цього запуску. +Відкрийте рутину і перейдіть на вкладку **Історія запусків**. Список запусків фільтрується за статусом і періодом, що допомагає знайти конкретний збій; у вибраного запуску видно **ID запуску**, **Тригер** і повний чат цього запуску. У полі **Тригер** стоїть **За розкладом**, **Подія** або **Вручну**, а запуск за розкладом додатково показує час **Заплановано**. Запуски позначаються як **У черзі**, **Виконується**, **Завершено**, **Помилка** або **Скасовано**. **Скасовано** з'являється, коли запуск хтось перервав або коли рутину чи її проєкт було видалено. @@ -103,7 +113,7 @@ Teable надсилає сповіщення, коли запуск заверш - Так. Після встановлення шаблону його рутини вмикаються так само, як і його робочі процеси. Розклад без майбутніх запусків лишається чернеткою. + Ті, що за розкладом, — так. Після встановлення шаблону вони вмикаються так само, як і його робочі процеси, а розклад без майбутніх запусків лишається чернеткою. Рутини на події конектора не вмикаються: облікові дані не переносяться з шаблоном, тому спершу виберіть свій обліковий запис. diff --git a/uk/basic/automation/trigger/external/connector-event.mdx b/uk/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..81c76eb0 --- /dev/null +++ b/uk/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "Під час отримання події конектора" +description: "Запуск робочого процесу, коли під'єднаний сторонній застосунок повідомляє про подію" +--- + +Доступно на всіх хмарних тарифах; для self-hosted потрібен тариф Business або вищий, а події конектора має увімкнути той, хто обслуговує встановлення. + +Починайте робочий процес із того, що стається всередині під'єднаного застосунку — GitHub, Gmail, Slack: надійшов лист, створено задачу, опубліковано повідомлення. Застосунок доставляє подію просто до Teable, тож вам не потрібно тримати URL вебхука й нічого опитувати. + +## Створення за допомогою ШІ + +Відкрийте чат зі ШІ на правій бічній панелі будь-якої таблиці та опишіть, що вам потрібно. + +ШІ зробить усе сам: вибере відповідний тригер, зіставить потрібні поля й налаштує дії. + +Опишіть мету один раз — і робочий процес готовий, без ручного налаштування. + +**Приклад:** *«Коли в моєму репозиторії GitHub створюють нову задачу, додай запис до таблиці Завдання»* + +## Як налаштувати + + + + Створіть робочий процес і виберіть тригер **Під час отримання події конектора**. + + + Укажіть застосунок у полі **Застосунок**, а потім конкретну подію в полі **Подія**. Кожна подія у списку має короткий опис і позначку; позначки пояснено нижче. + + + У полі **Обліковий запис** укажіть, який під'єднаний обліковий запис отримує подію. Якщо цей застосунок ще не під'єднано, під'єднайте його просто з цього ж списку: нове підключення автоматично надається цьому робочому процесу. + + + Заповніть **Параметри**, яких вимагає подія: репозиторій, канал, мітку. Поля зі знаком * обов'язкові. Потім натисніть **Зберегти**. + + + Додайте наступні дії та увімкніть робочий процес. Підписка створюється під час активації, тому чернетка нічого не отримує. + + + +Якщо змінити застосунок або подію, наступні кроки очищаються, а змінні, що посилалися на попередню подію, перестають розв'язуватися, тож ці кроки доведеться налаштувати заново. + +## Позначки подій + +| Позначка | Що означає | +| --- | --- | +| **Миттєво** | Застосунок сам надсилає подію, і вона надходить невдовзі після того, як сталася | +| **Опитування · може тривати кілька хвилин** | Teable періодично опитує застосунок, тому не покладайтеся на такі події там, де важлива швидкість | +| **Спрацьовує часто** | На практиці ця подія стається дуже часто, і кожне спрацювання зараховується як запуск автоматизації | +| **Застаріло** | Застосунок позначив подію як застарілу й може припинити її надсилати, виберіть іншу | + +## Дані, доступні після тригера + +Сама подія потрапляє до змінної **event**, яку наступні кроки вставляють через **+**. Одразу після налаштування змінна порожня: спершу має надійти справжня подія. Натисніть **Перевірити тригер**, дочекайтеся напису **Очікування події** на панелі й викличте цю подію в застосунку. Подія типу «опитування» може надійти за кілька хвилин. + +Отримана подія лишається на тригері як зразок даних, тож наступні кроки можуть звертатися до її полів. Щоб припинити очікування, натисніть **Припинити очікування**; приблизно за 30 хвилин без події панель повідомить **Очікування завершено, подія не надійшла.** + +## Якщо підключення обірвалося + +Тригер перестає отримувати події, якщо надання облікового запису відкликано, під'єднаний обліковий запис видалено, застосунок зупинив підписку (спливли облікові дані або підписка несправна) чи підписку не вдалося створити. Сам робочий процес не вимикається, але нових запусків не буде, доки все не відновлять. + +Teable сповіщає учасника, який останнім редагував робочий процес, а на панелі тригера з'являється **Від'єднано — під'єднайте обліковий запис знову або виберіть інший**. Відновлюйте за причиною: + +- Натисніть **Підключити знову** для того самого облікового запису в розділі **Налаштування** → **Інтеграції**: підписка відновиться сама. +- Щоб перейти на інший обліковий запис, поверніться до тригера, виберіть інший **Обліковий запис** і збережіть. +- Якщо підписку не вдалося створити, перевірте параметри та збережіть ще раз, щоб повторити спробу. + +## Після копіювання або імпорту + +Облікові дані не переносяться разом із робочим процесом. Після копіювання процесу або імпорту чи копіювання проєкту тригер показує **Обліковий запис не авторизовано**: виберіть свій обліковий запис і збережіть, і тоді робочий процес знову зможе підписатися. + +## Суміжні документи + +- [Облікові дані та інтеграції](/uk/basic/credential) +- [Рутина](/uk/basic/ai/routine) diff --git a/uk/basic/credential.mdx b/uk/basic/credential.mdx index ad3d322f..dd12f09b 100644 --- a/uk/basic/credential.mdx +++ b/uk/basic/credential.mdx @@ -63,6 +63,12 @@ description: Керуйте своїми підключеннями й секр Якщо вставити в поле автоматизації рядок, схожий на ключ, Teable збереже його як ваш секрет і лишить на місці посилання, тож відкритий текст не потрапить до конфігурації робочого процесу. Щоб лишити текст як є, натисніть **Скасувати** в повідомленні. +## Кредити за виклики сторонніх застосунків + +Виклик стороннього застосунку через підключення витрачає кредити простору — байдуже, надходить виклик з AI Chat, із застосунку чи з автоматизації. Ці списання потрапляють до розділу **Кредити використання** на сторінці оплати під типом **Сторонні застосунки**. + +Більшість застосунків коштує дуже небагато за виклик. Застосунки, які виставляють Teable рахунок за кожен повернений об'єкт або за кожен запит, як-от X, за один виклик обходяться помітно дорожче. Невдалі виклики не тарифікуються, пошук доступних інструментів теж. Коли кредити простору вичерпано, такі виклики відхиляються. + ## Картки авторизації в AI Chat Коли ШІ потрібен зовнішній обліковий запис, він закріплює в розмові картку із заголовком **Для цього завдання потрібна авторизація** і чекає на вашу дію, перш ніж продовжити хід. Карток дві — залежно від того, кому потрібні облікові дані. diff --git a/zh/basic/ai/routine.mdx b/zh/basic/ai/routine.mdx index 0a7221ba..09a9b147 100644 --- a/zh/basic/ai/routine.mdx +++ b/zh/basic/ai/routine.mdx @@ -5,11 +5,11 @@ description: 让 Cuppy 按计划自动运行一段提示词，并在运行历史 云端版本所有方案可用；私有部署版本需要商业版及以上方案。 -例行任务把一段提示词交给 Cuppy 按计划重复执行，适合每天生成日报、定期清理过期记录、按周汇总数据这类不需要人工触发的工作。每次运行都是一段完整的 AI 对话，因此例行任务能使用 AI 对话的全部能力，包括读写表格、调用技能和生成文件。 +例行任务把一段提示词交给 Cuppy 重复执行，可以按时间计划运行，也可以在已连接的第三方应用发生事件时运行，适合每天生成日报、定期清理过期记录、收到新邮件后归档这类不需要人工触发的工作。每次运行都是一段完整的 AI 对话，因此例行任务能使用 AI 对话的全部能力，包括读写表格、调用技能和生成文件。 例行任务是项目中的资源，和表格、应用、自动化一样出现在左侧目录栏中。 -自动化由记录变化、表单提交或 Webhook 这类事件触发，执行的是你预先配置好的步骤；例行任务只按时间触发，执行的是一段交给 AI 自行判断的提示词。需要固定步骤和可预期结果时用自动化，需要 AI 每次根据当前数据自行处理时用例行任务。 +自动化执行的是你预先配置好的步骤，例行任务执行的是一段交给 AI 自行判断的提示词。两者都可以按时间触发，也都可以由已连接的第三方应用的事件触发。需要固定步骤和可预期结果时用自动化，需要 AI 每次根据当前数据自行处理时用例行任务。 ## 创建例行任务 @@ -20,29 +20,37 @@ description: 让 Cuppy 按计划自动运行一段提示词，并在运行历史 在 **提示词** 中描述每次运行要做的事。提示词是每次运行的全部指令，需要写清数据来源、处理方式和结果去向，例如"统计任务表中昨天新增的记录，按负责人汇总后写入日报表"。 - - 在 **运行计划** 中选择执行频率，并按需设置 **生效开始** 和 **生效结束(可选)**。 + + 在 **触发方式** 中选择 **定时** 或 **连接器事件**，再按所选方式填写下方配置。 - 点击 **启用**。启用前需要先保存配置，并且计划中要有未来的运行时间。 + 点击 **启用**。启用前需要先保存配置：**定时** 的计划中要有未来的运行时间，**连接器事件** 要选好一个可用的账号。 ## 配置项 -除提示词和运行计划外，表单还有这些配置： +除提示词外，表单还有这些配置： | 配置项 | 说明 | | --- | --- | | **模型** | 本例行任务使用的模型和智能级别。保持 **默认模型** 时使用空间的默认对话模型 | | **对话** | **每次运行新开对话** 让每次运行互不影响；**延续上一次运行的对话** 会带上历次运行的上下文，适合需要参考上次结果的任务 | -| **生效开始** / **生效结束(可选)** | 计划的起止时间。不设置结束时间时会一直运行下去 | +| **生效开始** / **生效结束(可选)** | 计划的起止时间，仅 **定时** 使用。不设置结束时间时会一直运行下去 | 保存配置时，当前的模型和智能级别会一并记录下来，因此运行历史中能看到每次运行实际使用的模型。 +### 触发方式 + +**定时** 按你设定的时间运行，配置见下面的运行计划。 + +**连接器事件** 在已连接的第三方应用发生事件时运行一次，例如收到新邮件、仓库有新 Issue。选择应用、事件、接收事件的 **账号** 和事件需要的参数即可，配置方式与自动化的连接器事件触发器相同，详见 [连接器收到事件时](/zh/basic/automation/trigger/external/connector-event)。这类例行任务没有 **下次运行** 时间，也不使用运行计划和生效时间。 + +账号授权被撤销、已连接账号被移除，或应用停止了这个订阅时，例行任务会显示 **已断开** 并停止接收事件，Teable 会通知最后更新这个例行任务的成员。重新连接同一个账号后订阅会自动重建；改用别的账号时，需要重新选择账号并保存。 + ### 运行计划 -频率可以从预设中选择：**每小时** 指定分钟、**每天** 和 **工作日** 指定时刻、**每周** 指定星期和时刻、**每月** 指定日期和时刻。 +运行计划只用于 **定时**。频率可以从预设中选择：**每小时** 指定分钟、**每天** 和 **工作日** 指定时刻、**每周** 指定星期和时刻、**每月** 指定日期和时刻。 需要更复杂的规则时选择 **自定义(RRULE)**，填写 RFC 5545 规则，例如 `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`。自定义规则有以下限制： @@ -56,15 +64,17 @@ description: 让 Cuppy 按计划自动运行一段提示词，并在运行历史 ## 草稿、更新与立即运行 -新建的例行任务是草稿，在启用之前不会按计划运行。编辑已启用的例行任务时，改动同样先保存为草稿，线上版本继续按原配置运行，点击 **更新** 才会生效，点击 **重置** 则丢弃这些改动。 +新建的例行任务是草稿，在启用之前不会自动运行。编辑已启用的例行任务时，改动同样先保存为草稿，线上版本继续按原配置运行，点击 **更新** 才会生效，点击 **重置** 则丢弃这些改动。 + +点击 **立即运行** 可以不等触发直接执行一次，用于验证提示词。同一个例行任务在上一次运行结束前不能再次手动运行。 -点击 **立即运行** 可以不等计划直接执行一次，用于验证提示词。同一个例行任务在上一次运行结束前不能再次手动运行。 +连接器事件的例行任务在未启用时点击 **立即运行**，会显示 **等待事件中**：这时到应用里做一次会触发该事件的操作，Teable 收到后用它运行一次，结果进入运行历史。不想继续等待时点击 **停止等待**。已启用的例行任务本来就在接收事件，不需要也不能这样手动运行。 -把开关关闭即可停用，停用后计划不再触发，已有的运行历史仍然保留。 +把开关关闭即可停用，停用后不再触发，已有的运行历史仍然保留。 ## 运行历史 -打开例行任务后切换到 **运行历史**。运行列表可按状态和时间范围筛选，便于定位某一次失败；点击一条运行，可以看到它的计划时间、开始时间、结束时间、耗时，以及这次运行的完整对话。 +打开例行任务后切换到 **运行历史**。运行列表可按状态和时间范围筛选，便于定位某一次失败；点击一条运行，可以看到它的 **运行 ID**、**触发方式**，以及这次运行的完整对话。**触发方式** 为 **定时触发**、**事件触发** 或 **手动触发**，其中 **定时触发** 还会显示这次运行对应的 **计划时间**。 运行状态包括 **排队中**、**运行中**、**已完成**、**运行失败** 和 **已取消**。**已取消** 出现在有人中断了这一轮运行，或例行任务、所属项目已被删除的情况下。 @@ -103,7 +113,7 @@ description: 让 Cuppy 按计划自动运行一段提示词，并在运行历史 - 会。安装模板后，其中的例行任务会像工作流一样自动启用；如果某个计划已经没有未来的运行时间，它会保持草稿状态。 + 定时的例行任务会。安装模板后，它们会像工作流一样自动启用；如果某个计划已经没有未来的运行时间，它会保持草稿状态。连接器事件的例行任务不会自动启用：凭据不随模板安装过来，需要先选好自己的账号再启用。 diff --git a/zh/basic/automation/trigger/external/connector-event.mdx b/zh/basic/automation/trigger/external/connector-event.mdx new file mode 100644 index 00000000..a50fb56c --- /dev/null +++ b/zh/basic/automation/trigger/external/connector-event.mdx @@ -0,0 +1,74 @@ +--- +title: "连接器收到事件时" +description: "当已连接的第三方应用发生事件时运行工作流" +--- + +云端版本所有方案可用；私有部署版本需要商业版及以上方案，并由部署方开启连接器事件。 + +把 GitHub、Gmail、Slack 这类已连接应用中发生的事情作为工作流的起点，例如收到新邮件、仓库有新 Issue、频道有新消息。事件由应用直接送到 Teable，不需要自己搭建 Webhook 地址，也不需要定时去查。 + +## 用 AI 创建 + +打开表格右侧边栏的 AI 对话，描述你的需求。 + +AI 会为你处理一切：选择合适的触发器，映射相关字段，自动设置所有操作。 + +只需描述一次目标，工作流即刻就绪，无需手动配置。 + +**示例：** *"GitHub 仓库有新 Issue 时，在任务表里建一条记录"* + +## 如何设置 + + + + 新建工作流，触发器选择 **当连接器收到事件时**。 + + + 在 **应用** 中选择要监听的应用，再在 **事件** 中选择具体事件。事件列表里每一项都有一句说明和标记，标记的含义见下文。 + + + 在 **账号** 中选择用哪个已连接账号接收事件。还没连接过这个应用时，在同一个下拉里连接一次，连接完成后会自动授权给当前工作流。 + + + 按事件的要求填写 **参数**，例如具体的仓库、频道或标签。带 * 的为必填，填完点击 **保存**。 + + + 添加后续操作，然后开启工作流。订阅在工作流启用时才建立，草稿状态不会收到事件。 + + + +更换应用或事件时，后面的步骤会被清空，引用原事件的变量也不再可用，需要重新配置。 + +## 事件标记 + +| 标记 | 含义 | +| --- | --- | +| **即时** | 应用主动推送，事件发生后很快送达 | +| **轮询 · 可能延迟数分钟** | Teable 定期去应用查询，对时效要求高的流程不要依赖这类事件 | +| **触发频繁** | 这个事件在实际使用中触发次数很多，每次触发都计入自动化运行次数 | +| **已废弃** | 应用已废弃此事件，之后可能不再推送，请改选其他事件 | + +## 触发后可用的数据 + +事件原文放在 **event** 变量里，后续步骤通过 **+** 插入。配置完成时变量里还没有 event，需要先收到一个真实事件：点击 **测试触发器**，面板显示 **等待事件中**，这时到应用里做一次会触发该事件的操作。轮询类事件可能要等几分钟。 + +收到的事件会作为示例数据留在触发器上，后续步骤即可引用它的字段。不想继续等待时点击 **停止等待**；等待约 30 分钟仍未收到，面板会显示 **已停止等待，未收到事件**。 + +## 连接断开时 + +账号授权被撤销、已连接账号被移除、应用停止了这个订阅（凭据过期或订阅不健康），或者订阅创建失败时，触发器会停止接收事件。工作流的开关不会被关闭，但在恢复之前不会再产生新的运行。 + +Teable 会给最后修改这个工作流的成员发送通知，触发器面板顶部也会显示 **已断开，请重新授权该应用或重新选择账号**。按情况恢复： + +- 在 **设置** → **集成** 中对同一个账号点击 **重新连接**，订阅会自动重建。 +- 改用别的账号时，回到触发器重新选择 **账号** 并保存。 +- 订阅创建失败时，检查参数后重新保存即可重试。 + +## 复制或导入之后 + +凭据不随工作流复制。复制工作流、导入或复制项目之后，触发器上会出现 **账号未授权**，需要重新选择一个自己的账号并保存，工作流才能重新订阅。 + +## 相关文档 + +- [凭据与集成](/zh/basic/credential) +- [例行任务](/zh/basic/ai/routine) diff --git a/zh/basic/credential.mdx b/zh/basic/credential.mdx index bcdd3899..567edf06 100644 --- a/zh/basic/credential.mdx +++ b/zh/basic/credential.mdx @@ -63,6 +63,12 @@ description: 管理你的连接和 Secret，并把它们授权给应用和自动 在自动化输入框里粘贴一段疑似密钥的内容时，Teable 会自动把它存成你的 Secret，原处留下引用，明文不会留在工作流配置里。不需要这样处理时，点击提示里的 **撤销**。 +## 第三方应用调用的算力 + +通过连接调用第三方应用会消耗空间算力，AI 对话、应用和自动化中的调用都计入，在计费页的 **算力用量统计** 中按类型 **第三方应用** 列出。 + +多数应用每次调用消耗很少；X 这类按返回条数或请求次数向 Teable 计费的应用，单次消耗会明显更高。调用失败不计费，查找可用工具也不计费。空间算力用尽后，这类调用会被拒绝。 + ## AI 对话中的授权卡片 AI 需要用到某个外部账号时，会在对话中固定一张标题为 **此任务需要授权** 的卡片，等你处理后再继续这一轮。按谁要用这份凭据分两种。