diff --git a/ar/basic/ai/ai-chat.mdx b/ar/basic/ai/ai-chat.mdx index fe712028..fb850696 100644 --- a/ar/basic/ai/ai-chat.mdx +++ b/ar/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ description: تفاعل مع بياناتك باللغة الطبيعية لتح - **النموذج**: استخدم قائمة النماذج لاختيار مستوى النموذج للمحادثة. تعرض القائمة **Ultra** و**Smart** و**Standard** و**Lite** من الأعلى قدرة إلى الأدنى، مع بيان النموذج القائم خلف كل مستوى. ويمكن للمسؤول تبديل ذلك النموذج في أي وقت أو إتاحة بعض المستويات فقط، من دون أن تحتاج إلى إعادة الاختيار. استخدم مستوى أدنى للاستعلامات البسيطة أو التنظيف أو إعادة الصياغة، ومستوى أعلى للتخطيط المعقد والتحليل عبر الجداول وإنشاء التطبيقات. - **مستوى الذكاء**: اختر مستوى **الذكاء** بصورة مستقلة في قائمة النماذج. يتحكم هذا المستوى في عمق التفكير؛ وتنتج المستويات الأعلى استدلالًا أشمل. - **أسراري**: افتح **+** ← **المزيد** ← **أسراري** لحفظ مفاتيح API أو غيرها من بيانات الاعتماد في **الإعدادات** ← **التكاملات**. هذه القيم ملك لك، ويمكن لمحادثة الذكاء الاصطناعي قراءتها أثناء التشغيل بوصفها متغيرات بيئة، كما يمكنك منحها لتطبيقات وأتمتة بعينها. راجع [بيانات الاعتماد وعمليات التكامل](/ar/basic/credential). -- **طلبات بيانات الاعتماد**: عندما يحتاج الذكاء الاصطناعي إلى حساب خارجي أو إلى سرّ، يثبّت بطاقة طلب في المحادثة. اختر **ربط حسابي** لتنفيذ تصريح OAuth، أو امنح بيانات اعتماد تملكها بالفعل. وإذا نقرت على **تخطي** فلن تُقدَّم بيانات الاعتماد، ويواصل الذكاء الاصطناعي الأجزاء التي يمكنه إكمالها من دونها. +- **بطاقات التفويض**: عندما يحتاج الذكاء الاصطناعي إلى حساب خارجي أو إلى سرّ، يثبّت بطاقة في المحادثة وينتظر تصرّفك قبل أن تُكمل الجولة. فإذا كان Cuppy نفسه يحتاج الحساب لإنجاز المهمة، اضغط **اتصال** لتنفيذ تصريح OAuth؛ وإذا كان تطبيق أو أتمتة يحتاج بيانات الاعتماد أثناء التشغيل، اختر **ربط حسابي** أو امنح بيانات اعتماد تملكها بالفعل. وإذا نقرت على **تخطي** فلن تُقدَّم بيانات الاعتماد، ويواصل الذكاء الاصطناعي الأجزاء التي يمكنه إكمالها من دونها. راجع [بيانات الاعتماد وعمليات التكامل](/ar/basic/credential). - **استخراج بيانات الويب**: افتح قائمة **+** واختر **استخراج بيانات الويب**، ثم حدد منصة ونوع بيانات. تنقسم العناصر إلى نوعين: نوع يستخرج من رابط تلصقه، مثل **الملف الشخصي** على LinkedIn أو **تقييمات المنتج** على Amazon، ونوع يبحث بكلمة مفتاحية أو وسم أو اسم، مثل **البحث عن فيديوهات** على TikTok أو **منشورات مجتمع فرعي** على Reddit. يملأ Teable التعليمات المناسبة في حقل الإدخال ويترك في نهايتها الجزء الذي عليك إكماله. أما **أي صفحة ويب** فتقبل الرابط الملصوق مباشرة. - **المهارات**: افتح قائمة **+** واختر **المهارات** لاستيراد المهارات أو تمكينها أو تعطيلها أو تجربتها في المحادثة الحالية. عند استيراد مهارة، اختر من يمكنه استخدامها: يحصرها **شخصي** بك، ويتيحها **المشروع** للمتعاونين في هذا المشروع، وتتيحها **المساحة** للجميع في هذه المساحة. اكتب `/` في مربع الإدخال لاختيار مهارة مفعّلة. لربط نظام خارجي أو ترحيله، راجع [ربط كل شيء وترحيله](/ar/basic/ai/connect-everything). - **استخدام السياق**: توضح الحلقة المجاورة لمربع الإدخال مقدار ما تستخدمه المحادثة حاليًا من نافذة سياق النموذج. انقر عليها لعرض النسبة المئوية وأعداد الرموز. عندما يمتلئ السياق، يضغط Teable المحادثة؛ ابدأ محادثة جديدة إذا أردت سياقًا جديدًا بدلاً من ذلك. - **إدارة الملفات**: افتح **+** ← **المزيد** ← **إدارة الملفات** لعرض الملفات في بيئة المحادثة المعزولة الحالية. يمكنك معاينة الملفات المدعومة أو تنزيلها أو حذف الملفات والمجلدات التي لم تعد بحاجة إليها. يجب أن تكون هناك محادثة قبل أن تتمكن من إدارة ملفاتها. -- **قائمة انتظار الرسائل**: لا يؤدي إرسال رسالة أخرى أثناء عمل الذكاء الاصطناعي إلى مقاطعته. تنتظر الرسالة في قائمة أعلى مربع الإدخال وتُرسل عند انتهاء التشغيل الحالي. تحتفظ العناصر الموجودة في قائمة الانتظار بشارات الجدول وطريقة العرض والمرفقات والتحديد نفسها الموجودة في إدخال المحادثة؛ يؤدي **إزالة** إلى حذف عنصر، ويعيده **...** ← **تحرير الرسالة** إلى مربع الإدخال، كما يتيح العنصر النصي فقط خيار **توجيه** لتمرير نصه إلى الدور الجاري بدلاً من الانتظار. +- **قائمة انتظار الرسائل**: لا يؤدي إرسال رسالة أخرى أثناء عمل الذكاء الاصطناعي إلى مقاطعته. تنتظر الرسالة في قائمة أعلى مربع الإدخال وتُرسل عند انتهاء التشغيل الحالي. تحتفظ العناصر الموجودة في قائمة الانتظار بشارات الجدول وطريقة العرض والمرفقات والتحديد نفسها الموجودة في إدخال المحادثة؛ يؤدي **إزالة** إلى حذف عنصر، ويعيده **...** ← **تحرير الرسالة** إلى مربع الإدخال، كما يتيح العنصر النصي فقط خيار **توجيه** لتمرير نصه إلى الدور الجاري بدلاً من الانتظار. وإذا توقّفت الجولة عند بطاقة تنتظر تصرّفك (بطاقة تفويض أو سؤال من الذكاء الاصطناعي)، فلن تدخل الرسالة النصية الخالصة قائمة الانتظار: تُغلق البطاقة وتُسجَّل **تم التخطي**، وتذهب رسالتك مباشرةً إلى تلك الجولة بوصفها التعليمات التالية، فلا حاجة إلى معالجة البطاقة أولًا. أما الرسالة التي تحمل مرفقات فتبقى في قائمة الانتظار. ## إدارة المحادثات diff --git a/ar/basic/ai/app-builder.mdx b/ar/basic/ai/app-builder.mdx index 5af8d7a3..729ab616 100644 --- a/ar/basic/ai/app-builder.mdx +++ b/ar/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ description: حوّل بياناتك إلى تطبيقات ويب مخصصة ب مركز التحكم في تطبيقك. - **التحرير باللغة الطبيعية**: صِف تغييرات مثل *«اجعل الترويسة زرقاء»* أو *«أضف نموذج إرسال للسجلات الجديدة»*. - **التوجيه التلقائي**: يفهم الذكاء الاصطناعي المكوّن أو الصفحة التي تشير إليها ويعدّلها مباشرةً. -- **عمليات التكامل**: عندما تحتاج مهمة التطبيق إلى الوصول إلى حساب تابع لجهة خارجية، يمكن لمنشئ التطبيقات عرض بطاقة مثل **ربط Slack** في لوحة المحادثة. انقر على **ربط** للتصريح عبر OAuth. انقر على **تخطي** لإلغاء هذا التصريح؛ وسيواصل الذكاء الاصطناعي تنفيذ الأجزاء التي يمكنه إكمالها من دون ذلك الاتصال. +- **طلبات بيانات الاعتماد**: عندما يحتاج التطبيق أثناء التشغيل إلى الوصول إلى حساب تابع لجهة خارجية أو إلى سرّ، يثبّت منشئ التطبيقات بطاقة في لوحة المحادثة، مثل **يحتاج هذا المورد (تطبيق) إلى اتصال Slack الخاص بك**. انقر على **ربط حسابي** لتنفيذ تصريح OAuth؛ ويُمنح الاتصال الجديد لهذا التطبيق مباشرة. وإذا كان لديك اتصال أو سرّ صالح بالفعل، فيكفي منحه دون الحاجة إلى ربط جديد. وإذا نقرت على **تخطي** فلن تُقدَّم بيانات الاعتماد، ويواصل الذكاء الاصطناعي الأجزاء التي يمكنه إكمالها من دونها. - **المهارات**: افتح قائمة **+** واختر **المهارات** لإدارة مهارات محادثة التطبيق هذه. لا تتاح المهارة المضافة هنا إلا للتطبيق الحالي، ويمكن أيضًا استخدام المهارات المشتركة مع مشروع التطبيق ومساحته. اكتب `/` في مربع الإدخال لاختيار مهارة مفعّلة. - **إدارة الملفات**: افتح **+** ← **المزيد** ← **إدارة الملفات** لعرض الملفات في بيئة التطبيق المعزولة. استخدمها لمعاينة الملفات المدعومة أو تنزيل الملفات المنشأة أو حذف الملفات والمجلدات التي لم تعد بحاجة إليها. - **مسح المحادثة**: إذا انحرفت المحادثة الحالية عن مسارها، فانقر على **مسح المحادثة** في الزاوية السفلية اليمنى من اللوحة لبدء جلسة جديدة. يؤدي ذلك إلى مسح سجل المحادثة الحالية، لكنه لا يحذف التطبيق نفسه. يظهر تأكيد عند الاستخدام الأول، ويمكنك اختيار عدم إظهاره مرة أخرى لاحقًا. @@ -273,6 +273,15 @@ description: حوّل بياناتك إلى تطبيقات ويب مخصصة ب className="docs-screenshot" /> +يحفظ منشئ التطبيقات تغييرات كل جولة بوصفها إصدارًا جديدًا. وعند فشل الحفظ، تظهر بطاقة في المحادثة. + + +تبقى تغييرات الجولة الفاشلة في البيئة المعزولة وحدها، وتضيع عند استرجاعها، وإعادة توليد الرد لا تحفظها من جديد. فبادر بالتصرّف حين تظهر البطاقة. + + +- **تعذّر حفظ الإصدار**: لم يُحفظ هذا الإصدار. دع منشئ التطبيقات يواصل العمل؛ فأول حفظ ناجح سيحمل معه هذه التغييرات. +- **التغييرات أكبر من أن تُحفظ**: تجاوزت هذه الجولة حدّ الحجم المسموح للحفظ. انقر على **إرسال إلى الذكاء الاصطناعي** في البطاقة، فيبحث منشئ التطبيقات عن مخرجات اختبار أو ملفات تنقيح أو مرفقات ضخمة وينظّفها ثم يحفظ مرة أخرى. وقد تكون هذه الملفات قد دخلت سجلّ الإيداعات غير المحفوظة، فلا يكفي حذفها وحده؛ اترك لمنشئ التطبيقات ترتيب السجلّ أيضًا. + ### الإصلاح التلقائي إذا تسببت تغييرات الشيفرة المخصصة في خطأ بناء، فستفشل عملية النشر. - يوفر Teable زر **الإصلاح التلقائي** بجوار سجل الأخطاء. diff --git a/ar/basic/ai/routine.mdx b/ar/basic/ai/routine.mdx index 02135b08..eadfaeea 100644 --- a/ar/basic/ai/routine.mdx +++ b/ar/basic/ai/routine.mdx @@ -35,7 +35,6 @@ description: دع Cuppy ينفّذ مطالبة وفق جدول زمني، ور | الإعداد | الوصف | | --- | --- | | **النموذج** | النموذج ومستوى الذكاء اللذان يعمل بهما هذا الروتين. اترك **النموذج الافتراضي** لاستخدام نموذج المحادثة الافتراضي للمساحة | -| **الحد الأقصى لمدة التشغيل (بالدقائق)** | يُوقف التشغيل الذي يتجاوز هذا الحد ويُسجَّل فاشلًا. من 5 إلى 120 دقيقة، والافتراضي 30 | | **المحادثة** | **محادثة جديدة لكل تشغيل** تُبقي عمليات التشغيل مستقلّة بعضها عن بعض؛ و**متابعة محادثة التشغيل السابق** تنقل سياق عمليات التشغيل السابقة، وهو ما يناسب العمل الذي يحتاج إلى الرجوع إلى النتيجة السابقة | | **البداية** / **النهاية (اختياري)** | حدود الجدول. من دون وقت انتهاء يستمر الروتين بلا أجل | @@ -74,7 +73,6 @@ description: دع Cuppy ينفّذ مطالبة وفق جدول زمني، ور | الرسالة | المعنى | ما العمل | | --- | --- | --- | | **فشل التشغيل** | بدأ التشغيل لكنه اصطدم بخطأ | افتح محادثة ذلك التشغيل، واستدلّ من موضع الخطأ على ما إذا كان السبب في المطالبة أم في البيانات | -| **انتهت مهلة التشغيل** | تجاوز التشغيل **الحد الأقصى لمدة التشغيل** فأُوقف | ارفع **الحد الأقصى لمدة التشغيل**، أو قسّم المطالبة إلى وحدات عمل أصغر | | **تم التخطي: الأرصدة غير كافية** | نفدت الأرصدة فلم يبدأ التشغيل | اشحن أرصدة المساحة | | **تم التخطي: كان التشغيل السابق لا يزال جاريًا** | لم ينتهِ التشغيل السابق، فتُخطّي هذا الموعد | اخفض التكرار، أو قلّل حجم ما يعالجه التشغيل الواحد | | **تم التخطي: انتهت مهلة الانتظار في قائمة الانتظار** | انتظر التشغيل طويلًا في الطابور فتُخطّي | الحالة المتفرّقة لا تستدعي شيئًا؛ أما تكرارها فيعني ازدحام الجدولة في وقت واحد، ففرّق بين المواعيد | diff --git a/ar/basic/credential.mdx b/ar/basic/credential.mdx index e0080fe9..80b921fa 100644 --- a/ar/basic/credential.mdx +++ b/ar/basic/credential.mdx @@ -63,14 +63,20 @@ description: أدر اتصالاتك وأسرارك وامنحها للتطبي عند لصق قيمة تشبه المفتاح في أحد حقول الأتمتة، يحفظها Teable بوصفها سرًّا لك ويترك مكانها مرجعًا، فلا يصل النص الصريح إلى إعدادات سير العمل. وإذا أردت إبقاء النص كما هو، فانقر على **تراجع** في التنبيه. -## طلبات بيانات الاعتماد في محادثة الذكاء الاصطناعي +## بطاقات التفويض في محادثة الذكاء الاصطناعي -عندما يحتاج الذكاء الاصطناعي إلى حساب خارجي، يثبّت في المحادثة بطاقة طلب توضّح الخدمة التي يريد اتصالًا بها أو الاسم المستعار الذي يريد له سرًّا. أمامك الخيارات التالية: +عندما يحتاج الذكاء الاصطناعي إلى حساب خارجي، يثبّت في المحادثة بطاقة عنوانها **هذه المهمة تتطلب تفويضًا** وينتظر تصرّفك قبل أن تُكمل الجولة. والبطاقات نوعان، بحسب من يحتاج بيانات الاعتماد. + +**بطاقة الاتصال**: تظهر حين يحتاج Cuppy نفسه إلى القراءة من خدمة أو الكتابة فيها لإنجاز المهمة، مثل جلب البريد من Gmail أو الكتابة في Notion. تذكر البطاقة اسم الخدمة؛ اضغط **اتصال** لتنفيذ تصريح OAuth أو إدخال مفتاح تلك الخدمة. وبمجرد اكتمال الاتصال تُستأنف الجولة، ويُحفظ الاتصال في **اتصالاتي** ضمن **الإعدادات** ← **التكاملات**. ويمكن ربط الخدمات التي يتكامل معها Teable بنفسه والخدمات المُدارة بواسطة Composio من هذه البطاقة، دون الحاجة إلى فتح صفحة الإعدادات أولًا. ويعني **تخطي** عدم تقديم الاتصال، فيواصل الذكاء الاصطناعي الأجزاء التي لا تعتمد عليه. وإذا فشل الاتصال، تعرض البطاقة الخطأ: اضغط **إعادة المحاولة** لمحاولة أخرى، أو **تراجع** لإنهاء الطلب. + +**بطاقة طلب بيانات الاعتماد**: تظهر حين يحتاج تطبيق أو أتمتة تبنيها إلى بيانات الاعتماد أثناء التشغيل، وتوضّح الخدمة التي يريد اتصالًا بها أو الاسم المستعار الذي يريد له سرًّا. أمامك الخيارات التالية: - **ربط حسابي**: تنفيذ تصريح OAuth؛ ويُمنح الاتصال الجديد للمورد تلقائيًا. - **منح ...**: استخدام اتصال أو سرّ تملكه بالفعل. - **تخطي**: عدم تقديم بيانات الاعتماد؛ ويواصل الذكاء الاصطناعي الأجزاء التي لا تعتمد عليها. +وإرسال رسالة أثناء انتظار البطاقة يغلقها أيضًا ويسجّلها **تم التخطي**، وتصبح رسالتك التعليمات التالية في هذه الجولة. وإذا عادت الحاجة إلى بيانات الاعتماد لاحقًا، اطلب من Cuppy إرسال الطلب من جديد. + ## الاستبدال والحذف ومغادرة المساحة قبل استبدال قيمة سرّ أو حذف سرّ أو قطع اتصال، يعرض Teable قائمة التطبيقات والأتمتة التي لا تزال تستخدمه. ويؤدي الحذف وقطع الاتصال إلى تعطّل تلك الموارد فورًا، لذا امنحها بيانات اعتماد أخرى أولًا إذا كان عليها الاستمرار في العمل. ولا يمكن استرجاع قيمة السرّ القديمة. diff --git a/de/basic/ai/ai-chat.mdx b/de/basic/ai/ai-chat.mdx index 740053de..1e64a07f 100644 --- a/de/basic/ai/ai-chat.mdx +++ b/de/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ Wenn Sie einen langen Block mit Klartext einfügen, wandelt Teable ihn in einen - **Modell**: Verwenden Sie das Modellmenü, um die Modellstufe für die Unterhaltung auszuwählen. Das Menü führt **Ultra**, **Smart**, **Standard** und **Lite** von der leistungsstärksten Stufe abwärts auf und zeigt zu jeder das dahinterliegende Modell. Ihre Administration kann dieses Modell jederzeit austauschen oder nur einen Teil der Stufen anbieten, ohne dass Sie erneut wählen müssen. Nutzen Sie eine niedrigere Stufe für einfache Abfragen, Bereinigung oder Überarbeitungen und eine höhere Stufe für komplexe Planung, tabellenübergreifende Analysen und App-Erstellung. - **Intelligenz**: Wählen Sie die Stufe **Intelligenz** separat im Modellmenü. Sie steuert die Denktiefe; höhere Stufen liefern gründlichere Überlegungen. - **Meine Secrets**: Öffnen Sie **+** → **Mehr** → **Meine Secrets**, um API-Schlüssel oder andere Anmeldedaten unter **Einstellungen** → **Integrationen** zu hinterlegen. Die Werte gehören Ihnen, der KI-Chat kann sie zur Laufzeit als Umgebungsvariablen lesen, und Sie können sie einzelnen Apps und Automatisierungen freigeben. Siehe [Zugangsdaten und Integrationen](/de/basic/credential). -- **Anfragen nach Zugangsdaten**: Wenn die KI ein Drittanbieterkonto oder ein Secret benötigt, heftet sie eine entsprechende Karte an die Unterhaltung. Wählen Sie **Mein Konto verbinden** für einen OAuth-Vorgang oder geben Sie vorhandene Zugangsdaten frei. Mit **Überspringen** stellen Sie sie nicht bereit; die KI fährt mit den Teilen fort, die sie auch ohne erledigen kann. +- **Autorisierungskarten**: Wenn die KI ein Drittanbieterkonto oder ein Secret benötigt, heftet sie eine Karte an die Unterhaltung und wartet, bevor der Durchlauf weitergeht. Braucht Cuppy das Konto für die Aufgabe selbst, starten Sie mit **Verbinden** den OAuth-Vorgang; braucht eine App oder Automatisierung die Zugangsdaten zur Laufzeit, wählen Sie **Mein Konto verbinden** oder geben vorhandene Zugangsdaten frei. Mit **Überspringen** stellen Sie sie nicht bereit; die KI fährt mit den Teilen fort, die sie auch ohne erledigen kann. Siehe [Zugangsdaten und Integrationen](/de/basic/credential). - **Scraper**: Öffnen Sie das Menü **+** und wählen Sie **Scraper**, dann eine Plattform und einen Datentyp. Es gibt zwei Arten von Einträgen: Die einen scrapen einen eingefügten Link, etwa **Persönliches Profil** bei LinkedIn oder **Produktbewertungen** bei Amazon; die anderen suchen nach Stichwort, Hashtag oder Name, etwa **Videosuche** bei TikTok oder **Beiträge eines Subreddits** bei Reddit. Teable füllt die passende Anweisung in der Chat-Eingabe vor und lässt den zu ergänzenden Teil am Ende offen. **Beliebige Webseite** nimmt einen eingefügten Link direkt entgegen. - **Skills**: Öffnen Sie das Menü **+** und wählen Sie **Skills**, um Skills im aktuellen Chat zu importieren, zu aktivieren, zu deaktivieren oder auszuprobieren. Wählen Sie beim Import aus, wer ihn verwenden kann: **Persönlich** beschränkt ihn auf Sie selbst, **Projekt** gibt ihn Mitarbeitenden in diesem Projekt und **Space** allen Personen in diesem Space. Geben Sie `/` im Eingabefeld ein, um einen aktivierten Skill auszuwählen. Informationen zum Verbinden oder Migrieren eines externen Systems finden Sie unter [Alles verbinden und migrieren](/de/basic/ai/connect-everything). - **Kontextnutzung**: Der Ring neben dem Eingabefeld zeigt, wie viel des Kontextfensters des Modells die Unterhaltung derzeit nutzt. Klicken Sie darauf, um den Prozentsatz und die Token-Anzahlen anzuzeigen. Wenn der Kontext voll ist, verdichtet Teable die Unterhaltung; starten Sie stattdessen einen neuen Chat, wenn Sie einen sauberen Kontext wünschen. - **Dateien verwalten**: Öffnen Sie **+** → **Mehr** → **Dateien verwalten**, um Dateien in der Sandbox des aktuellen Chats anzuzeigen. Sie können unterstützte Dateien in der Vorschau anzeigen, Dateien herunterladen oder nicht mehr benötigte Dateien und Ordner löschen. Eine Unterhaltung muss bestehen, bevor ihre Dateien verwaltet werden können. -- **Nachrichtenwarteschlange**: Das Senden einer weiteren Nachricht, während die KI arbeitet, unterbricht sie nicht. Die Nachricht wartet in einer Warteschlange über dem Eingabefeld und wird gesendet, wenn der aktuelle Durchlauf endet. Elemente in der Warteschlange behalten dieselben Chips für Tabelle, Ansicht, Anhang und Auswahl wie die Chat-Eingabe; **Entfernen** verwirft eines, **...** → **Nachricht bearbeiten** legt es zurück in das Eingabefeld, und ein reines Textelement bietet zusätzlich **Steuern**, um seinen Text an den laufenden Durchlauf zu übergeben, statt zu warten. +- **Nachrichtenwarteschlange**: Das Senden einer weiteren Nachricht, während die KI arbeitet, unterbricht sie nicht. Die Nachricht wartet in einer Warteschlange über dem Eingabefeld und wird gesendet, wenn der aktuelle Durchlauf endet. Elemente in der Warteschlange behalten dieselben Chips für Tabelle, Ansicht, Anhang und Auswahl wie die Chat-Eingabe; **Entfernen** verwirft eines, **...** → **Nachricht bearbeiten** legt es zurück in das Eingabefeld, und ein reines Textelement bietet zusätzlich **Steuern**, um seinen Text an den laufenden Durchlauf zu übergeben, statt zu warten. Wartet der Durchlauf gerade auf eine Karte (eine Autorisierungskarte, eine Rückfrage der KI), wird eine reine Textnachricht nicht eingereiht: Die Karte wird geschlossen und als **Übersprungen** vermerkt, und Ihre Nachricht geht direkt als nächste Anweisung in diesen Durchlauf, sodass Sie die Karte nicht zuerst erledigen müssen. Eine Nachricht mit Anhängen landet weiterhin in der Warteschlange. ## Chats verwalten diff --git a/de/basic/ai/app-builder.mdx b/de/basic/ai/app-builder.mdx index 306dbfb2..c2a4113b 100644 --- a/de/basic/ai/app-builder.mdx +++ b/de/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ Der App-Builder bietet eine duale Oberfläche für nicht technische Nutzer und E Die Kommandozentrale für Ihre App. - **Bearbeitung in natürlicher Sprache**: Beschreiben Sie Änderungen wie *„Mache die Kopfzeile blau“* oder *„Füge ein Übermittlungsformular für neue Datensätze hinzu“*. - **Automatisches Routing**: Die KI versteht, auf welche Komponente oder Seite Sie sich beziehen, und ändert sie direkt. -- **Integrationen**: Wenn die App-Aufgabe Zugriff auf ein Drittanbieter-Konto benötigt, kann der App-Builder im Chat-Bereich eine Karte wie **Slack verbinden** anzeigen. Klicken Sie auf **Verbinden**, um sich per OAuth zu autorisieren. Klicken Sie auf **Überspringen**, um diese Autorisierung abzubrechen; die KI fährt mit den Teilen fort, die sie ohne diese Verbindung abschließen kann. +- **Anfragen nach Zugangsdaten**: Braucht die App zur Laufzeit Zugriff auf ein Drittanbieter-Konto oder ein Secret, heftet der App-Builder eine Karte an den Chat-Bereich, etwa **Diese App benötigt Ihre Slack-Verbindung**. Mit **Mein Konto verbinden** starten Sie den OAuth-Vorgang; die neue Verbindung wird dieser App sofort freigegeben. Haben Sie bereits eine passende Verbindung oder ein passendes Secret, geben Sie es einfach frei – ein erneutes Verbinden entfällt. Mit **Überspringen** stellen Sie die Zugangsdaten nicht bereit; die KI fährt mit den Teilen fort, die sie auch ohne erledigen kann. - **Skills**: Öffnen Sie das Menü **+** und wählen Sie **Skills**, um Skills für diese App-Unterhaltung zu verwalten. Ein hier hinzugefügter Skill ist nur für die aktuelle App verfügbar; die mit dem Projekt und dem Space der App geteilten Skills können hier ebenfalls verwendet werden. Geben Sie `/` in das Eingabefeld ein, um einen aktivierten Skill auszuwählen. - **Dateien verwalten**: Öffnen Sie **+** → **Mehr** → **Dateien verwalten**, um Dateien in der App-Sandbox anzuzeigen. Verwenden Sie dies, um unterstützte Dateien in der Vorschau anzuzeigen, generierte Dateien herunterzuladen oder nicht mehr benötigte Dateien und Ordner zu löschen. - **Unterhaltung löschen**: Wenn die aktuelle Unterhaltung vom Thema abgekommen ist, klicken Sie unten rechts im Bereich auf **Chat löschen**, um eine neue Sitzung zu beginnen. Dadurch wird der Chatverlauf der aktuellen Unterhaltung gelöscht, nicht jedoch die App selbst. Bei der ersten Verwendung wird eine Bestätigung angezeigt, und Sie können festlegen, dass sie beim nächsten Mal nicht wieder angezeigt wird. @@ -273,6 +273,15 @@ Teable verfolgt jede Bereitstellung automatisch. className="docs-screenshot" /> +Der App-Builder speichert die Änderungen jedes Durchlaufs als neue Version. Schlägt das Speichern fehl, erscheint im Chat eine Karte. + + +Die Änderungen des fehlgeschlagenen Durchlaufs liegen nur noch in der Sandbox; sie gehen verloren, sobald die Sandbox eingezogen wird, und ein erneut erzeugte Antwort speichert sie nicht nach. Reagieren Sie zügig auf die Karte. + + +- **Version konnte nicht gespeichert werden**: Diese Version wurde nicht gespeichert. Lassen Sie den App-Builder weiterarbeiten; der nächste erfolgreiche Speichervorgang nimmt diese Änderungen mit. +- **Änderungen zu groß zum Speichern**: Dieser Durchlauf überschreitet das Größenlimit fürs Speichern. Klicken Sie auf der Karte auf **An KI senden**: Der App-Builder sucht nach übergroßen Testartefakten, Debug-Dateien oder Anhängen, räumt sie weg und speichert erneut. Solche Dateien stecken womöglich schon in der noch nicht gespeicherten Commit-Historie, Löschen allein genügt dann nicht – lassen Sie den App-Builder auch das bereinigen. + ### Automatische Fehlerbehebung Wenn Ihre Änderungen am eigenen Code einen Build-Fehler verursachen, schlägt die Bereitstellung fehl. - Teable stellt neben dem Fehlerprotokoll eine Schaltfläche **Automatisch beheben** bereit. diff --git a/de/basic/ai/routine.mdx b/de/basic/ai/routine.mdx index 88c8023d..a923934a 100644 --- a/de/basic/ai/routine.mdx +++ b/de/basic/ai/routine.mdx @@ -35,7 +35,6 @@ Neben Prompt und Zeitplan enthält das Formular diese Einstellungen: | Einstellung | Beschreibung | | --- | --- | | **Modell** | Modell und Denkstufe dieser Routine. Bei **Standardmodell** gilt das Standard-Chatmodell des Space | -| **Maximale Laufzeit (Minuten)** | Ein Lauf über diesem Limit wird abgebrochen und als fehlgeschlagen gewertet. 5–120 Minuten, Standard 30 | | **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 | @@ -74,7 +73,6 @@ Ein Lauf mit **Fehlgeschlagen** nennt seinen Grund, und jeder Grund verlangt ein | Meldung | Bedeutung | Was zu tun ist | | --- | --- | --- | | **Ausführung fehlgeschlagen** | Der Lauf hat begonnen, ist aber auf einen Fehler gestoßen | Öffnen Sie den Chat dieses Laufs und beurteilen Sie an der Fehlerstelle, ob der Prompt oder die Daten die Ursache sind | -| **Zeitüberschreitung bei der Ausführung** | Der Lauf hat die **Maximale Laufzeit** überschritten und wurde abgebrochen | Erhöhen Sie die **Maximale Laufzeit** oder teilen Sie den Prompt in kleinere Arbeitsschritte | | **Übersprungen: nicht genügend Guthaben** | Das Guthaben war aufgebraucht, der Lauf hat nicht begonnen | Guthaben des Space aufstocken | | **Übersprungen: die vorherige Ausführung lief noch** | Der vorherige Lauf war nicht fertig, dieser Termin wurde übersprungen | Frequenz senken oder das Arbeitspensum eines Laufs verkleinern | | **Übersprungen: Zeitüberschreitung beim Warten in der Warteschlange** | Der Lauf hat zu lange in der Warteschlange gewartet und wurde übersprungen | Einzelfälle brauchen keine Reaktion; tritt es wiederholt auf, ist zu viel gleichzeitig geplant, verteilen Sie die Zeitpläne | diff --git a/de/basic/credential.mdx b/de/basic/credential.mdx index ceee6d6e..0be03d7d 100644 --- a/de/basic/credential.mdx +++ b/de/basic/credential.mdx @@ -63,14 +63,20 @@ 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**. -## Anfragen nach Zugangsdaten im KI-Chat +## Autorisierungskarten im KI-Chat -Braucht die KI ein externes Konto, heftet sie eine Karte an die Unterhaltung, die nennt, für welchen Dienst sie eine Verbindung oder unter welchem Alias sie ein Secret benötigt. Sie haben die Wahl: +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. + +**Verbindungskarte**: erscheint, wenn Cuppy selbst einen Dienst lesen oder beschreiben muss, um die Aufgabe zu erledigen – etwa Mails aus Gmail holen oder nach Notion schreiben. Die Karte nennt den Dienst; mit **Verbinden** starten Sie den OAuth-Vorgang oder geben den Schlüssel dieses Dienstes ein. Sobald die Verbindung steht, läuft der Durchlauf weiter, und die Verbindung liegt unter **Meine Verbindungen** in **Einstellungen** → **Integrationen**. Dienste, die Teable selbst anbindet, und von Composio verwaltete Dienste werden beide über diese Karte verbunden; der Umweg über die Einstellungen entfällt. **Überspringen** stellt die Verbindung nicht bereit, und Cuppy fährt mit den Teilen fort, die nicht davon abhängen. Schlägt die Verbindung fehl, zeigt die Karte den Fehler: **Erneut versuchen** startet einen neuen Versuch, **Aufgeben** beendet die Anfrage. + +**Karte für Zugangsdaten**: erscheint, wenn eine App oder Automatisierung, die Sie gerade bauen, die Zugangsdaten zur Laufzeit braucht; sie nennt, für welchen Dienst sie eine Verbindung oder unter welchem Alias sie ein Secret benötigt. Sie haben die Wahl: - **Mein Konto verbinden**: OAuth-Vorgang starten; die neue Verbindung wird der Ressource automatisch freigegeben. - **Mein … freigeben**: eine vorhandene Verbindung oder ein vorhandenes Secret verwenden. - **Überspringen**: die Zugangsdaten nicht bereitstellen. Die KI fährt mit den Teilen fort, die nicht davon abhängen. +Schicken Sie stattdessen eine Nachricht ab, während die Karte wartet, wird die Karte ebenfalls geschlossen und als **Übersprungen** vermerkt; Ihre Nachricht ist dann die nächste Anweisung für diesen Durchlauf. Werden die Zugangsdaten später doch gebraucht, lassen Sie Cuppy erneut danach fragen. + ## Ersetzen, Löschen und das Verlassen eines Space Bevor Sie einen Secret-Wert ersetzen, ein Secret löschen oder eine Verbindung trennen, listet Teable die Apps und Automatisierungen auf, die es noch verwenden. Löschen und Trennen setzen diese Ressourcen sofort außer Betrieb; sollen sie weiterlaufen, geben Sie ihnen vorher andere Zugangsdaten. Der alte Secret-Wert lässt sich nicht wiederherstellen. diff --git a/en/basic/ai/ai-chat.mdx b/en/basic/ai/ai-chat.mdx index 2c0e2970..63685f04 100644 --- a/en/basic/ai/ai-chat.mdx +++ b/en/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ When you paste a long block of plain text, Teable converts it to a Markdown atta - **Model**: Use the model menu to choose the model tier for the conversation. The menu lists **Ultra**, **Smart**, **Standard**, and **Lite** from the most capable down, each showing the model behind it; your admin can swap that model at any time, or offer only some of the tiers, and you never have to pick again. Use a lower tier for simple queries, cleanup, or rewriting, and a higher tier for complex planning, cross-table analysis, and app building. - **Intelligence**: Choose the **Intelligence** level separately in the model menu. It controls thinking depth; higher levels produce more thorough reasoning. - **My secrets**: Open **+** → **More** → **My secrets** to store API keys or other credentials in **Settings** → **Integrations**. The values are yours, AI Chat can read them as environment variables at runtime, and you can grant them to individual apps and automations. See [Credentials and Integrations](/en/basic/credential). -- **Credential requests**: When AI needs a third-party account or a secret, it pins a credential request card to the conversation. Choose **Connect my account** to run an OAuth flow, or grant a credential you already have. Click **Skip** to withhold it; AI continues with the parts it can complete without it. +- **Authorization cards**: When AI needs a third-party account or a secret, it pins a card to the conversation and waits for you before the turn goes on. When Cuppy needs the account to do the task itself, click **Connect** to run an OAuth flow; when an app or automation needs the credential at run time, choose **Connect my account** or grant a credential you already have. Click **Skip** to withhold it; AI continues with the parts it can complete without it. See [Credentials and Integrations](/en/basic/credential). - **Scraper**: Open the **+** menu and choose **Scraper**, then pick a platform and a data type. Entries come in two kinds: some scrape a link you paste, such as **personal profile** on LinkedIn or **product reviews** on Amazon; others search by keyword, hashtag, or name, such as **video search** on TikTok or **posts of a subreddit** on Reddit. Teable prefills the matching instruction in the chat input and leaves the part you need to fill in at the end. **Any web page** takes a pasted link directly. - **Skills**: Open the **+** menu and choose **Skills** to import, enable, disable, or try skills in the current chat. When you import one, choose who can use it: **Personal** keeps it to yourself, **Project** gives it to collaborators in this project, and **Space** gives it to everyone in this space. Type `/` in the input box to choose an enabled skill. To connect or migrate an external system, see [Connect & Migrate Everything](/en/basic/ai/connect-everything). - **Context usage**: The ring next to the input box shows how much of the model's context window the conversation currently uses. Click it for the percentage and token counts. When the context fills up, Teable compacts the conversation; start a new chat if you want a clean context instead. - **Manage files**: Open **+** → **More** → **Manage files** to view files in the current chat sandbox. You can preview supported files, download files, or delete files and folders you no longer need. A conversation must exist before its files can be managed. -- **Message queue**: Sending another message while AI is working does not interrupt it. The message waits in a queue above the input box and goes out when the current run ends. Queued items keep the same table, view, attachment, and selection chips as the chat input; **Remove** drops one, **...** → **Edit message** puts it back in the input box, and a text-only item also offers **Steer** to hand its text to the running turn instead of waiting. +- **Message queue**: Sending another message while AI is working does not interrupt it. The message waits in a queue above the input box and goes out when the current run ends. Queued items keep the same table, view, attachment, and selection chips as the chat input; **Remove** drops one, **...** → **Edit message** puts it back in the input box, and a text-only item also offers **Steer** to hand its text to the running turn instead of waiting. If the turn is parked on a card waiting for you (an authorization card, a question from AI), a text-only message does not queue: the card closes and is recorded as **Skipped**, and your message goes straight to that turn as its next instruction, so you do not have to deal with the card first. A message with attachments still goes to the queue. ## Manage Chats diff --git a/en/basic/ai/app-builder.mdx b/en/basic/ai/app-builder.mdx index 64104926..6c427cdf 100644 --- a/en/basic/ai/app-builder.mdx +++ b/en/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ The App Builder provides a dual-interface for both non-technical users and devel The command center for your app. - **Natural Language Editing**: Describe changes like *"Make the header blue"* or *"Add a submission form for new records"*. - **Auto-Routing**: The AI understands which component or page you are referring to and modifies it directly. -- **Integrations**: When the app task needs access to a third-party account, App Builder can show a card such as **Connect Slack** in the chat panel. Click **Connect** to authorize with OAuth. Click **Skip** to cancel this authorization; AI continues with the parts it can complete without that connection. +- **Credential requests**: When the app needs access to a third-party account or a secret at run time, App Builder pins a card to the chat panel, such as **This app needs your Slack connection**. Click **Connect my account** to run an OAuth flow; the new connection is granted to this app right away. If you already have a usable connection or secret, just grant it; there is no need to connect again. Click **Skip** to withhold the credential; AI continues with the parts it can complete without it. - **Skills**: Open the **+** menu and choose **Skills** to manage skills for this app conversation. A skill added here is only available to the current app, and the skills shared with the app's project and space can be used here as well. Type `/` in the input box to choose an enabled skill. - **Manage files**: Open **+** → **More** → **Manage files** to view files in the app sandbox. Use it to preview supported files, download generated files, or delete files and folders you no longer need. - **Clear Conversation**: If the current conversation has drifted, click **Clear Chat** in the bottom-right corner of the panel to start a new session. This clears the chat history for the current conversation but does not delete the app itself. The first use shows a confirmation, and you can choose not to show it again next time. @@ -273,6 +273,15 @@ Teable automatically tracks every deployment. className="docs-screenshot" /> +App Builder saves the changes of each round as a new version. When saving fails, a card appears in the chat. + + +The changes from the failed round stay in the sandbox only; they are lost when the sandbox is reclaimed, and regenerating the reply does not save them again. Act on the card promptly. + + +- **Version save failed**: this version was not saved. Let App Builder keep working, and the next successful save carries these changes along. +- **Changes too large to save**: this round exceeds the save size limit. Click **Send to AI** on the card and App Builder looks for oversized test artifacts, debug files, or attachments, cleans them up, and saves again. Such files may already be in the unsaved commit history, so deleting them may not be enough; let App Builder tidy that up as well. + ### Auto-fix If your custom code changes cause a build error, the deployment will fail. - Teable provides an **Auto-fix** button alongside the error log. diff --git a/en/basic/ai/routine.mdx b/en/basic/ai/routine.mdx index b6f9bb71..26149109 100644 --- a/en/basic/ai/routine.mdx +++ b/en/basic/ai/routine.mdx @@ -35,7 +35,6 @@ Besides the prompt and the schedule, 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 | -| **Max run time (minutes)** | A run past this limit is stopped and marked failed. 5–120 minutes; default 30 | | **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 | @@ -74,7 +73,6 @@ A **Failed** run states its reason, and each reason calls for a different respon | Message | Meaning | What to do | | --- | --- | --- | | **Run failed** | The run started but hit an error | Open the conversation for that run and judge from the failure point whether the prompt or the data is at fault | -| **Run timed out** | The run passed **Max run time** and was stopped | Raise **Max run time**, or split the prompt into smaller units of work | | **Skipped: not enough credits** | Credits ran out, so the run never started | Top up the space's credits | | **Skipped: the previous run was still in progress** | The previous run had not finished, so this occurrence was skipped | Lower the frequency, or reduce how much one run processes | | **Skipped: timed out waiting in the queue** | The run waited too long in the queue and was skipped | Occasional occurrences need no action; a recurring one means too much is scheduled at the same time, so stagger the schedules | diff --git a/en/basic/credential.mdx b/en/basic/credential.mdx index ef26895a..0a56bb76 100644 --- a/en/basic/credential.mdx +++ b/en/basic/credential.mdx @@ -63,14 +63,20 @@ 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. -## Credential Requests in AI Chat +## Authorization Cards in AI Chat -When AI needs an external account, it pins a credential request card to the conversation naming the service it wants a connection for, or the alias it wants a secret for. You can: +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. + +**Connect card**: appears when Cuppy itself has to read or write a service to finish the task, such as fetching mail from Gmail or writing to Notion. The card names the service; click **Connect** to run an OAuth flow or enter that service's key. The turn resumes once the connection is made, and the connection is saved under **My connections** in **Settings** → **Integrations**. Services Teable integrates itself and services managed by Composio are both connected from this card, so there is no need to visit the settings page first. **Skip** withholds the connection, and Cuppy continues with the parts that do not depend on it. If connecting fails, the card shows the error: click **Retry** to try again, or **Give up** to end the request. + +**Credential request card**: appears when an app or automation you are building needs the credential at run time, naming the service it wants a connection for, or the alias it wants a secret for. You can: - **Connect my account**: run an OAuth flow; the new connection is granted to the resource automatically. - **Grant my …**: use a connection or secret you already have. - **Skip**: withhold the credential. AI continues with the parts that do not depend on it. +Sending a message in the composer while a card waits also closes the card and records it as **Skipped**; your message becomes the next instruction for that turn. If the credential is still needed later, ask Cuppy to request it again. + ## Replace, Delete, and Leaving a Space Before you replace a secret value, delete a secret, or disconnect a connection, Teable lists the apps and automations still using it. Deleting and disconnecting break those resources immediately, so grant them a different credential first if they need to keep running. The old secret value cannot be recovered. diff --git a/es/basic/ai/ai-chat.mdx b/es/basic/ai/ai-chat.mdx index fc135d70..b9d5534e 100644 --- a/es/basic/ai/ai-chat.mdx +++ b/es/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ Cuando pegas un bloque largo de texto sin formato, Teable lo convierte en un arc - **Modelo**: Usa el menú de modelos para elegir el nivel de modelo de la conversación. El menú lista **Ultra**, **Smart**, **Standard** y **Lite**, del más capaz al menos capaz, e indica el modelo que hay detrás de cada uno; tu administrador puede cambiar ese modelo en cualquier momento u ofrecer solo algunos niveles, y tú no tienes que volver a elegir. Usa un nivel más bajo para consultas sencillas, limpieza o reescritura, y uno más alto para planificación compleja, análisis entre Tablas y creación de aplicaciones. - **Inteligencia**: Elige el nivel de **Inteligencia** por separado en el menú de modelos. Este controla la profundidad del razonamiento; los niveles superiores producen razonamientos más exhaustivos. - **Mis secretos**: Abre **+** → **Más** → **Mis secretos** para guardar claves de API u otras credenciales en **Ajustes** → **Integraciones**. Esos valores son tuyos, el Chat de IA puede leerlos como variables de entorno durante la ejecución y puedes concederlos a aplicaciones y automatizaciones concretas. Consulta [Credenciales e integraciones](/es/basic/credential). -- **Solicitudes de credenciales**: Cuando la IA necesita una cuenta externa o un secreto, fija en la conversación una tarjeta de solicitud. Elige **Conectar mi cuenta** para iniciar un flujo de OAuth o concede una credencial que ya tengas. Con **Omitir** no la facilitas; la IA continúa con las partes que puede completar sin ella. +- **Tarjetas de autorización**: Cuando la IA necesita una cuenta externa o un secreto, fija una tarjeta en la conversación y espera antes de seguir con el turno. Si es Cuppy quien necesita la cuenta para hacer la tarea, pulsa **Conectar** para iniciar un flujo de OAuth; si la credencial la necesita una aplicación o automatización al ejecutarse, elige **Conectar mi cuenta** o concede una credencial que ya tengas. Con **Omitir** no la facilitas; la IA continúa con las partes que puede completar sin ella. Consulta [Credenciales e integraciones](/es/basic/credential). - **Scraper**: Abre el menú **+**, elige **Scraper** y selecciona una plataforma y un tipo de dato. Hay dos clases de entradas: unas extraen a partir de un enlace que pegas, como **perfil personal** en LinkedIn o **reseñas del producto** en Amazon; otras buscan por palabra clave, hashtag o nombre, como **búsqueda de vídeos** en TikTok o **publicaciones de un subreddit** en Reddit. Teable rellena la instrucción correspondiente en la entrada del chat y deja al final la parte que debes completar. **Cualquier página web** acepta directamente un enlace pegado. - **Habilidades**: Abre el menú **+** y elige **Habilidades** para importar, habilitar, deshabilitar o probar habilidades en el chat actual. Cuando importes una, elige quién puede usarla: **Personal** la reserva para ti, **Proyecto** la ofrece a los colaboradores de este Proyecto y **Espacio** la ofrece a todos los usuarios de este Espacio. Escribe `/` en el cuadro de entrada para elegir una habilidad habilitada. Para conectar o migrar un sistema externo, consulta [Conecta y migra todo](/es/basic/ai/connect-everything). - **Uso del contexto**: El anillo situado junto al cuadro de entrada muestra qué proporción de la ventana de contexto del modelo está usando la conversación. Haz clic en él para consultar el porcentaje y el número de tokens. Cuando se llena el contexto, Teable compacta la conversación; inicia un chat nuevo si quieres partir de un contexto limpio. - **Administrar archivos**: Abre **+** → **Más** → **Administrar archivos** para consultar los archivos del entorno aislado del chat actual. Puedes obtener una vista previa de los archivos compatibles, descargarlos o eliminar los archivos y carpetas que ya no necesites. Debe existir una conversación para poder administrar sus archivos. -- **Cola de mensajes**: Enviar otro mensaje mientras la IA está trabajando no la interrumpe. El mensaje espera en una cola sobre el cuadro de entrada y se envía cuando termina la ejecución actual. Los elementos en cola conservan las mismas etiquetas de Tabla, Vista, archivo adjunto y selección que la entrada del chat; **Eliminar** descarta uno, **...** → **Editar mensaje** lo devuelve al cuadro de entrada y los elementos que solo contienen texto también ofrecen **Redirigir** para entregar el texto al turno en ejecución en lugar de esperar. +- **Cola de mensajes**: Enviar otro mensaje mientras la IA está trabajando no la interrumpe. El mensaje espera en una cola sobre el cuadro de entrada y se envía cuando termina la ejecución actual. Los elementos en cola conservan las mismas etiquetas de Tabla, Vista, archivo adjunto y selección que la entrada del chat; **Eliminar** descarta uno, **...** → **Editar mensaje** lo devuelve al cuadro de entrada y los elementos que solo contienen texto también ofrecen **Redirigir** para entregar el texto al turno en ejecución en lugar de esperar. Si el turno está detenido en una tarjeta que espera tu respuesta (una tarjeta de autorización, una pregunta de la IA), un mensaje de solo texto no entra en la cola: la tarjeta se cierra y queda marcada como **Omitido**, y tu mensaje pasa directamente a ese turno como su siguiente instrucción, así que no tienes que resolver antes la tarjeta. Los mensajes con archivos adjuntos siguen yendo a la cola. ## Gestionar los chats diff --git a/es/basic/ai/app-builder.mdx b/es/basic/ai/app-builder.mdx index 9c9cfae6..08e149f7 100644 --- a/es/basic/ai/app-builder.mdx +++ b/es/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ App Builder ofrece una interfaz doble tanto para usuarios sin conocimientos téc El centro de control de tu aplicación. - **Edición mediante lenguaje natural**: Describe cambios como *«Haz que el encabezado sea azul»* o *«Añade un formulario para enviar Registros nuevos»*. - **Enrutamiento automático**: La IA entiende a qué componente o página te refieres y lo modifica directamente. -- **Integraciones**: Cuando la tarea de la aplicación necesita acceso a una cuenta externa, App Builder puede mostrar una tarjeta como **Conectar Slack** en el panel de chat. Haz clic en **Conectar** para autorizar mediante OAuth. Haz clic en **Omitir** para cancelar la autorización; la IA continuará con las partes que pueda completar sin esa conexión. +- **Solicitudes de credenciales**: Cuando la aplicación necesita acceder a una cuenta externa o a un secreto al ejecutarse, App Builder fija una tarjeta en el panel de chat, por ejemplo **Esta aplicación necesita tu conexión de Slack**. Haz clic en **Conectar mi cuenta** para iniciar un flujo de OAuth; la nueva conexión se concede de inmediato a esta aplicación. Si ya tienes una conexión o un secreto que sirva, basta con concederlo: no hace falta volver a conectar. Con **Omitir** no facilitas la credencial; la IA continúa con las partes que puede completar sin ella. - **Habilidades**: Abre el menú **+** y elige **Habilidades** para administrar las habilidades de esta conversación de la aplicación. Las habilidades añadidas aquí solo están disponibles para la aplicación actual; también pueden usarse las que se comparten con el Proyecto y el Espacio de la aplicación. Escribe `/` en el cuadro de entrada para elegir una habilidad habilitada. - **Administrar archivos**: Abre **+** → **Más** → **Administrar archivos** para consultar los archivos del entorno aislado de la aplicación. Úsalo para obtener una vista previa de los archivos compatibles, descargar archivos generados o eliminar los archivos y carpetas que ya no necesites. - **Borrar conversación**: Si la conversación actual se ha desviado, haz clic en **Borrar chat** en la esquina inferior derecha del panel para iniciar una sesión nueva. Esto borra el historial del chat de la conversación actual, pero no elimina la aplicación. La primera vez se muestra una confirmación, y puedes elegir que no vuelva a aparecer. @@ -273,6 +273,15 @@ Teable realiza un seguimiento automático de cada implementación. className="docs-screenshot" /> +App Builder guarda los cambios de cada ronda como una versión nueva. Cuando el guardado falla, aparece una tarjeta en el chat. + + +Los cambios de la ronda fallida solo quedan en el sandbox; se pierden cuando el sandbox se recicla, y regenerar la respuesta tampoco los guarda. Atiende la tarjeta cuanto antes. + + +- **No se pudo guardar la versión**: esta versión no se guardó. Deja que App Builder siga trabajando: el próximo guardado correcto se llevará también estos cambios. +- **Cambios demasiado grandes para guardar**: esta ronda supera el límite de tamaño de guardado. Pulsa **Enviar a la IA** en la tarjeta y App Builder buscará artefactos de prueba, archivos de depuración o adjuntos demasiado grandes, los limpiará y volverá a guardar. Esos archivos pueden estar ya en el historial de confirmaciones sin guardar, así que borrarlos puede no bastar: deja que App Builder también ordene ese historial. + ### Corrección automática Si tus cambios en el código personalizado provocan un error de compilación, la implementación fallará. - Teable proporciona un botón **Corrección automática** junto al registro de errores. diff --git a/es/basic/ai/routine.mdx b/es/basic/ai/routine.mdx index 8243bea4..97a9e592 100644 --- a/es/basic/ai/routine.mdx +++ b/es/basic/ai/routine.mdx @@ -35,7 +35,6 @@ Además del prompt y la programación, 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 | -| **Tiempo máximo de ejecución (minutos)** | Una ejecución que supere este límite se detiene y se marca como fallida. De 5 a 120 minutos; 30 por defecto | | **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 | @@ -74,7 +73,6 @@ Una ejecución **Fallida** indica su motivo, y cada motivo pide una respuesta di | Mensaje | Significado | Qué hacer | | --- | --- | --- | | **La ejecución falló** | La ejecución empezó pero se topó con un error | Abre el chat de esa ejecución y deduce en el punto del fallo si la causa es el prompt o los datos | -| **La ejecución agotó el tiempo de espera** | La ejecución superó el **Tiempo máximo de ejecución** y se detuvo | Sube el **Tiempo máximo de ejecución** o divide el prompt en unidades de trabajo más pequeñas | | **Omitida: créditos insuficientes** | Se acabaron los créditos, así que la ejecución no llegó a empezar | Recarga los créditos del espacio | | **Omitida: la ejecución anterior seguía en curso** | La ejecución anterior no había terminado, así que se omitió esta ocurrencia | Baja la frecuencia o reduce cuánto procesa cada ejecución | | **Omitida: se agotó el tiempo de espera en la cola** | La ejecución esperó demasiado en la cola y se omitió | Si es puntual, no requiere nada; si se repite, hay demasiado programado a la vez, así que escalona las programaciones | diff --git a/es/basic/credential.mdx b/es/basic/credential.mdx index 356a698f..b6f87c92 100644 --- a/es/basic/credential.mdx +++ b/es/basic/credential.mdx @@ -63,14 +63,20 @@ 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. -## Solicitudes de credenciales en el Chat de IA +## Tarjetas de autorización en el Chat de IA -Cuando la IA necesita una cuenta externa, fija en la conversación una tarjeta de solicitud que indica de qué servicio quiere una conexión o para qué alias quiere un secreto. Puedes: +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. + +**Tarjeta de conexión**: aparece cuando es Cuppy quien necesita leer o escribir en un servicio para terminar la tarea, por ejemplo traer correo de Gmail o escribir en Notion. La tarjeta indica el servicio; pulsa **Conectar** para iniciar el flujo de OAuth o introducir la clave de ese servicio. En cuanto la conexión se completa, el turno continúa, y la conexión queda guardada en **Mis conexiones**, dentro de **Ajustes** → **Integraciones**. Tanto los servicios que Teable integra por su cuenta como los gestionados por Composio se conectan desde esta tarjeta, sin pasar antes por la página de ajustes. Con **Omitir** no facilitas la conexión y Cuppy continúa con las partes que no dependen de ella. Si la conexión falla, la tarjeta muestra el error: pulsa **Reintentar** para volver a intentarlo o **Abandonar** para terminar la solicitud. + +**Tarjeta de solicitud de credencial**: aparece cuando una aplicación o automatización que estás construyendo necesita la credencial al ejecutarse, e indica de qué servicio quiere una conexión o para qué alias quiere un secreto. Puedes: - **Conectar mi cuenta**: iniciar un flujo de OAuth; la nueva conexión se concede automáticamente al recurso. - **Conceder mi…**: usar una conexión o un secreto que ya tengas. - **Omitir**: no facilitar la credencial. La IA continúa con las partes que no dependen de ella. +Enviar un mensaje mientras la tarjeta espera también la cierra y la marca como **Omitido**; tu mensaje pasa a ser la siguiente instrucción de ese turno. Si más adelante sigues necesitando la credencial, pide a Cuppy que vuelva a solicitarla. + ## Sustituir, eliminar y salir de un espacio Antes de sustituir el valor de un secreto, eliminar un secreto o desconectar una conexión, Teable enumera las aplicaciones y automatizaciones que aún la usan. Eliminar y desconectar las deja fuera de servicio de inmediato, así que concédeles antes otra credencial si tienen que seguir funcionando. El valor anterior de un secreto no se puede recuperar. diff --git a/fr/basic/ai/ai-chat.mdx b/fr/basic/ai/ai-chat.mdx index de69bf43..bc985562 100644 --- a/fr/basic/ai/ai-chat.mdx +++ b/fr/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ Lorsque vous collez un long bloc de texte brut, Teable le convertit en pièce jo - **Modèle** : utilisez le menu des modèles pour choisir le niveau de modèle de la conversation. Le menu liste **Ultra**, **Smart**, **Standard** et **Lite**, du plus capable au moins capable, en indiquant pour chacun le modèle associé ; votre administrateur peut remplacer ce modèle à tout moment ou ne proposer que certains niveaux, sans que vous ayez à choisir de nouveau. Utilisez un niveau plus bas pour les requêtes simples, le nettoyage ou la réécriture, et un niveau plus élevé pour la planification complexe, l’analyse inter-tables et la création d’applications. - **Intelligence** : choisissez séparément le niveau d’**Intelligence** dans le menu des modèles. Il contrôle la profondeur de réflexion ; les niveaux plus élevés produisent un raisonnement plus approfondi. - **Mes secrets** : ouvrez **+** → **Plus** → **Mes secrets** pour enregistrer des clés API ou d’autres identifiants dans **Paramètres** → **Intégrations**. Ces valeurs vous appartiennent, le Chat IA peut les lire à l’exécution comme variables d’environnement, et vous pouvez les accorder à telle application ou telle automatisation. Voir [Identifiants et intégrations](/fr/basic/credential). -- **Demandes d’identifiants** : lorsque l’IA a besoin d’un compte tiers ou d’un secret, elle épingle une carte de demande dans la conversation. Choisissez **Connecter mon compte** pour lancer un parcours OAuth, ou accordez un identifiant que vous possédez déjà. **Ignorer** ne le fournit pas ; l’IA poursuit les parties qu’elle peut réaliser sans lui. +- **Cartes d’autorisation** : lorsque l’IA a besoin d’un compte tiers ou d’un secret, elle épingle une carte dans la conversation et attend avant de poursuivre le tour. Si c’est Cuppy qui a besoin du compte pour réaliser la tâche, cliquez sur **Connecter** pour lancer un parcours OAuth ; si l’identifiant est requis à l’exécution par une application ou une automatisation, choisissez **Connecter mon compte** ou accordez un identifiant que vous possédez déjà. **Ignorer** ne le fournit pas ; l’IA poursuit les parties qu’elle peut réaliser sans lui. Voir [Identifiants et intégrations](/fr/basic/credential). - **Scraper** : ouvrez le menu **+** et choisissez **Scraper**, puis une plateforme et un type de données. Les entrées sont de deux sortes : certaines extraient à partir d’un lien que vous collez, par exemple **profil personnel** sur LinkedIn ou **avis sur le produit** sur Amazon ; d’autres cherchent par mot-clé, hashtag ou nom, par exemple **recherche de vidéos** sur TikTok ou **publications d'un subreddit** sur Reddit. Teable pré-remplit l’instruction correspondante dans la saisie du chat et laisse à la fin la partie que vous devez compléter. **Page web quelconque** accepte directement un lien collé. - **Compétences** : ouvrez le menu **+** et choisissez **Compétences** pour importer, activer, désactiver ou essayer des compétences dans le chat actuel. Lors de l’importation, choisissez qui peut l’utiliser : **Personnel** la réserve à votre usage, **Projet** la donne aux collaborateurs de ce projet et **Espace** la donne à tous les membres de cet espace. Saisissez `/` dans le champ de saisie pour choisir une compétence activée. Pour connecter ou migrer un système externe, consultez [Tout connecter et migrer](/fr/basic/ai/connect-everything). - **Utilisation du contexte** : l’anneau à côté du champ de saisie indique la part de la fenêtre de contexte du modèle actuellement utilisée par la conversation. Cliquez dessus pour afficher le pourcentage et le nombre de jetons. Lorsque le contexte est plein, Teable compacte la conversation ; démarrez un nouveau chat si vous souhaitez un contexte vierge. - **Gérer les fichiers** : ouvrez **+** → **Plus** → **Gérer les fichiers** pour consulter les fichiers dans le bac à sable du chat actuel. Vous pouvez prévisualiser les fichiers pris en charge, télécharger des fichiers ou supprimer les fichiers et dossiers dont vous n’avez plus besoin. Une conversation doit exister avant que ses fichiers puissent être gérés. -- **File de messages** : envoyer un autre message pendant que l’IA travaille ne l’interrompt pas. Le message attend dans une file au-dessus du champ de saisie et est envoyé lorsque l’exécution actuelle se termine. Les éléments en attente conservent les mêmes pastilles de table, vue, pièce jointe et sélection que la saisie du chat ; **Supprimer** en retire un, **...** → **Modifier le message** le replace dans le champ de saisie, et un élément uniquement textuel propose aussi **Orienter** pour transmettre son texte à l’exécution en cours au lieu d’attendre. +- **File de messages** : envoyer un autre message pendant que l’IA travaille ne l’interrompt pas. Le message attend dans une file au-dessus du champ de saisie et est envoyé lorsque l’exécution actuelle se termine. Les éléments en attente conservent les mêmes pastilles de table, vue, pièce jointe et sélection que la saisie du chat ; **Supprimer** en retire un, **...** → **Modifier le message** le replace dans le champ de saisie, et un élément uniquement textuel propose aussi **Orienter** pour transmettre son texte à l’exécution en cours au lieu d’attendre. Si le tour est arrêté sur une carte qui vous attend (une carte d’autorisation, une question de l’IA), un message uniquement textuel ne rejoint pas la file : la carte se ferme et est marquée **Ignoré**, et votre message est transmis directement à ce tour comme consigne suivante, sans avoir à traiter la carte d’abord. Un message avec pièces jointes passe toujours par la file. ## Gérer les conversations diff --git a/fr/basic/ai/app-builder.mdx b/fr/basic/ai/app-builder.mdx index 30bf3c8f..9743424f 100644 --- a/fr/basic/ai/app-builder.mdx +++ b/fr/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ Le Créateur d’applications propose une double interface, destinée à la fois Le centre de commande de votre application. - **Modification en langage naturel** : décrivez des changements tels que *« Rends l’en-tête bleu »* ou *« Ajoute un formulaire de soumission pour les nouveaux Enregistrements »*. - **Routage automatique** : l’IA comprend le composant ou la page auquel vous faites référence et le modifie directement. -- **Intégrations** : lorsqu’une tâche de l’application nécessite l’accès à un compte tiers, le Créateur d’applications peut afficher une carte telle que **Connecter Slack** dans le panneau de chat. Cliquez sur **Connecter** pour autoriser OAuth. Cliquez sur **Ignorer** pour annuler cette autorisation ; l’IA poursuit les parties qu’elle peut réaliser sans cette connexion. +- **Demandes d’identifiants** : lorsque l’application a besoin d’accéder à un compte tiers ou à un secret à l’exécution, le Créateur d’applications épingle une carte dans le panneau de chat, par exemple **Cette application a besoin de votre connexion Slack**. Cliquez sur **Connecter mon compte** pour lancer un parcours OAuth ; la nouvelle connexion est aussitôt accordée à cette application. Si vous disposez déjà d’une connexion ou d’un secret utilisable, accordez-le simplement : inutile de vous reconnecter. **Ignorer** ne fournit pas l’identifiant ; l’IA poursuit les parties qu’elle peut réaliser sans lui. - **Compétences** : ouvrez le menu **+** et choisissez **Compétences** pour gérer les compétences de cette conversation d’application. Une compétence ajoutée ici est disponible uniquement pour l’application actuelle ; les compétences partagées avec le Projet et l’Espace de l’application peuvent également être utilisées ici. Saisissez `/` dans le champ de saisie pour choisir une compétence activée. - **Gérer les fichiers** : ouvrez **+** → **Plus** → **Gérer les fichiers** pour afficher les fichiers dans le bac à sable de l’application. Utilisez cette option pour prévisualiser les fichiers pris en charge, télécharger les fichiers générés ou supprimer les fichiers et dossiers dont vous n’avez plus besoin. - **Effacer la conversation** : si la conversation actuelle s’est écartée du sujet, cliquez sur **Effacer le chat** dans l’angle inférieur droit du panneau pour démarrer une nouvelle session. Cela efface l’historique de chat de la conversation actuelle, mais ne supprime pas l’application elle-même. Lors de la première utilisation, une confirmation s’affiche et vous pouvez choisir de ne plus l’afficher la prochaine fois. @@ -273,6 +273,15 @@ Teable suit automatiquement chaque déploiement. className="docs-screenshot" /> +Le Créateur d’applications enregistre les modifications de chaque tour comme une nouvelle version. Quand l’enregistrement échoue, une carte apparaît dans la conversation. + + +Les modifications du tour concerné ne subsistent que dans le bac à sable ; elles sont perdues quand celui-ci est recyclé, et régénérer la réponse ne les enregistre pas davantage. Traitez la carte sans tarder. + + +- **Échec de l’enregistrement de la version** : cette version n’a pas été enregistrée. Laissez le Créateur d’applications continuer : le prochain enregistrement réussi emportera aussi ces modifications. +- **Modifications trop volumineuses pour être enregistrées** : ce tour dépasse la limite de taille à l’enregistrement. Cliquez sur **Envoyer à l’IA** sur la carte : le Créateur d’applications recherche les artefacts de test, fichiers de débogage ou pièces jointes trop volumineux, fait le ménage, puis enregistre de nouveau. Ces fichiers peuvent déjà figurer dans l’historique des commits non enregistrés ; les supprimer ne suffit pas toujours, laissez le Créateur d’applications nettoyer aussi cet historique. + ### Correction automatique Si vos modifications de code personnalisé provoquent une erreur de compilation, le déploiement échoue. - Teable fournit un bouton **Correction automatique** à côté du journal d’erreurs. diff --git a/fr/basic/ai/routine.mdx b/fr/basic/ai/routine.mdx index ccb9907d..7bee9f09 100644 --- a/fr/basic/ai/routine.mdx +++ b/fr/basic/ai/routine.mdx @@ -35,7 +35,6 @@ Outre le prompt et la planification, 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 | -| **Durée maximale d’exécution (minutes)** | Une exécution qui dépasse cette limite est arrêtée et marquée en échec. De 5 à 120 minutes ; 30 par défaut | | **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 | @@ -74,7 +73,6 @@ Une exécution en **Échec** indique son motif, et chaque motif appelle une rép | Message | Signification | Que faire | | --- | --- | --- | | **Échec de l’exécution** | L’exécution a démarré mais a rencontré une erreur | Ouvrez la conversation de cette exécution et déterminez, au point de l’échec, si le prompt ou les données sont en cause | -| **Délai d’exécution dépassé** | L’exécution a dépassé la **Durée maximale d’exécution** et a été arrêtée | Augmentez la **Durée maximale d’exécution**, ou découpez le prompt en unités de travail plus petites | | **Ignorée : crédits insuffisants** | Les crédits étaient épuisés, l’exécution n’a pas démarré | Rechargez les crédits de l’espace | | **Ignorée : l’exécution précédente était toujours en cours** | L’exécution précédente n’était pas terminée, cette occurrence a été ignorée | Réduisez la fréquence, ou allégez ce que traite une exécution | | **Ignorée : délai d’attente en file dépassé** | L’exécution a trop attendu dans la file et a été ignorée | Un cas isolé ne demande rien ; si cela se répète, trop de choses sont planifiées en même temps : échelonnez les planifications | diff --git a/fr/basic/credential.mdx b/fr/basic/credential.mdx index d2f02bef..e6c3b1af 100644 --- a/fr/basic/credential.mdx +++ b/fr/basic/credential.mdx @@ -63,14 +63,20 @@ 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. -## Demandes d’identifiants dans le Chat IA +## Cartes d’autorisation dans le Chat IA -Quand l’IA a besoin d’un compte externe, elle épingle dans la conversation une carte de demande d’identifiant qui précise le service pour lequel elle veut une connexion, ou l’alias pour lequel elle veut un secret. Vous pouvez : +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. + +**Carte de connexion** : elle apparaît quand Cuppy doit lui-même lire ou écrire dans un service pour terminer la tâche, par exemple récupérer des messages dans Gmail ou écrire dans Notion. La carte nomme le service ; cliquez sur **Connecter** pour lancer le parcours OAuth ou saisir la clé délivrée par ce service. Une fois la connexion établie, le tour reprend, et la connexion est enregistrée sous **Mes connexions**, dans **Paramètres** → **Intégrations**. Les services intégrés par Teable comme ceux gérés par Composio se connectent depuis cette carte, sans passer d’abord par la page des paramètres. **Passer** ne fournit pas la connexion et Cuppy poursuit les parties qui n’en dépendent pas. En cas d’échec, la carte affiche l’erreur : **Réessayer** relance la connexion, **Abandonner** met fin à la demande. + +**Carte de demande d’identifiant** : elle apparaît quand une application ou une automatisation que vous construisez a besoin de l’identifiant à l’exécution, et précise le service pour lequel elle veut une connexion, ou l’alias pour lequel elle veut un secret. Vous pouvez : - **Connecter mon compte** : lancer un parcours OAuth ; la nouvelle connexion est accordée automatiquement à la ressource. - **Accorder mon…** : utiliser une connexion ou un secret que vous possédez déjà. - **Ignorer** : ne pas fournir l’identifiant. L’IA poursuit les parties qui n’en dépendent pas. +Envoyer un message pendant que la carte attend la ferme également et la marque **Ignoré** ; votre message devient la consigne suivante de ce tour. Si l’identifiant reste nécessaire plus tard, demandez à Cuppy de le redemander. + ## Remplacer, supprimer et quitter un espace Avant que vous remplaciez la valeur d’un secret, supprimiez un secret ou déconnectiez une connexion, Teable liste les applications et automatisations qui l’utilisent encore. La suppression et la déconnexion les mettent aussitôt hors service : accordez-leur d’abord un autre identifiant si elles doivent continuer à tourner. L’ancienne valeur d’un secret est irrécupérable. diff --git a/it/basic/ai/ai-chat.mdx b/it/basic/ai/ai-chat.mdx index 895e85c6..86f0203e 100644 --- a/it/basic/ai/ai-chat.mdx +++ b/it/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ Quando incolli un lungo blocco di testo normale, Teable lo converte in un allega - **Modello**: usa il menu dei modelli per scegliere il livello di modello della conversazione. Il menu elenca **Ultra**, **Smart**, **Standard** e **Lite** dal più capace in giù, indicando per ciascuno il modello che lo sostiene; il tuo amministratore può sostituire quel modello in qualsiasi momento oppure offrire solo alcuni livelli, senza che tu debba scegliere di nuovo. Usa un livello più basso per query semplici, pulizia o riscrittura e uno più alto per pianificazione complessa, analisi tra Tabelle e creazione di app. - **Intelligenza**: scegli separatamente il livello di **Intelligenza** nel menu dei modelli. Controlla la profondità del ragionamento; i livelli superiori producono un'analisi più approfondita. - **I miei segreti**: apri **+** → **Altro** → **I miei segreti** per salvare chiavi API o altre credenziali in **Impostazioni** → **Integrazioni**. I valori sono tuoi, AI Chat può leggerli come variabili di ambiente durante l'esecuzione e puoi concederli alle singole app e Automazioni. Vedi [Credenziali e integrazioni](/it/basic/credential). -- **Richieste di credenziali**: quando l'IA ha bisogno di un account di terze parti o di un segreto, fissa nella conversazione una scheda di richiesta. Scegli **Collega il mio account** per avviare un flusso OAuth oppure concedi una credenziale che possiedi già. Con **Salta** non la fornisci e l'IA continua con le parti che può completare senza di essa. +- **Schede di autorizzazione**: quando l'IA ha bisogno di un account di terze parti o di un segreto, fissa una scheda nella conversazione e attende prima di proseguire il turno. Se è Cuppy stesso ad aver bisogno dell'account per svolgere l'attività, fai clic su **Collega** per avviare un flusso OAuth; se la credenziale serve in esecuzione a un'app o a un'automazione, scegli **Collega il mio account** oppure concedi una credenziale che possiedi già. Con **Salta** non la fornisci e l'IA continua con le parti che può completare senza di essa. Vedi [Credenziali e integrazioni](/it/basic/credential). - **Scraper**: apri il menu **+**, scegli **Scraper** e seleziona una piattaforma e un tipo di dato. Le voci sono di due tipi: alcune estraggono da un link che incolli, ad esempio **profilo personale** su LinkedIn o **recensioni del prodotto** su Amazon; altre cercano per parola chiave, hashtag o nome, ad esempio **ricerca video** su TikTok o **post di un subreddit** su Reddit. Teable precompila l'istruzione corrispondente nell'input della chat e lascia in fondo la parte che devi completare. **Qualsiasi pagina web** accetta direttamente un link incollato. - **Skill**: apri il menu **+** e scegli **Skill** per importare, abilitare, disabilitare o provare le skill nella chat corrente. Durante l'importazione, scegli chi può utilizzarla: **Personale** la mantiene soltanto per te, **Progetto** la rende disponibile ai collaboratori del Progetto e **Spazio** a tutti gli utenti dello Spazio. Digita `/` nella casella di input per scegliere una skill abilitata. Per collegare o migrare un sistema esterno, consulta [Collega e migra tutto](/it/basic/ai/connect-everything). - **Utilizzo del contesto**: l'anello accanto alla casella di input mostra la quantità della finestra di contesto del modello attualmente utilizzata dalla conversazione. Fai clic su di esso per visualizzare la percentuale e il numero di token. Quando il contesto si riempie, Teable compatta la conversazione; avvia una nuova chat se desideri invece un contesto vuoto. - **Gestisci file**: apri **+** → **Altro** → **Gestisci file** per visualizzare i file nella sandbox della chat corrente. Puoi visualizzare in anteprima i file supportati, scaricarli oppure eliminare file e cartelle non più necessari. Prima di poter gestire i file deve esistere una conversazione. -- **Coda dei messaggi**: l'invio di un altro messaggio mentre l'IA è al lavoro non la interrompe. Il messaggio attende in una coda sopra la casella di input e viene inviato al termine dell'esecuzione corrente. Gli elementi in coda mantengono le stesse etichette relative a Tabella, Vista, allegati e selezione presenti nell'input della chat; **Rimuovi** ne elimina uno, **...** → **Modifica messaggio** lo riporta nella casella di input e un elemento di solo testo offre anche **Intervieni** per fornire immediatamente il testo al turno in esecuzione anziché attendere. +- **Coda dei messaggi**: l'invio di un altro messaggio mentre l'IA è al lavoro non la interrompe. Il messaggio attende in una coda sopra la casella di input e viene inviato al termine dell'esecuzione corrente. Gli elementi in coda mantengono le stesse etichette relative a Tabella, Vista, allegati e selezione presenti nell'input della chat; **Rimuovi** ne elimina uno, **...** → **Modifica messaggio** lo riporta nella casella di input e un elemento di solo testo offre anche **Intervieni** per fornire immediatamente il testo al turno in esecuzione anziché attendere. Se il turno è fermo su una scheda in attesa di una tua risposta (una scheda di autorizzazione, una domanda dell'IA), un messaggio di solo testo non entra in coda: la scheda si chiude e viene segnata come **Saltato**, e il tuo messaggio arriva subito a quel turno come istruzione successiva, senza dover prima gestire la scheda. Un messaggio con allegati va comunque in coda. ## Gestire le chat diff --git a/it/basic/ai/app-builder.mdx b/it/basic/ai/app-builder.mdx index 2e282840..149ab11f 100644 --- a/it/basic/ai/app-builder.mdx +++ b/it/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ App Builder offre una doppia interfaccia, sia per gli utenti non tecnici sia per Il centro di comando della tua app. - **Modifica con linguaggio naturale**: descrivi modifiche come *«Rendi blu l'intestazione»* o *«Aggiungi un modulo per l'invio di nuovi Record»*. - **Indirizzamento automatico**: l'IA comprende a quale componente o pagina fai riferimento e lo modifica direttamente. -- **Integrazioni**: quando l'attività dell'app richiede l'accesso a un account di terze parti, App Builder può mostrare nel pannello della chat una scheda come **Collega Slack**. Fai clic su **Collega** per autorizzare tramite OAuth. Fai clic su **Ignora** per annullare l'autorizzazione; l'IA continua con le parti che può completare senza tale connessione. +- **Richieste di credenziali**: quando l'app ha bisogno di accedere a un account di terze parti o a un segreto durante l'esecuzione, App Builder fissa una scheda nel pannello della chat, per esempio **Questa app ha bisogno della tua connessione Slack**. Fai clic su **Collega il mio account** per avviare un flusso OAuth; la nuova connessione viene concessa subito a questa app. Se possiedi già una connessione o un segreto utilizzabile, ti basta concederlo: non serve collegarsi di nuovo. Con **Salta** non fornisci la credenziale e l'IA continua con le parti che può completare senza di essa. - **Skill**: apri il menu **+** e scegli **Skill** per gestire le skill della conversazione di questa app. Una skill aggiunta qui è disponibile soltanto per l'app corrente; qui è inoltre possibile utilizzare le skill condivise con il Progetto e lo Spazio dell'app. Digita `/` nella casella di input per scegliere una skill abilitata. - **Gestisci file**: apri **+** → **Altro** → **Gestisci file** per visualizzare i file nella sandbox dell'app. Usalo per visualizzare in anteprima i file supportati, scaricare i file generati oppure eliminare file e cartelle non più necessari. - **Cancella conversazione**: se la conversazione corrente ha perso il filo, fai clic su **Cancella chat** nell'angolo in basso a destra del pannello per avviare una nuova sessione. In questo modo viene cancellata la cronologia della chat per la conversazione corrente, ma l'app non viene eliminata. Al primo utilizzo viene mostrata una conferma e puoi scegliere di non visualizzarla più in futuro. @@ -273,6 +273,15 @@ Teable tiene automaticamente traccia di ogni distribuzione. className="docs-screenshot" /> +App Builder salva le modifiche di ogni giro come una nuova versione. Quando il salvataggio non riesce, nella chat compare una scheda. + + +Le modifiche del giro non riuscito restano solo nella sandbox: vanno perse quando la sandbox viene rilasciata e non vengono salvate nemmeno rigenerando la risposta. Intervieni sulla scheda per tempo. + + +- **Salvataggio della versione non riuscito**: questa versione non è stata salvata. Lascia proseguire App Builder: il primo salvataggio riuscito porterà con sé anche queste modifiche. +- **Modifiche troppo grandi per il salvataggio**: questo giro supera il limite di dimensione per il salvataggio. Fai clic su **Invia all'IA** nella scheda: App Builder cerca artefatti di test, file di debug o allegati troppo grandi, li ripulisce e salva di nuovo. Quei file possono essere già finiti nella cronologia dei commit non salvati, quindi cancellarli può non bastare: lascia che sia App Builder a sistemare anche quella. + ### Correzione automatica Se le modifiche al codice personalizzato causano un errore di build, la distribuzione non riesce. - Teable mostra un pulsante **Correzione automatica** accanto al registro degli errori. diff --git a/it/basic/ai/routine.mdx b/it/basic/ai/routine.mdx index 5e2009c5..c8e4c881 100644 --- a/it/basic/ai/routine.mdx +++ b/it/basic/ai/routine.mdx @@ -35,7 +35,6 @@ Oltre al prompt e alla pianificazione, 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 | -| **Durata massima di esecuzione (minuti)** | Un'esecuzione che supera questo limite viene interrotta e segnata come non riuscita. Da 5 a 120 minuti; 30 per impostazione predefinita | | **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 | @@ -74,7 +73,6 @@ Un'esecuzione **Non riuscita** indica il motivo, e ogni motivo richiede una risp | Messaggio | Significato | Che cosa fare | | --- | --- | --- | | **Esecuzione non riuscita** | L'esecuzione è partita ma ha incontrato un errore | Apri la chat di quell'esecuzione e valuta, nel punto dell'errore, se la causa è il prompt o i dati | -| **Tempo di esecuzione scaduto** | L'esecuzione ha superato la **Durata massima di esecuzione** ed è stata interrotta | Alza la **Durata massima di esecuzione**, oppure dividi il prompt in unità di lavoro più piccole | | **Saltata: crediti insufficienti** | I crediti erano esauriti, l'esecuzione non è partita | Ricarica i crediti dello spazio | | **Saltata: l'esecuzione precedente era ancora in corso** | L'esecuzione precedente non era finita, quindi questa occorrenza è stata saltata | Abbassa la frequenza, oppure riduci quanto elabora una singola esecuzione | | **Saltata: tempo di attesa in coda scaduto** | L'esecuzione ha atteso troppo in coda ed è stata saltata | Un caso isolato non richiede nulla; se si ripete, c'è troppo pianificato nello stesso momento: scagliona le pianificazioni | diff --git a/it/basic/credential.mdx b/it/basic/credential.mdx index 129e9411..5e44ae16 100644 --- a/it/basic/credential.mdx +++ b/it/basic/credential.mdx @@ -63,14 +63,20 @@ 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. -## Richieste di credenziali in AI Chat +## Schede di autorizzazione in AI Chat -Quando l'IA ha bisogno di un account esterno, fissa nella conversazione una scheda di richiesta che indica per quale servizio vuole una connessione o per quale alias vuole un segreto. Puoi: +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. + +**Scheda di connessione**: compare quando è Cuppy stesso a dover leggere o scrivere su un servizio per completare l'attività, per esempio recuperare posta da Gmail o scrivere su Notion. La scheda indica il servizio; fai clic su **Collega** per avviare il flusso OAuth o inserire la chiave di quel servizio. Appena la connessione è pronta il turno riprende e la connessione resta in **Le mie connessioni**, dentro **Impostazioni** → **Integrazioni**. Sia i servizi che Teable integra direttamente sia quelli gestiti da Composio si collegano da questa scheda, senza passare prima dalla pagina delle impostazioni. Con **Salta** non fornisci la connessione e Cuppy prosegue con le parti che non ne dipendono. Se la connessione non riesce, la scheda mostra l'errore: **Riprova** per un nuovo tentativo, **Rinuncia** per chiudere la richiesta. + +**Scheda di richiesta credenziale**: compare quando un'app o un'automazione che stai costruendo ha bisogno della credenziale in esecuzione e indica per quale servizio vuole una connessione o per quale alias vuole un segreto. Puoi: - **Collega il mio account**: avviare un flusso OAuth; la nuova connessione viene concessa automaticamente alla risorsa. - **Concedi il mio…**: usare una connessione o un segreto che possiedi già. - **Salta**: non fornire la credenziale. L'IA prosegue con le parti che non ne dipendono. +Anche inviare un messaggio mentre la scheda è in attesa la chiude e la segna come **Saltato**; il tuo messaggio diventa l'istruzione successiva di quel turno. Se la credenziale serve ancora più avanti, chiedi a Cuppy di richiederla di nuovo. + ## Sostituzione, eliminazione e uscita da uno spazio Prima che tu sostituisca il valore di un segreto, elimini un segreto o disconnetta una connessione, Teable elenca le app e le Automazioni che la usano ancora. L'eliminazione e la disconnessione le bloccano immediatamente: se devono continuare a funzionare, concedi loro prima un'altra credenziale. Il vecchio valore di un segreto non è recuperabile. diff --git a/ja/basic/ai/ai-chat.mdx b/ja/basic/ai/ai-chat.mdx index b749873d..8d5c2421 100644 --- a/ja/basic/ai/ai-chat.mdx +++ b/ja/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ AIは、現在のページにある情報を優先します。 - **モデル**:モデルメニューで会話に使用するモデル階層を選択します。メニューには能力の高い順に **Ultra**、**Smart**、**Standard**、**Lite** が並び、それぞれの背後にあるモデルが表示されます。管理者はそのモデルをいつでも差し替えられ、一部の階層だけを提供することもできますが、選び直す必要はありません。単純なクエリ、データ整理、文章の書き換えには低い階層を、複雑な計画、テーブル横断分析、アプリ構築には高い階層を使用します。 - **インテリジェンス**:モデルメニューで**インテリジェンス**レベルを個別に選択します。これは思考の深さを制御し、レベルが高いほど、より詳細な推論が行われます。 - **自分のシークレット**:**+** → **もっと** → **自分のシークレット**を開き、**設定** → **統合**でAPIキーやその他の認証情報を保存します。これらの値は個人に属し、AIチャットは実行時に環境変数として読み取れます。個々のアプリやオートメーションへ付与することもできます。詳しくは[認証情報と連携](/ja/basic/credential)を参照してください。 -- **認証情報のリクエスト**:AIがサードパーティーアカウントやシークレットを必要とする場合、認証情報リクエストのカードが会話に固定されます。**自分のアカウントを接続**でOAuthを実行するか、すでに持っている認証情報を付与します。**スキップ**を選ぶと認証情報は渡されず、AIはそれなしで完了できる処理を続行します。 +- **認可カード**:AIがサードパーティーアカウントやシークレットを必要とする場合、カードが会話に固定され、対応するまでそのターンは先に進みません。Cuppy自身がそのアカウントを使ってタスクを行う場合は、**接続**を押してOAuthを実行します。アプリやオートメーションが実行時にその認証情報を必要とする場合は、**自分のアカウントを接続**を選ぶか、すでに持っている認証情報を付与します。**スキップ**を選ぶと認証情報は渡されず、AIはそれなしで完了できる処理を続行します。詳しくは[認証情報と連携](/ja/basic/credential)をご覧ください。 - **Webスクレイパー**:**+**メニューを開いて**Webスクレイパー**を選択し、プラットフォームとデータの種類を選びます。項目は2種類あり、貼り付けたリンクから抽出するもの(LinkedInの**個人プロフィール**、Amazonの**商品レビュー**など)と、キーワード、ハッシュタグ、名前で探すもの(TikTokの**動画検索**、Redditの**サブレディットの投稿**など)があります。選ぶと対応する抽出の指示がチャット入力欄へ自動で入力され、補うべき部分が末尾に残ります。**任意のWebページ**を選べば、リンクを貼り付けるだけで抽出できます。 - **Skill**: **+**メニューを開き、**Skill**を選択して、現在のチャットでSkillをインポート、有効化、無効化、試用します。インポート時に利用者を選びます。**個人**は自分だけ、**プロジェクト**はこのプロジェクトのコラボレーター、**スペース**はこのスペースの全員が利用できます。入力ボックスに`/`と入力すると、有効なSkillを選択できます。外部システムへの接続または移行については、[あらゆるデータへ接続・移行](/ja/basic/ai/connect-everything)をご覧ください。 - **コンテキスト使用量**:入力ボックスの横にあるリングは、会話が現在使用しているモデルのコンテキストウィンドウの量を示します。クリックすると、割合とトークン数を確認できます。コンテキストがいっぱいになると、Teableは会話を圧縮します。新しいコンテキストから始める場合は、新しいチャットを開始してください。 - **ファイルを管理**:**+** → **その他** → **ファイルを管理**を開くと、現在のチャットのサンドボックス内にあるファイルを表示できます。対応ファイルのプレビュー、ファイルのダウンロード、不要になったファイルやフォルダーの削除が可能です。ファイルを管理するには、会話が存在している必要があります。 -- **メッセージキュー**:AIの処理中に別のメッセージを送信しても、処理は中断されません。メッセージは入力ボックス上部のキューで待機し、現在の実行が終了すると送信されます。キュー内の項目には、チャット入力時と同じテーブル、ビュー、添付ファイル、選択範囲のチップが保持されます。**削除**で項目を取り除き、**...** → **メッセージを編集**で入力ボックスへ戻せます。テキストだけの項目では、待機する代わりに、そのテキストを実行中のターンへ渡す**指示を追加**も利用できます。 +- **メッセージキュー**:AIの処理中に別のメッセージを送信しても、処理は中断されません。メッセージは入力ボックス上部のキューで待機し、現在の実行が終了すると送信されます。キュー内の項目には、チャット入力時と同じテーブル、ビュー、添付ファイル、選択範囲のチップが保持されます。**削除**で項目を取り除き、**...** → **メッセージを編集**で入力ボックスへ戻せます。テキストだけの項目では、待機する代わりに、そのテキストを実行中のターンへ渡す**指示を追加**も利用できます。ターンが対応待ちのカード(認可カード、AIからの質問など)で止まっている場合、テキストだけのメッセージはキューに入りません。カードは閉じて**スキップ済み**として記録され、メッセージはそのターンの次の指示としてすぐに渡されるため、先にカードを処理する必要はありません。添付ファイル付きのメッセージはこれまでどおりキューに入ります。 ## チャットを管理する diff --git a/ja/basic/ai/app-builder.mdx b/ja/basic/ai/app-builder.mdx index dfd592f9..4a9056e3 100644 --- a/ja/basic/ai/app-builder.mdx +++ b/ja/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ App Builderには、技術者以外のユーザーと開発者の両方に対応 アプリの司令塔です。 - **自然言語による編集**:*「ヘッダーを青にして」*、*「新しいレコードの送信フォームを追加して」*など、変更内容を説明します。 - **自動ルーティング**:AIが参照しているコンポーネントまたはページを理解し、直接変更します。 -- **連携**:アプリのタスクでサードパーティーアカウントへのアクセスが必要な場合、App Builderはチャットパネルに**Slackへ接続**などのカードを表示できます。**接続**をクリックしてOAuth認証を行います。認証をキャンセルするには**スキップ**をクリックします。AIは、その接続なしで完了できる処理を続行します。 +- **認証情報のリクエスト**:アプリが実行時にサードパーティーアカウントやシークレットを必要とする場合、App Builderはチャットパネルに**このアプリにはあなたの Slack 接続が必要です**のようなカードを固定します。**自分のアカウントを接続**をクリックするとOAuthを実行し、新しい接続はそのままこのアプリへ付与されます。使える接続やシークレットをすでに持っている場合は、付与するだけで済み、接続し直す必要はありません。**スキップ**をクリックすると認証情報は渡されず、AIはそれなしで完了できる処理を続行します。 - **Skill**: **+**メニューを開いて**Skill**を選択し、このアプリの会話で使用するSkillを管理します。ここで追加したSkillは現在のアプリでのみ利用でき、アプリのプロジェクトとスペースで共有されているSkillも使用できます。入力ボックスに`/`と入力すると、有効なSkillを選択できます。 - **ファイルを管理**:**+** → **その他** → **ファイルを管理**を開き、アプリのサンドボックス内にあるファイルを表示します。対応ファイルのプレビュー、生成ファイルのダウンロード、不要になったファイルやフォルダーの削除に使用します。 - **会話を消去**:現在の会話が本題から外れた場合は、パネル右下の**チャットを消去**をクリックして、新しいセッションを開始します。現在の会話のチャット履歴は消去されますが、アプリ自体は削除されません。初回は確認が表示され、次回から表示しないよう選択できます。 @@ -273,6 +273,15 @@ Teableは、すべてのデプロイを自動的に追跡します。 className="docs-screenshot" /> +App Builderは、各ターンの変更を新しいバージョンとして保存します。保存に失敗すると、チャットにカードが表示されます。 + + +保存に失敗したターンの変更はサンドボックスにしか残らず、サンドボックスが回収されると失われます。返信を生成し直しても保存はやり直されません。カードが出たら早めに対処してください。 + + +- **バージョンの保存に失敗しました**:このバージョンは保存されていません。App Builderにそのまま作業を続けさせれば、次に保存が成功したときにこれらの変更も一緒に保存されます。 +- **変更サイズが大きすぎて保存できません**:このターンの変更が保存サイズの上限を超えています。カードの**AI に送信**をクリックすると、App Builderが大きすぎるテスト成果物、デバッグファイル、添付ファイルを調べて整理し、あらためて保存します。こうしたファイルは未保存のコミット履歴に入っていることがあり、ファイルを削除するだけでは足りない場合があるため、履歴の整理もApp Builderに任せてください。 + ### 自動修正 カスタムコードの変更によってビルドエラーが発生すると、デプロイは失敗します。 - Teableは、エラーログの横に**自動修正**ボタンを表示します。 diff --git a/ja/basic/ai/routine.mdx b/ja/basic/ai/routine.mdx index 425a673c..3d23ea53 100644 --- a/ja/basic/ai/routine.mdx +++ b/ja/basic/ai/routine.mdx @@ -35,7 +35,6 @@ description: Cuppy がプロンプトをスケジュールどおりに実行し | 設定 | 説明 | | --- | --- | | **モデル** | このルーティンが使うモデルと知能レベル。**デフォルトモデル** のままにするとスペースの既定のチャットモデルを使います | -| **最大実行時間(分)** | この時間を超えた実行は中断され、失敗として記録されます。5〜120 分、既定は 30 | | **チャット** | **実行ごとに新しいチャット** は各回を互いに独立させます。**前回の実行のチャットを続ける** はこれまでの実行の文脈を引き継ぐため、前回の結果を参照する必要がある作業に向きます | | **開始** / **終了(任意)** | スケジュールの範囲。終了時刻を設定しなければ無期限に実行し続けます | @@ -74,7 +73,6 @@ description: Cuppy がプロンプトをスケジュールどおりに実行し | 表示 | 意味 | 対処 | | --- | --- | --- | | **実行に失敗しました** | 実行は開始したがエラーになった | その実行のチャットを開き、エラー箇所からプロンプトとデータのどちらが原因かを判断します | -| **実行がタイムアウトしました** | **最大実行時間** を超えて中断された | **最大実行時間** を延ばすか、プロンプトを小さな処理単位に分割します | | **スキップ:クレジット不足** | クレジットが足りず実行されなかった | スペースのクレジットを補充します | | **スキップ:前回の実行がまだ進行中でした** | 前回の実行が終わっておらず、この予定時刻が飛ばされた | 頻度を下げるか、1 回あたりの処理量を減らします | | **スキップ:キューでの待機がタイムアウトしました** | キューでの待機が長すぎて飛ばされた | 単発なら対処不要です。繰り返す場合は同時刻に処理が集中しているので、スケジュールをずらします | diff --git a/ja/basic/credential.mdx b/ja/basic/credential.mdx index df757111..972136ed 100644 --- a/ja/basic/credential.mdx +++ b/ja/basic/credential.mdx @@ -63,14 +63,20 @@ description: 自分の接続とシークレットを管理し、必要なアプ オートメーションの入力欄にキーらしき文字列を貼り付けると、Teableはそれを自分のシークレットとして保存し、その場には参照だけを残します。平文がワークフローの設定に残ることはありません。貼り付けたままにしたい場合は、通知の**元に戻す**をクリックします。 -## AIチャットでの認証情報リクエスト +## AIチャットでの認可カード -AIが外部アカウントを必要とする場合、どのサービスの接続か、どのエイリアスのシークレットかを示す認証情報リクエストのカードが会話に固定されます。選択肢は次のとおりです。 +AIが外部アカウントを必要とする場合、**このタスクには認証が必要です** と書かれたカードが会話に固定され、対応するまでそのターンは先に進みません。カードは、その認証情報を誰が使うかによって2種類あります。 + +**接続カード**:Gmailからメールを取得する、Notionに書き込むなど、Cuppy自身がサービスを読み書きしてタスクを終える必要があるときに表示されます。カードにはサービス名が示され、**接続** を押すとOAuthを実行するか、そのサービスのキーを入力します。接続が完了するとそのターンが再開し、接続は **設定** → **統合** の **自分の接続** に保存されます。Teableが自ら連携しているサービスも、Composioが管理するサービスも、このカードから接続できるので、先に設定画面を開く必要はありません。**スキップ** を押すと接続せず、AIはそれに依存しない部分の処理を続けます。接続に失敗した場合はカードにエラーが表示されるので、**再試行** でもう一度接続するか、**中止** でこのリクエストを終了します。 + +**認証情報リクエストのカード**:作成中のアプリやオートメーションが実行時にその認証情報を必要とするときに表示され、どのサービスの接続か、どのエイリアスのシークレットかを示します。選択肢は次のとおりです。 - **自分のアカウントを接続**:OAuthを実行します。新しい接続はそのリソースへ自動的に付与されます。 - **自分の…を付与**:すでに持っている接続やシークレットを使います。 - **スキップ**:認証情報を渡しません。AIはそれに依存しない部分の処理を続けます。 +カードが待っている間に入力欄からメッセージを送っても、カードは閉じて **スキップ済み** として記録され、そのメッセージがこのターンの次の指示になります。あとで改めて認証情報が必要になったときは、Cuppyにもう一度リクエストさせてください。 + ## 値の変更、削除、スペースからの退出 シークレットの値を変更する、シークレットを削除する、接続を解除する前に、Teableはそれをまだ使っているアプリとオートメーションを一覧表示します。削除と接続解除を実行すると、それらのリソースはすぐに動かなくなります。動かし続けたい場合は、先にリソース側で別の認証情報に切り替えてください。以前のシークレットの値は復元できません。 diff --git a/ru/basic/ai/ai-chat.mdx b/ru/basic/ai/ai-chat.mdx index f7d53756..0aa9a863 100644 --- a/ru/basic/ai/ai-chat.mdx +++ b/ru/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ description: Взаимодействуйте с данными на естес - **Модель**: используйте меню модели, чтобы выбрать уровень модели для беседы. В меню перечислены **Ultra**, **Smart**, **Standard** и **Lite** от самого мощного к самому лёгкому, и для каждого указана стоящая за ним модель. Администратор может заменить эту модель в любой момент или предлагать только часть уровней, а выбирать заново вам не придётся. Выбирайте уровень пониже для простых запросов, очистки или переписывания и уровень повыше для сложного планирования, анализа нескольких таблиц и создания приложений. - **Интеллект**: отдельно выберите уровень **Интеллекта** в меню модели. Он управляет глубиной рассуждений; более высокие уровни дают более тщательное обоснование. - **Мои секреты**: откройте **+** → **Больше** → **Мои секреты**, чтобы сохранить API-ключи или другие учётные данные в разделе **Настройки** → **Интеграции**. Эти значения принадлежат вам, ИИ-чат читает их во время работы как переменные окружения, и вы можете выдавать их отдельным приложениям и автоматизациям. См. [Учётные данные и интеграции](/ru/basic/credential). -- **Запросы учётных данных**: когда ИИ нужна сторонняя учётная запись или секрет, он закрепляет в беседе карточку запроса. Выберите **Подключить мой аккаунт**, чтобы пройти OAuth, либо выдайте уже имеющиеся учётные данные. Кнопка **Пропустить** оставляет их при вас, и ИИ продолжает с тем, что может выполнить без них. +- **Карточки авторизации**: когда ИИ нужна сторонняя учётная запись или секрет, он закрепляет в беседе карточку и ждёт вашего действия, прежде чем продолжить ход. Если аккаунт нужен самому Cuppy для выполнения задачи, нажмите **Подключить**, чтобы пройти OAuth; если учётные данные нужны приложению или автоматизации во время работы, выберите **Подключить мой аккаунт** либо выдайте уже имеющиеся. Кнопка **Пропустить** оставляет их при вас, и ИИ продолжает с тем, что может выполнить без них. См. [Учётные данные и интеграции](/ru/basic/credential). - **Скрейпер**: откройте меню **+**, выберите **Скрейпер**, затем платформу и тип данных. Пункты бывают двух видов: одни собирают данные по вставленной ссылке, например **личный профиль** в LinkedIn или **отзывы о товаре** на Amazon; другие ищут по ключевому слову, хештегу или имени, например **поиск видео** в TikTok или **посты сабреддита** на Reddit. Teable подставит в поле ввода готовую инструкцию и оставит в конце часть, которую нужно дополнить. **Любая веб-страница** принимает вставленную ссылку напрямую. - **Навыки**: откройте меню **+** и выберите **Навыки**, чтобы импортировать, включать, отключать или пробовать навыки в текущем чате. При импорте выберите, кто сможет его использовать: **Личный** оставляет его только вам, **Проект** предоставляет его соавторам в этом проекте, а **Пространство** — всем в этом пространстве. Введите `/` в поле ввода, чтобы выбрать включенный навык. Сведения о подключении или миграции внешней системы см. в разделе [Подключайте и переносите всё](/ru/basic/ai/connect-everything). - **Использование контекста**: кольцо рядом с полем ввода показывает, какую часть контекстного окна модели сейчас использует беседа. Нажмите его, чтобы увидеть процент и количество токенов. Когда контекст заполняется, Teable сжимает беседу; если нужен чистый контекст, начните новый чат. - **Управление файлами**: откройте **+** → **Ещё** → **Управление файлами**, чтобы просмотреть файлы в изолированной среде текущего чата. Можно просматривать поддерживаемые файлы, скачивать их или удалять ненужные файлы и папки. Для управления файлами беседа уже должна существовать. -- **Очередь сообщений**: отправка другого сообщения, пока ИИ работает, не прерывает его. Сообщение ожидает в очереди над полем ввода и будет отправлено после завершения текущего запуска. Элементы в очереди сохраняют те же чипы таблицы, представления, вложения и выбора, что и поле ввода чата; **Удалить** удаляет элемент, **...** → **Редактировать сообщение** возвращает его в поле ввода, а для элемента только с текстом также доступно **Направить**, чтобы передать его текст текущему запуску вместо ожидания. +- **Очередь сообщений**: отправка другого сообщения, пока ИИ работает, не прерывает его. Сообщение ожидает в очереди над полем ввода и будет отправлено после завершения текущего запуска. Элементы в очереди сохраняют те же чипы таблицы, представления, вложения и выбора, что и поле ввода чата; **Удалить** удаляет элемент, **...** → **Редактировать сообщение** возвращает его в поле ввода, а для элемента только с текстом также доступно **Направить**, чтобы передать его текст текущему запуску вместо ожидания. Если ход остановлен на карточке, которая ждёт вашего действия (карточка авторизации, вопрос от ИИ), сообщение только с текстом не попадает в очередь: карточка закрывается и отмечается как **Пропущено**, а ваше сообщение сразу уходит в этот ход как следующая инструкция, так что разбираться с карточкой заранее не нужно. Сообщение с вложениями по-прежнему попадает в очередь. ## Управление чатами diff --git a/ru/basic/ai/app-builder.mdx b/ru/basic/ai/app-builder.mdx index 659b04c2..29387e2f 100644 --- a/ru/basic/ai/app-builder.mdx +++ b/ru/basic/ai/app-builder.mdx @@ -38,7 +38,7 @@ description: Превращайте свои данные в пользоват - **Редактирование на естественном языке**: опишите изменения, например *«Сделай заголовок синим»* или *«Добавь форму отправки для новых Записей»*. - **Автоматическая маршрутизация**: ИИ понимает, на какой компонент или страницу вы ссылаетесь, и изменяет их напрямую. -- **Интеграции**: когда задача приложения требует доступа к сторонней учётной записи, Конструктор приложений может показать в панели чата карточку, например **Подключить Slack**. Нажмите **Подключить**, чтобы авторизоваться через OAuth. Нажмите **Пропустить**, чтобы отменить авторизацию; ИИ продолжит работу с частями, которые может выполнить без этого подключения. +- **Запросы учётных данных**: когда приложению во время работы нужен доступ к сторонней учётной записи или секрет, Конструктор приложений закрепляет в панели чата карточку, например **Этому ресурсу (приложение) нужно ваше подключение Slack**. Нажмите **Подключить мой аккаунт**, чтобы пройти OAuth: новое подключение сразу выдаётся этому приложению. Если подходящее подключение или секрет уже есть, достаточно выдать его — подключаться заново не нужно. Кнопка **Пропустить** оставляет учётные данные при вас, и ИИ продолжает с тем, что может выполнить без них. - **Навыки**: откройте меню **+** и выберите **Навыки**, чтобы управлять навыками для этого диалога приложения. Добавленный здесь навык доступен только текущему приложению, также здесь можно использовать навыки, общие с Проектом и Пространством приложения. Введите `/` в поле ввода, чтобы выбрать включённый навык. - **Управление файлами**: откройте **+** → **Ещё** → **Управление файлами**, чтобы просмотреть файлы в песочнице приложения. Используйте этот раздел для предварительного просмотра поддерживаемых файлов, загрузки созданных файлов или удаления ненужных файлов и папок. - **Очистить беседу**: если текущая беседа ушла в сторону, нажмите **Очистить чат** в правом нижнем углу панели, чтобы начать новый сеанс. Это очистит историю чата текущей беседы, но не удалит само приложение. При первом использовании появится подтверждение, где можно выбрать, не показывать его в следующий раз. @@ -286,6 +286,15 @@ Teable автоматически отслеживает каждое развё className="docs-screenshot" /> +Конструктор приложений сохраняет изменения каждого хода как новую версию. Если сохранить не удалось, в чате появляется карточка. + + +Изменения неудачного хода остаются только в песочнице: когда песочница освобождается, они теряются, а повторная генерация ответа их не сохраняет. Реагируйте на карточку сразу. + + +- **Не удалось сохранить версию**: эта версия не сохранена. Дайте Конструктору приложений продолжить работу — следующее успешное сохранение заберёт эти изменения с собой. +- **Изменения слишком велики для сохранения**: этот ход превышает предельный размер сохранения. Нажмите на карточке **Отправить ИИ**: Конструктор приложений поищет слишком крупные тестовые артефакты, отладочные файлы или вложения, уберёт их и сохранит снова. Такие файлы могут уже находиться в несохранённой истории коммитов, поэтому одного удаления файлов может не хватить — пусть Конструктор приложений разберёт и историю. + ### Автоисправление Если ваши изменения пользовательского кода вызывают ошибку сборки, развёртывание завершится неудачей. diff --git a/ru/basic/ai/routine.mdx b/ru/basic/ai/routine.mdx index ed86899f..788c1c01 100644 --- a/ru/basic/ai/routine.mdx +++ b/ru/basic/ai/routine.mdx @@ -35,7 +35,6 @@ description: Cuppy выполняет промпт по расписанию, а | Настройка | Описание | | --- | --- | | **Модель** | Модель и уровень интеллекта, на которых работает эта рутина. Оставьте **Модель по умолчанию**, чтобы использовать модель чата, заданную в пространстве | -| **Максимальное время выполнения (минуты)** | Запуск сверх этого предела прерывается и отмечается как неудачный. От 5 до 120 минут, по умолчанию 30 | | **Чат** | **Новый чат для каждого запуска** оставляет запуски независимыми друг от друга; **Продолжить чат предыдущего запуска** переносит контекст прошлых запусков и подходит для работы, которой нужен предыдущий результат | | **Начало** / **Окончание (необязательно)** | Границы расписания. Без времени окончания рутина работает бессрочно | @@ -74,7 +73,6 @@ description: Cuppy выполняет промпт по расписанию, а | Сообщение | Значение | Что делать | | --- | --- | --- | | **Запуск завершился ошибкой** | Запуск начался, но столкнулся с ошибкой | Откройте чат этого запуска и по месту сбоя определите, дело в промпте или в данных | -| **Время выполнения истекло** | Запуск превысил **Максимальное время выполнения** и был прерван | Увеличьте **Максимальное время выполнения** или разбейте промпт на меньшие порции работы | | **Пропущен: недостаточно кредитов** | Кредиты закончились, запуск не начался | Пополните кредиты пространства | | **Пропущен: предыдущий запуск ещё выполнялся** | Предыдущий запуск не завершился, поэтому это срабатывание пропущено | Снизьте частоту или уменьшите объём работы одного запуска | | **Пропущен: истекло время ожидания в очереди** | Запуск слишком долго ждал в очереди и был пропущен | Единичный случай ничего не требует; если повторяется, на одно время запланировано слишком много — разнесите расписания | diff --git a/ru/basic/credential.mdx b/ru/basic/credential.mdx index c2ef3938..819a9159 100644 --- a/ru/basic/credential.mdx +++ b/ru/basic/credential.mdx @@ -63,14 +63,20 @@ description: Управляйте своими подключениями и с Если вставить в поле автоматизации строку, похожую на ключ, Teable сохранит её как ваш секрет и оставит на месте ссылку, поэтому открытый текст не попадёт в конфигурацию рабочего процесса. Чтобы оставить текст как есть, нажмите **Отменить** в уведомлении. -## Запросы учётных данных в ИИ-чате +## Карточки авторизации в ИИ-чате -Когда ИИ нужен внешний аккаунт, он закрепляет в беседе карточку запроса и указывает, для какого сервиса нужно подключение или под каким псевдонимом нужен секрет. Варианты: +Когда ИИ нужен внешний аккаунт, он закрепляет в беседе карточку с заголовком **Для этой задачи требуется авторизация** и ждёт вашего действия, прежде чем продолжить ход. Карточек две — в зависимости от того, кому нужны учётные данные. + +**Карточка подключения** появляется, когда самому Cuppy нужно читать или писать в сервис, чтобы выполнить задачу: забрать почту из Gmail, записать данные в Notion. На карточке указан сервис; нажмите **Подключить**, чтобы пройти OAuth или ввести ключ этого сервиса. Как только подключение готово, ход продолжается, а само подключение сохраняется в разделе **Мои подключения** в **Настройках** → **Интеграции**. И сервисы, которые Teable интегрирует сам, и сервисы под управлением Composio подключаются с этой карточки, заходить в настройки заранее не нужно. **Пропустить** — не давать подключение; ИИ продолжит с тем, что от него не зависит. Если подключиться не удалось, карточка покажет ошибку: **Повторить** — попробовать ещё раз, **Отказаться** — завершить запрос. + +**Карточка запроса учётных данных** появляется, когда приложению или автоматизации, которые вы создаёте, эти данные нужны во время работы; она указывает, для какого сервиса нужно подключение или под каким псевдонимом нужен секрет. Варианты: - **Подключить мой аккаунт** — пройти OAuth; новое подключение выдаётся ресурсу автоматически. - **Выдать мой…** — использовать уже имеющееся подключение или секрет. - **Пропустить** — не предоставлять учётные данные. ИИ продолжит с тем, что не зависит от них. +Если во время ожидания карточки отправить сообщение, карточка тоже закроется и будет отмечена как **Пропущено**, а ваше сообщение станет следующей инструкцией этого хода. Когда учётные данные понадобятся снова, попросите Cuppy запросить их ещё раз. + ## Замена, удаление и выход из пространства Перед заменой значения секрета, удалением секрета или отключением подключения Teable перечислит приложения и автоматизации, которые их ещё используют. После удаления и отключения эти ресурсы сразу перестают работать, поэтому сначала выдайте им другие учётные данные, если они должны продолжать работу. Прежнее значение секрета восстановить нельзя. diff --git a/tr/basic/ai/ai-chat.mdx b/tr/basic/ai/ai-chat.mdx index a2da0f40..ebfe1e04 100644 --- a/tr/basic/ai/ai-chat.mdx +++ b/tr/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ Uzun bir düz metin bloğu yapıştırdığınızda Teable, mesaj girişinin kol - **Model**: Sohbette kullanılacak model katmanını seçmek için model menüsünü kullanın. Menüde en yetenekliden başlayarak **Ultra**, **Smart**, **Standard** ve **Lite** yer alır ve her birinin arkasındaki model gösterilir; yöneticiniz bu modeli istediği zaman değiştirebilir ya da katmanların yalnızca bir kısmını sunabilir, sizin yeniden seçim yapmanız gerekmez. Basit sorgular, temizleme veya yeniden yazma için daha alt; karmaşık planlama, Tablolar arası analiz ve uygulama geliştirme için daha üst bir katman kullanın. - **Zekâ**: Model menüsünden **Zekâ** düzeyini ayrıca seçin. Bu ayar düşünme derinliğini belirler; daha yüksek düzeyler daha kapsamlı akıl yürütme sağlar. - **Gizli anahtarlarım**: **+** → **Daha Fazla** → **Gizli anahtarlarım** yolunu açıp API anahtarlarını veya diğer kimlik bilgilerini **Ayarlar** → **Entegrasyonlar** bölümüne kaydedin. Bu değerler size aittir, AI Chat bunları çalışma sırasında ortam değişkeni olarak okuyabilir ve tek tek uygulama ve otomasyonlara verebilirsiniz. Bkz. [Kimlik Bilgileri ve Entegrasyonlar](/tr/basic/credential). -- **Kimlik bilgisi istekleri**: AI'ın üçüncü taraf bir hesaba veya bir gizli anahtara ihtiyacı olduğunda sohbete bir kimlik bilgisi isteği kartı sabitlenir. OAuth akışı için **Hesabımı bağla**'yı seçin ya da hâlihazırda sahip olduğunuz bir kimlik bilgisine erişim verin. **Atla**'ya tıklarsanız kimlik bilgisini vermezsiniz; AI, onsuz tamamlayabildiği bölümlerle devam eder. +- **Yetkilendirme kartları**: AI'ın üçüncü taraf bir hesaba veya bir gizli anahtara ihtiyacı olduğunda sohbete bir kart sabitlenir ve siz karşılık verene kadar tur ilerlemez. Hesaba görevi yapmak için Cuppy'nin kendisi ihtiyaç duyuyorsa OAuth akışı için **Bağlan**'a tıklayın; kimlik bilgisine çalışma sırasında bir uygulama ya da otomasyon ihtiyaç duyuyorsa **Hesabımı bağla**'yı seçin veya hâlihazırda sahip olduğunuz bir kimlik bilgisine erişim verin. **Atla**'ya tıklarsanız kimlik bilgisini vermezsiniz; AI, onsuz tamamlayabildiği bölümlerle devam eder. Bkz. [Kimlik Bilgileri ve Entegrasyonlar](/tr/basic/credential). - **Kazıyıcı**: **+** menüsünü açıp **Kazıyıcı**'yı seçin, ardından bir platform ve veri türü belirleyin. Girişler iki türlüdür: bir kısmı yapıştırdığınız bağlantıdan veri çeker, örneğin LinkedIn'de **kişisel profil** veya Amazon'da **ürün yorumları**; diğerleri anahtar kelime, etiket ya da adla arar, örneğin TikTok'ta **video arama** veya Reddit'te **subreddit'in gönderileri**. Teable ilgili talimatı sohbet girişine önceden doldurur ve tamamlamanız gereken kısmı sonda bırakır. **Herhangi bir web sayfası** seçeneği yapıştırdığınız bağlantıyı doğrudan alır. - **Skill'ler**: Mevcut sohbette Skill'leri içe aktarmak, etkinleştirmek, devre dışı bırakmak veya denemek için **+** menüsünü açıp **Skill'ler**'i seçin. Bir Skill'i içe aktarırken kimlerin kullanabileceğini seçin: **Kişisel** yalnızca sizin kullanımınıza sunar, **Proje** bu Projedeki işbirlikçilerin, **Alan** ise bu Alandaki herkesin kullanımına sunar. Etkin bir Skill'i seçmek için giriş kutusuna `/` yazın. Harici bir sistemi bağlamak veya taşımak için [Her Şeyi Bağlama ve Taşıma](/tr/basic/ai/connect-everything) bölümüne bakın. - **Bağlam kullanımı**: Giriş kutusunun yanındaki halka, sohbetin model bağlam penceresinin ne kadarını kullandığını gösterir. Yüzdeyi ve token sayılarını görmek için halkaya tıklayın. Bağlam dolduğunda Teable sohbeti sıkıştırır; temiz bir bağlam istiyorsanız yeni bir sohbet başlatın. - **Dosyaları yönetme**: Mevcut sohbet korumalı alanındaki dosyaları görüntülemek için **+** → **Diğer** → **Dosyaları yönet** yolunu açın. Desteklenen dosyaları önizleyebilir, dosyaları indirebilir veya artık gerek duymadığınız dosya ve klasörleri silebilirsiniz. Dosyaların yönetilebilmesi için bir sohbetin mevcut olması gerekir. -- **Mesaj kuyruğu**: AI çalışırken başka bir mesaj göndermek işlemi kesintiye uğratmaz. Mesaj, giriş kutusunun üzerindeki kuyrukta bekler ve mevcut çalışma sona erdiğinde gönderilir. Kuyruktaki öğeler sohbet girişiyle aynı Tablo, Görünüm, ek ve seçim etiketlerini korur; **Kaldır** bir öğeyi siler, **...** → **Mesajı düzenle** öğeyi yeniden giriş kutusuna taşır, yalnızca metin içeren öğelerde bulunan **Yönlendir** ise metni bekletmek yerine çalışan işleme aktarır. +- **Mesaj kuyruğu**: AI çalışırken başka bir mesaj göndermek işlemi kesintiye uğratmaz. Mesaj, giriş kutusunun üzerindeki kuyrukta bekler ve mevcut çalışma sona erdiğinde gönderilir. Kuyruktaki öğeler sohbet girişiyle aynı Tablo, Görünüm, ek ve seçim etiketlerini korur; **Kaldır** bir öğeyi siler, **...** → **Mesajı düzenle** öğeyi yeniden giriş kutusuna taşır, yalnızca metin içeren öğelerde bulunan **Yönlendir** ise metni bekletmek yerine çalışan işleme aktarır. Tur, sizi bekleyen bir kartta duruyorsa (yetkilendirme kartı, AI'ın sorusu), yalnızca metin içeren mesaj kuyruğa girmez: kart kapanır ve **Atlandı** olarak işaretlenir, mesajınız da o turun bir sonraki talimatı olarak doğrudan iletilir, yani önce kartla uğraşmanız gerekmez. Ek içeren mesajlar yine kuyruğa girer. ## Sohbetleri yönetme diff --git a/tr/basic/ai/app-builder.mdx b/tr/basic/ai/app-builder.mdx index db6d63e1..17f52730 100644 --- a/tr/basic/ai/app-builder.mdx +++ b/tr/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ App Builder, hem teknik bilgisi olmayan kullanıcılar hem de geliştiriciler i Uygulamanızın komuta merkezi. - **Doğal Dille Düzenleme**: *"Üstbilgiyi mavi yap"* veya *"Yeni Kayıtlar için bir gönderim formu ekle"* gibi değişiklikleri açıklayın. - **Otomatik Yönlendirme**: AI, hangi bileşen veya sayfadan söz ettiğinizi anlar ve doğrudan değiştirir. -- **Entegrasyonlar**: Uygulama görevinin üçüncü taraf bir hesaba erişmesi gerektiğinde App Builder, sohbet panelinde **Slack'e Bağlan** gibi bir kart gösterebilir. OAuth ile yetkilendirmek için **Bağlan**'a tıklayın. Bu yetkilendirmeyi iptal etmek için **Atla**'ya tıklayın; AI, bu bağlantı olmadan tamamlayabildiği bölümlerle devam eder. +- **Kimlik bilgisi istekleri**: Uygulamanın çalışma sırasında üçüncü taraf bir hesaba ya da gizli anahtara erişmesi gerektiğinde App Builder, sohbet paneline **Bu uygulama sizin Slack bağlantınıza ihtiyaç duyuyor** gibi bir kart sabitler. OAuth akışı için **Hesabımı bağla**'ya tıklayın; yeni bağlantı doğrudan bu uygulamaya verilir. Kullanılabilir bir bağlantınız ya da gizli anahtarınız zaten varsa yalnızca erişim vermeniz yeterlidir, yeniden bağlanmanız gerekmez. **Atla**'ya tıklarsanız kimlik bilgisini vermezsiniz; AI, onsuz tamamlayabildiği bölümlerle devam eder. - **Skill'ler**: Bu uygulama sohbetinin Skill'lerini yönetmek için **+** menüsünü açıp **Skill'ler**'i seçin. Buraya eklenen bir Skill yalnızca mevcut uygulamada kullanılabilir; uygulamanın Proje ve Alanıyla paylaşılan Skill'ler de burada kullanılabilir. Etkin bir Skill'i seçmek için giriş kutusuna `/` yazın. - **Dosyaları yönetme**: Uygulama korumalı alanındaki dosyaları görüntülemek için **+** → **Diğer** → **Dosyaları yönet** yolunu açın. Desteklenen dosyaları önizlemek, oluşturulan dosyaları indirmek veya artık gerek duymadığınız dosya ve klasörleri silmek için bu seçeneği kullanın. - **Sohbeti Temizleme**: Mevcut sohbet konudan uzaklaştıysa yeni bir oturum başlatmak için panelin sağ alt köşesindeki **Sohbeti Temizle**'ye tıklayın. Bu işlem mevcut sohbetin geçmişini temizler ancak uygulamanın kendisini silmez. İlk kullanımda bir onay gösterilir; bu onayın daha sonra yeniden gösterilmemesini seçebilirsiniz. @@ -273,6 +273,15 @@ Teable her dağıtımı otomatik olarak izler. className="docs-screenshot" /> +App Builder her turun değişikliklerini yeni bir sürüm olarak kaydeder. Kayıt başarısız olduğunda sohbette bir kart çıkar. + + +Başarısız turun değişiklikleri yalnızca korumalı alanda kalır; korumalı alan geri alındığında kaybolur ve yanıtı yeniden üretmek de kaydı tekrarlamaz. Kartı gördüğünüzde vakit kaybetmeden işlem yapın. + + +- **Sürüm kaydedilemedi**: bu sürüm kaydedilmedi. App Builder'ın çalışmayı sürdürmesine izin verin; ilk başarılı kayıt bu değişiklikleri de beraberinde götürür. +- **Değişiklikler kaydedilemeyecek kadar büyük**: bu tur, kayıt boyutu sınırını aşıyor. Karttaki **Yapay zekaya gönder** düğmesine tıklayın; App Builder aşırı büyük test çıktılarını, hata ayıklama dosyalarını veya ekleri arar, temizler ve yeniden kaydeder. Bu dosyalar kaydedilmemiş commit geçmişine girmiş olabileceğinden yalnızca silmek yetmeyebilir; geçmişi de App Builder'a toparlatın. + ### Otomatik düzeltme Özel kod değişiklikleriniz derleme hatasına yol açarsa dağıtım başarısız olur. - Teable, hata günlüğünün yanında bir **Otomatik düzeltme** düğmesi sunar. diff --git a/tr/basic/ai/routine.mdx b/tr/basic/ai/routine.mdx index 900ad3ba..b474392a 100644 --- a/tr/basic/ai/routine.mdx +++ b/tr/basic/ai/routine.mdx @@ -35,7 +35,6 @@ Prompt ve zamanlamanın 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 | -| **Maksimum çalışma süresi (dakika)** | Bu sınırı aşan çalıştırma durdurulur ve başarısız sayılır. 5–120 dakika; varsayılan 30 | | **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 | @@ -74,7 +73,6 @@ Rutini açıp **Çalıştırma Geçmişi** sekmesine geçin. Liste duruma ve tar | Mesaj | Anlamı | Ne yapmalı | | --- | --- | --- | | **Çalıştırma başarısız oldu** | Çalıştırma başladı ama bir hatayla karşılaştı | O çalıştırmanın sohbetini açıp hata noktasından sorunun prompt'ta mı veride mi olduğuna karar verin | -| **Çalıştırma zaman aşımına uğradı** | Çalıştırma **Maksimum çalışma süresi** sınırını aşıp durduruldu | **Maksimum çalışma süresi** değerini yükseltin ya da prompt'u daha küçük iş parçalarına bölün | | **Atlandı: yeterli kredi yok** | Kredi tükendiği için çalıştırma hiç başlamadı | Alanın kredisini yükleyin | | **Atlandı: önceki çalıştırma hâlâ devam ediyordu** | Önceki çalıştırma bitmediği için bu sefer atlandı | Sıklığı düşürün ya da tek çalıştırmanın işlediği miktarı azaltın | | **Atlandı: sırada bekleme zaman aşımına uğradı** | Çalıştırma sırada fazla bekleyip atlandı | Tek seferlik durumlar için bir şey gerekmez; tekrarlıyorsa aynı ana çok iş yığılmıştır, zamanlamaları birbirinden ayırın | diff --git a/tr/basic/credential.mdx b/tr/basic/credential.mdx index 7af7850f..0d496792 100644 --- a/tr/basic/credential.mdx +++ b/tr/basic/credential.mdx @@ -63,14 +63,20 @@ 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. -## AI Chat'te kimlik bilgisi istekleri +## AI Chat'te yetkilendirme kartları -AI'ın bir dış hesaba ihtiyacı olduğunda, hangi hizmet için bağlantı ya da hangi takma ad için gizli anahtar istediğini belirten bir kimlik bilgisi isteği kartını sohbete sabitler. Seçenekleriniz: +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. + +**Bağlantı kartı**: görevi tamamlamak için bir hizmeti okuması ya da ona yazması gereken Cuppy'nin kendisi olduğunda çıkar; örneğin Gmail'den posta almak, Notion'a yazmak. Kartta hizmetin adı yazar; **Bağlan** ile OAuth akışını çalıştırır ya da o hizmetin anahtarını girersiniz. Bağlantı kurulur kurulmaz tur kaldığı yerden sürer ve bağlantı **Ayarlar** → **Entegrasyonlar** altındaki **Bağlantılarım** bölümüne kaydedilir. Teable'ın kendi entegre ettiği hizmetler de Composio'nun yönettiği hizmetler de bu karttan bağlanır, önce ayarlar sayfasına gitmeniz gerekmez. **Atla** derseniz bağlantı verilmez ve AI, buna bağlı olmayan bölümlerle devam eder. Bağlantı başarısız olursa kart hatayı gösterir: **Yeniden dene** ile tekrar deneyin, **Vazgeç** ile isteği sonlandırın. + +**Kimlik bilgisi isteği kartı**: oluşturduğunuz bir uygulama ya da otomasyon çalışırken bu kimlik bilgisine ihtiyaç duyduğunda çıkar ve hangi hizmet için bağlantı ya da hangi takma ad için gizli anahtar istediğini belirtir. Seçenekleriniz: - **Hesabımı bağla**: OAuth akışını çalıştırır; yeni bağlantı kaynağa otomatik olarak verilir. - **… erişimi ver**: hâlihazırda sahip olduğunuz bir bağlantıyı veya gizli anahtarı kullanır. - **Atla**: kimlik bilgisini vermezsiniz. AI, buna bağlı olmayan bölümlerle devam eder. +Kart beklerken yazı alanından mesaj göndermek de kartı kapatır ve **Atlandı** olarak işaretler; mesajınız o turun bir sonraki talimatı olur. Kimlik bilgisi daha sonra yine gerekirse Cuppy'den isteği yeniden açmasını isteyin. + ## Değiştirme, silme ve alandan ayrılma Bir gizli anahtarın değerini değiştirmeden, bir gizli anahtarı silmeden veya bir bağlantıyı kesmeden önce Teable onu hâlâ kullanan uygulama ve otomasyonları listeler. Silme ve bağlantı kesme bu kaynakları anında durdurur; çalışmaya devam etmeleri gerekiyorsa önce onlara başka bir kimlik bilgisi verin. Eski gizli anahtar değeri geri getirilemez. diff --git a/uk/basic/ai/ai-chat.mdx b/uk/basic/ai/ai-chat.mdx index 226c410f..7886a336 100644 --- a/uk/basic/ai/ai-chat.mdx +++ b/uk/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ AI Chat допомагає аналізувати поточну Таблицю, - **Модель**: у меню моделей виберіть рівень моделі для розмови. У меню перелічені **Ultra**, **Smart**, **Standard** і **Lite** від найпотужнішого до найлегшого, і для кожного вказано модель, що стоїть за ним. Адміністратор може замінити цю модель будь-коли або пропонувати лише частину рівнів, а вибирати заново вам не доведеться. Використовуйте нижчий рівень для простих запитів, очищення або переписування, а вищий — для складного планування, аналізу кількох Таблиць і створення застосунків. - **Інтелект**: окремо виберіть рівень **Інтелект** у меню моделей. Він визначає глибину міркування; вищі рівні забезпечують докладніший аналіз. - **Мої секрети**: відкрийте **+** → **Більше** → **Мої секрети**, щоб зберегти ключі API або інші облікові дані в розділі **Налаштування** → **Інтеграції**. Ці значення належать вам, AI Chat читає їх під час роботи як змінні середовища, і ви можете надавати їх окремим застосункам та автоматизаціям. Див. [Облікові дані та інтеграції](/uk/basic/credential). -- **Запити облікових даних**: коли ШІ потрібен сторонній обліковий запис або секрет, у розмові закріплюється картка запиту. Виберіть **Підключити мій обліковий запис**, щоб пройти OAuth, або надайте наявні облікові дані. Кнопка **Пропустити** лишає їх при вас, і ШІ продовжує з тим, що не залежить від них. +- **Картки авторизації**: коли ШІ потрібен сторонній обліковий запис або секрет, у розмові закріплюється картка, і хід не триває далі, доки ви не відреагуєте. Якщо обліковий запис потрібен самому Cuppy, щоб виконати завдання, натисніть **Підключити** і пройдіть OAuth; якщо облікові дані потрібні застосунку або автоматизації під час роботи, виберіть **Підключити мій обліковий запис** або надайте наявні. Кнопка **Пропустити** лишає їх при вас, і ШІ продовжує з тим, що не залежить від них. Див. [Облікові дані та інтеграції](/uk/basic/credential). - **Скрейпер**: відкрийте меню **+**, виберіть **Скрейпер**, а потім платформу й тип даних. Пункти бувають двох видів: одні збирають дані за вставленим посиланням, наприклад **особистий профіль** у LinkedIn або **відгуки про товар** на Amazon; інші шукають за ключовим словом, хештегом чи іменем, наприклад **пошук відео** у TikTok або **дописи сабреддіту** на Reddit. Teable підставить у поле введення готову інструкцію й залишить у кінці частину, яку потрібно доповнити. **Будь-яка вебсторінка** приймає вставлене посилання напряму. - **Навички**: відкрийте меню **+** і виберіть **Навички**, щоб імпортувати, увімкнути, вимкнути або випробувати навички в поточному чаті. Під час імпорту виберіть, хто може використовувати навичку: **Особиста** доступна лише вам, **Проєкт** — співавторам у цьому Проєкті, а **Простір** — усім у цьому Просторі. Введіть `/` у полі введення, щоб вибрати ввімкнену навичку. Щоб підключити або перенести зовнішню систему, див. розділ [Підключення та перенесення будь-яких даних](/uk/basic/ai/connect-everything). - **Використання контексту**: кільце поруч із полем введення показує, яку частину контекстного вікна моделі зараз використовує розмова. Натисніть його, щоб переглянути відсоток і кількість токенів. Коли контекст заповнюється, Teable стискає розмову; почніть новий чат, якщо потрібен чистий контекст. - **Керування файлами**: відкрийте **+** → **Більше** → **Керування файлами**, щоб переглянути файли в пісочниці поточного чату. Можна попередньо переглядати підтримувані файли, завантажувати їх або видаляти непотрібні файли й папки. Для керування файлами має існувати розмова. -- **Черга повідомлень**: надсилання ще одного повідомлення під час роботи ШІ не перериває її. Повідомлення очікує в черзі над полем введення й надсилається після завершення поточного запуску. Елементи черги зберігають ті самі позначки Таблиці, Перегляду, вкладень і вибраних даних, що й поле введення чату; команда **Видалити** вилучає елемент, **...** → **Редагувати повідомлення** повертає його до поля введення, а для текстового елемента також доступна команда **Спрямувати**, яка передає його текст активному запуску без очікування. +- **Черга повідомлень**: надсилання ще одного повідомлення під час роботи ШІ не перериває її. Повідомлення очікує в черзі над полем введення й надсилається після завершення поточного запуску. Елементи черги зберігають ті самі позначки Таблиці, Перегляду, вкладень і вибраних даних, що й поле введення чату; команда **Видалити** вилучає елемент, **...** → **Редагувати повідомлення** повертає його до поля введення, а для текстового елемента також доступна команда **Спрямувати**, яка передає його текст активному запуску без очікування. Якщо хід зупинився на картці, яка чекає на вашу дію (картка авторизації, запитання від ШІ), повідомлення лише з текстом не потрапляє в чергу: картка закривається і позначається як **Пропущено**, а ваше повідомлення одразу переходить у цей хід як наступна інструкція, тож розбиратися з карткою наперед не потрібно. Повідомлення з вкладеннями, як і раніше, потрапляє в чергу. ## Керування чатами diff --git a/uk/basic/ai/app-builder.mdx b/uk/basic/ai/app-builder.mdx index 35369265..aa4497c5 100644 --- a/uk/basic/ai/app-builder.mdx +++ b/uk/basic/ai/app-builder.mdx @@ -36,7 +36,7 @@ App Builder має подвійний інтерфейс для користув Центр керування вашим застосунком. - **Редагування природною мовою**: описуйте зміни, наприклад *«Зроби заголовок синім»* або *«Додай форму надсилання нових Записів»*. - **Автоматична маршрутизація**: ШІ розуміє, про який компонент або сторінку ви говорите, і змінює їх безпосередньо. -- **Інтеграції**: коли для завдання застосунку потрібен доступ до стороннього облікового запису, App Builder може показати в панелі чату картку на кшталт **Підключити Slack**. Натисніть **Підключити**, щоб авторизуватися через OAuth. Натисніть **Пропустити**, щоб скасувати авторизацію; ШІ продовжить виконувати частини завдання, для яких це підключення не потрібне. +- **Запити облікових даних**: коли застосунку під час роботи потрібен доступ до стороннього облікового запису або секрет, App Builder закріплює в панелі чату картку, наприклад **Додаток потребує вашого підключення Slack**. Натисніть **Підключити мій обліковий запис**, щоб пройти OAuth: нове підключення одразу надається цьому застосунку. Якщо придатне підключення чи секрет уже є, достатньо надати його — підключатися заново не потрібно. Кнопка **Пропустити** лишає облікові дані при вас, і ШІ продовжує з тим, що може виконати без них. - **Навички**: відкрийте меню **+** і виберіть **Навички**, щоб керувати навичками для цієї розмови про застосунок. Додана тут навичка доступна лише поточному застосунку; також можна використовувати навички, спільні для Проєкту й Простору застосунку. Введіть `/` у полі введення, щоб вибрати ввімкнену навичку. - **Керування файлами**: відкрийте **+** → **Більше** → **Керування файлами**, щоб переглянути файли в пісочниці застосунку. Тут можна попередньо переглядати підтримувані файли, завантажувати створені файли або видаляти непотрібні файли й папки. - **Очистити розмову**: якщо поточна розмова відхилилася від теми, натисніть **Очистити чат** у нижньому правому куті панелі, щоб розпочати новий сеанс. Це очищує історію чату поточної розмови, але не видаляє сам застосунок. Під час першого використання з’являється підтвердження, яке за бажанням можна більше не показувати. @@ -273,6 +273,15 @@ Teable автоматично відстежує кожне розгортанн className="docs-screenshot" /> +App Builder зберігає зміни кожного ходу як нову версію. Якщо зберегти не вдалося, у чаті зʼявляється картка. + + +Зміни невдалого ходу лишаються тільки в пісочниці: коли пісочницю звільняють, вони втрачаються, а повторна генерація відповіді їх не зберігає. Реагуйте на картку одразу. + + +- **Не вдалося зберегти версію**: цю версію не збережено. Дайте App Builder працювати далі — наступне успішне збереження забере ці зміни із собою. +- **Зміни завеликі для збереження**: цей хід перевищує граничний розмір збереження. Натисніть на картці **Надіслати ШІ**: App Builder пошукає завеликі тестові артефакти, файли налагодження чи вкладення, прибере їх і збереже знову. Такі файли можуть уже бути в незбереженій історії комітів, тож самого лише видалення може бракувати — нехай App Builder упорядкує й історію. + ### Автоматичне виправлення Якщо зміни у власному коді спричинять помилку збірки, розгортання завершиться невдало. - Teable покаже кнопку **Автоматично виправити** поруч із журналом помилок. diff --git a/uk/basic/ai/routine.mdx b/uk/basic/ai/routine.mdx index f0239a9f..7b746c25 100644 --- a/uk/basic/ai/routine.mdx +++ b/uk/basic/ai/routine.mdx @@ -35,7 +35,6 @@ description: Cuppy виконує промпт за розкладом, а ре | Налаштування | Опис | | --- | --- | | **Модель** | Модель і рівень інтелекту, на яких працює ця рутина. Залиште **Модель за замовчуванням**, щоб використати модель чату, задану в просторі | -| **Максимальний час виконання (хвилини)** | Запуск понад цю межу переривається і позначається як невдалий. Від 5 до 120 хвилин, за замовчуванням 30 | | **Чат** | **Новий чат для кожного запуску** лишає запуски незалежними один від одного; **Продовжити чат попереднього запуску** переносить контекст минулих запусків і підходить для роботи, якій потрібен попередній результат | | **Початок** / **Завершення (необов'язково)** | Межі розкладу. Без часу завершення рутина працює безстроково | @@ -74,7 +73,6 @@ description: Cuppy виконує промпт за розкладом, а ре | Повідомлення | Значення | Що робити | | --- | --- | --- | | **Запуск завершився помилкою** | Запуск почався, але натрапив на помилку | Відкрийте чат цього запуску і за місцем збою визначте, справа в промпті чи в даних | -| **Час виконання минув** | Запуск перевищив **Максимальний час виконання** і був перерваний | Збільште **Максимальний час виконання** або розбийте промпт на менші порції роботи | | **Пропущено: недостатньо кредитів** | Кредити скінчилися, запуск не почався | Поповніть кредити простору | | **Пропущено: попередній запуск ще тривав** | Попередній запуск не завершився, тому це спрацювання пропущено | Зменште частоту або скоротіть обсяг роботи одного запуску | | **Пропущено: минув час очікування в черзі** | Запуск задовго чекав у черзі й був пропущений | Поодинокий випадок нічого не потребує; якщо повторюється, на один час заплановано забагато — рознесіть розклади | diff --git a/uk/basic/credential.mdx b/uk/basic/credential.mdx index 57662bae..ad3d322f 100644 --- a/uk/basic/credential.mdx +++ b/uk/basic/credential.mdx @@ -63,14 +63,20 @@ description: Керуйте своїми підключеннями й секр Якщо вставити в поле автоматизації рядок, схожий на ключ, Teable збереже його як ваш секрет і лишить на місці посилання, тож відкритий текст не потрапить до конфігурації робочого процесу. Щоб лишити текст як є, натисніть **Скасувати** в повідомленні. -## Запити облікових даних в AI Chat +## Картки авторизації в AI Chat -Коли ШІ потрібен зовнішній обліковий запис, він закріплює в розмові картку запиту й зазначає, для якого сервісу потрібне підключення або під яким псевдонімом потрібен секрет. Варіанти: +Коли ШІ потрібен зовнішній обліковий запис, він закріплює в розмові картку із заголовком **Для цього завдання потрібна авторизація** і чекає на вашу дію, перш ніж продовжити хід. Карток дві — залежно від того, кому потрібні облікові дані. + +**Картка підключення** зʼявляється, коли самому Cuppy треба прочитати чи записати дані в сервіс, щоб виконати завдання: забрати пошту з Gmail, записати щось у Notion. На картці вказано сервіс; натисніть **Підключити**, щоб пройти OAuth або ввести ключ цього сервісу. Щойно підключення готове, хід триває далі, а саме підключення зберігається в розділі **Мої підключення** в **Налаштуваннях** → **Інтеграції**. І сервіси, які Teable інтегрує сам, і сервіси під керуванням Composio підключаються з цієї картки — заходити в налаштування наперед не потрібно. **Пропустити** — не надавати підключення; ШІ продовжить із тим, що від нього не залежить. Якщо підключитися не вдалося, картка покаже помилку: **Повторити** — спробувати ще раз, **Відмовитися** — завершити запит. + +**Картка запиту облікових даних** зʼявляється, коли застосунку або автоматизації, які ви створюєте, ці дані потрібні під час роботи; вона зазначає, для якого сервісу потрібне підключення або під яким псевдонімом потрібен секрет. Варіанти: - **Підключити мій обліковий запис** — пройти OAuth; нове підключення надається ресурсу автоматично. - **Надати мій…** — використати наявне підключення або секрет. - **Пропустити** — не надавати облікові дані. ШІ продовжить із тим, що від них не залежить. +Якщо надіслати повідомлення, поки картка чекає, вона теж закриється і буде позначена як **Пропущено**, а ваше повідомлення стане наступною інструкцією цього ходу. Коли облікові дані знадобляться знову, попросіть Cuppy надіслати запит ще раз. + ## Заміна, видалення та вихід із простору Перед заміною значення секрету, видаленням секрету чи відключенням підключення Teable перелічує застосунки й автоматизації, які їх ще використовують. Після видалення та відключення ці ресурси одразу перестають працювати, тож спершу надайте їм інші облікові дані, якщо вони мають працювати далі. Попереднє значення секрету відновити неможливо. diff --git a/zh/basic/ai/ai-chat.mdx b/zh/basic/ai/ai-chat.mdx index 26987c37..4aa55d3b 100644 --- a/zh/basic/ai/ai-chat.mdx +++ b/zh/basic/ai/ai-chat.mdx @@ -33,12 +33,12 @@ AI 会优先参考你当前页面中的信息: - **模型**:在模型菜单中选择本次对话使用的模型档位。菜单按能力从高到低列出 **Ultra**、**Smart**、**Standard**、**Lite**,每档标出背后实际使用的模型;管理员可以随时更换某一档背后的模型,也可以只开放其中几档,你不需要重新选择。简单查询、整理、改写选择较低的档位;复杂规划、跨表分析和应用构建选择更高的档位。 - **智能**:在模型菜单中单独选择 **智能** 级别,用于控制 AI 的思考强度;级别越高,推理越深入。 - **我的 Secret**:打开 **+** → **更多** → **我的 Secret**,在 **设置** → **集成** 中保存 API Key 或其他凭证。这些值属于你个人,AI 对话运行时可通过环境变量读取,也可以按需授权给某个应用或自动化使用,详见 [凭据与集成](/zh/basic/credential)。 -- **凭据请求**:当 AI 需要访问第三方账号或某个 Secret 时,会在对话中固定一张凭据请求卡片。可以 **连接我的账号** 走一次 OAuth,或直接授权你已有的凭据;点击 **跳过** 则不提供这份凭据,AI 会在不使用它的情况下继续处理可完成的部分。 +- **授权卡片**:当 AI 需要访问第三方账号或某个 Secret 时,会在对话中固定一张卡片,等你处理后再继续这一轮。Cuppy 需要使用这个账号完成任务时,点击 **连接** 走一次 OAuth;应用或自动化运行时要用这份凭据时,可以 **连接我的账号**,或直接授权你已有的凭据。点击 **跳过** 则不提供这份凭据,AI 会在不使用它的情况下继续处理可完成的部分,详见 [凭据与集成](/zh/basic/credential)。 - **网页抓取**:打开 **+** 菜单,选择 **网页抓取**,按平台和数据类型挑一项。条目分两类:一类贴链接就抓,比如 LinkedIn 的 **个人资料**、Amazon 的 **商品评论**;一类按关键词、话题或姓名去搜,比如 TikTok 的 **视频搜索**、Reddit 的 **板块的帖子**。挑好之后 Teable 会把抓取指令预填到输入框,末尾留出需要你补充的部分。也可以选 **任意网页**,直接粘贴链接抓取。 - **技能**:打开 **+** 菜单,选择 **技能**,可以在当前对话中导入、启用、停用或试用技能。导入时需要选择谁能用这个技能:选 **个人** 只有自己能用,选 **项目** 则当前项目的协作者都能用,选 **空间** 则当前空间的所有成员都能用。在输入框中输入 `/`,可以选择已启用的技能。需要连接或迁移外部系统时,请参阅 [Connect & Migrate Everything](/zh/basic/ai/connect-everything)。 - **上下文用量**:输入框旁的圆环显示当前对话占用了多少模型上下文窗口,点击可查看百分比和 token 数量。上下文接近用满时,Teable 会压缩对话内容;如果希望从干净的上下文开始,可以新建对话。 - **文件管理**:打开 **+** → **更多** → **文件管理**,可以查看当前对话沙箱中的文件。可以预览支持的文件类型、下载文件,也可以删除不再需要的文件或文件夹。需要先开始一段对话,才会有对应文件可管理。 -- **消息队列**:AI 还在工作时继续发消息不会打断它,消息会排进输入框上方的队列,等这一轮结束后一起发出。排队项和输入框一样保留表格、视图、附件和选区标签,可以 **移除**,也可以用 **...** → **编辑消息** 放回输入框;纯文本消息还能点 **调整方向**,不等这一轮结束就把这段话交给它。 +- **消息队列**:AI 还在工作时继续发消息不会打断它,消息会排进输入框上方的队列,等这一轮结束后一起发出。排队项和输入框一样保留表格、视图、附件和选区标签,可以 **移除**,也可以用 **...** → **编辑消息** 放回输入框;纯文本消息还能点 **调整方向**,不等这一轮结束就把这段话交给它。如果这一轮正停在一张等你处理的卡片上(例如授权卡片、AI 的提问),纯文本消息不进队列:卡片会关闭并记为 **已跳过**,你这条消息立即作为下一条指令交给这一轮,不必先处理卡片。带附件的消息仍然进入队列。 ## 管理对话 diff --git a/zh/basic/ai/app-builder.mdx b/zh/basic/ai/app-builder.mdx index c4734774..e3fed708 100644 --- a/zh/basic/ai/app-builder.mdx +++ b/zh/basic/ai/app-builder.mdx @@ -37,7 +37,7 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下, 这是您的应用控制中心。 - **自然语言编辑**:描述您想做的更改,如 *"把标题改成蓝色"* 或 *"添加一个新记录提交表单"*。 - **智能路由**:AI 能够理解您指的是哪个组件或页面,并直接对其进行修改。 -- **集成连接**:当应用任务需要访问第三方账号时,应用构建器会在对话面板中显示类似 **连接 Slack** 的卡片。点击 **连接** 可通过 OAuth 授权;点击 **跳过** 会取消本次授权,AI 会在不使用该连接的情况下继续处理可完成的部分。 +- **凭据请求**:当应用运行时需要访问第三方账号或某个 Secret 时,应用构建器会在对话面板中固定一张卡片,例如 **这个应用需要使用你的 Slack 连接**。点击 **连接我的账号** 走一次 OAuth,连接完成后直接授权给这个应用;已经有可用的连接或 Secret 时,直接授权即可,不必再连一次。点击 **跳过** 则不提供这份凭据,AI 会在不使用它的情况下继续处理可完成的部分。 - **技能**:打开 **+** 菜单,选择 **技能**,可以管理当前应用对话可用的技能。这里添加的 App 技能只在当前应用中可用;应用所属项目和空间中共用的技能,在这里也能直接使用。在输入框中输入 `/`,可以选择已启用的技能。 - **文件管理**:打开 **+** → **更多** → **文件管理**,可以查看当前应用沙箱中的文件,用于预览支持的文件类型、下载生成文件,或删除不再需要的文件和文件夹。 - **清除对话历史**:如果当前对话已经跑偏,可点击面板右下角的 **清除对话**,重新开始一个新的会话。这样会丢失当前对话的历史上下文,但不会删除应用本身。首次使用会弹出确认,并可选择下次不再提示。 @@ -285,6 +285,15 @@ Teable 自动跟踪每一次部署。 className="docs-screenshot" /> +应用构建器每改完一轮,会把这一轮的改动保存为一个新版本。保存失败时,对话中会出现一张提示卡片。 + + +保存失败的这一轮改动只留在沙箱里,沙箱回收后会丢失,重新生成这条回复也不会重新保存。看到提示卡片请及时按下面的方式处理。 + + +- **版本保存失败**:本轮版本未保存。让应用构建器继续修改,下一次保存成功时会把这些改动一并带上。 +- **改动体积过大,无法保存**:本次改动超出保存大小限制。点击卡片上的 **发送给 AI**,应用构建器会排查过大的测试产物、调试文件或附件,清理之后再保存。这类文件可能已经进入尚未保存的提交记录,只删除文件不一定够,需要由应用构建器一并整理。 + ### 自动修复 (Auto-fix) 如果您的自定义代码导致构建错误,部署将会失败。 diff --git a/zh/basic/ai/routine.mdx b/zh/basic/ai/routine.mdx index df480685..0a7221ba 100644 --- a/zh/basic/ai/routine.mdx +++ b/zh/basic/ai/routine.mdx @@ -35,7 +35,6 @@ description: 让 Cuppy 按计划自动运行一段提示词,并在运行历史 | 配置项 | 说明 | | --- | --- | | **模型** | 本例行任务使用的模型和智能级别。保持 **默认模型** 时使用空间的默认对话模型 | -| **最长执行时间(分钟)** | 超过该时长的运行会被终止并记为失败。范围 5–120 分钟,默认 30 | | **对话** | **每次运行新开对话** 让每次运行互不影响;**延续上一次运行的对话** 会带上历次运行的上下文,适合需要参考上次结果的任务 | | **生效开始** / **生效结束(可选)** | 计划的起止时间。不设置结束时间时会一直运行下去 | @@ -74,7 +73,6 @@ description: 让 Cuppy 按计划自动运行一段提示词,并在运行历史 | 提示 | 含义 | 该怎么办 | | --- | --- | --- | | **运行失败** | 本次运行已开始但执行出错 | 展开这次运行的对话,从出错位置判断是提示词问题还是数据问题 | -| **运行超时** | 超过 **最长执行时间**,运行被终止 | 调大 **最长执行时间**,或把提示词拆成处理量更小的任务 | | **已跳过:credit 不足** | 算力不足,本次未运行 | 补充空间算力 | | **已跳过:上一次运行尚未结束** | 上一次运行仍在进行,本次计划时间被跳过 | 降低运行频率,或缩短单次运行的处理量 | | **已跳过:排队等待超时** | 在队列中等待过久,本次计划时间被跳过 | 偶发可不处理;持续出现说明同一时间的任务过于集中,建议错开运行计划 | diff --git a/zh/basic/credential.mdx b/zh/basic/credential.mdx index f412c64e..bcdd3899 100644 --- a/zh/basic/credential.mdx +++ b/zh/basic/credential.mdx @@ -63,14 +63,20 @@ description: 管理你的连接和 Secret,并把它们授权给应用和自动 在自动化输入框里粘贴一段疑似密钥的内容时,Teable 会自动把它存成你的 Secret,原处留下引用,明文不会留在工作流配置里。不需要这样处理时,点击提示里的 **撤销**。 -## AI 对话中的凭据请求 +## AI 对话中的授权卡片 -AI 需要用到某个外部账号时,会在对话中固定一张凭据请求卡片,说明它要的是哪个服务的连接,还是哪个别名的 Secret。可以选择: +AI 需要用到某个外部账号时,会在对话中固定一张标题为 **此任务需要授权** 的卡片,等你处理后再继续这一轮。按谁要用这份凭据分两种。 + +**连接卡片**:Cuppy 自己要读写某个服务才能完成这次任务时出现,例如从 Gmail 取邮件、写入 Notion。卡片上是这个服务的名称,点击 **连接** 走一次 OAuth 或填写该服务的密钥,连接完成后当前这一轮继续,连接也会保存在 **设置** → **集成** 的 **我的连接** 中。Teable 自己对接的服务和由 Composio 托管的服务都从这张卡片连接,不需要先去设置页。点击 **跳过** 则不连接,Cuppy 会继续处理不依赖它的部分。连接失败时卡片会给出错误信息,点击 **重试** 再连一次,或点击 **放弃** 结束这次请求。 + +**凭据请求卡片**:你正在构建的应用或自动化运行时需要这份凭据时出现,说明它要的是哪个服务的连接,还是哪个别名的 Secret。可以选择: - **连接我的账号**:走一次 OAuth,连接完成后自动授权给当前资源。 - **授权我的 xxx**:直接使用你已有的连接或 Secret。 - **跳过**:不提供这份凭据,AI 会继续处理不依赖它的部分。 +卡片等待期间直接在输入框发消息,也会关掉卡片并记为 **已跳过**,你这条消息成为这一轮接下来的指令;之后仍需要这份凭据时,再让 Cuppy 提出请求即可。 + ## 更换值、删除和退出空间 更换 Secret 的值、删除 Secret 或断开连接前,Teable 会列出仍在使用它的应用和自动化。删除和断开之后这些资源会立刻失效,要让它们继续运行,得先在资源里换成别的凭据。旧的 Secret 值不可恢复。