i18n - docs translations (#22122)
Created by Github action <!-- This is an auto-generated description by cubic. --> <a href="https://cubic.dev/pr/twentyhq/twenty/pull/22122?utm_source=github" target="_blank" rel="noopener noreferrer" data-no-image-dialog="true"><picture><source media="(prefers-color-scheme: dark)" srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img alt="Review in cubic" src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a> <!-- End of auto-generated description by cubic. --> Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
33d2441a93
commit
fdea2d6e1e
@@ -261,6 +261,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
المعرّف هو `universalIdentifier` الخاص بالـ resolver من ملف manifest لديك. سجّل عنوان URL هذا لدى المزوّد.
|
||||
|
||||
<Note>
|
||||
**يجب أن يتم المطالبة بالتطبيق وتثبيته في مساحة عمل المالك الخاصة به.** نظرًا لأن محلِّل الاستدعاء يعمل في **مساحة عمل المالك** (مساحة العمل التي تمتلك تسجيل التطبيق)، فإن مشغّل مسار الخادم يعمل فقط بمجرد أن يكون قد تم *المطالبة* بالتطبيق — أي أصبح لديه مساحة عمل مالكة — **و** تم **تثبيت هذا التطبيق في مساحة عمل المالك**. إلى أن يتحقق الشرطان معًا، فلن يكون لدى محلِّل الاستدعاء مكان يعمل فيه، وبالتالي لا يمكن إرسال المسار. لذلك لا يمكن إدراج أي تطبيق يعرِّض دالة منطقية `serverRouteTriggerSettings` في السوق حتى تتم المطالبة به وتثبيته في مساحة عمل المالك الخاصة به.
|
||||
</Note>
|
||||
|
||||
**عقد الـ Resolver.** يفرض نوع `LogicFunctionConfig` في حزمة SDK هذا في وقت الترجمة: بمجرد تعيينك لـ `serverRouteTriggerSettings`، يُقيَّد الـ handler الخاص بك بأن يُرجِع `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (أو `Promise` من هذا الكائن). يجب أن يكون `workspaceId` لمساحة عمل تكون الدالة المستهدفة مثبّتة فيها، وإلا فسيتم رفض الطلب مع `404`.
|
||||
|
||||
| الحقل | النوع | الملاحظات |
|
||||
@@ -653,7 +657,7 @@ console.log(uploadedFile);
|
||||
| `fileBuffer` | `Buffer` | المحتوى الخام للملف |
|
||||
| `filename` | `string` | اسم الملف (يُستخدم للتخزين والعرض) |
|
||||
| `contentType` | `سلسلة نصية` | نوع MIME (القيمة الافتراضية `application/octet-stream` إذا لم يُحدَّد) |
|
||||
| `fieldMetadataUniversalIdentifier` | `سلسلة نصية` | قيمة `universalIdentifier` لحقل نوع الملف في كائنك |
|
||||
| `fieldMetadataUniversalIdentifier` | `string` | قيمة `universalIdentifier` لحقل نوع الملف في كائنك |
|
||||
|
||||
النقاط الرئيسية:
|
||||
* يستخدم `universalIdentifier` الخاص بالحقل (وليس معرّفه الخاص بمساحة العمل)، بحيث يعمل كود الرفع لديك عبر أي مساحة عمل مُثبَّت فيها تطبيقك.
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: الشكر والتقدير
|
||||
description: فهم كيف تشغّل الأرصدة سير العمل ووكلاء الذكاء الاصطناعي وروبوت الدردشة بالذكاء الاصطناعي — وكيفية إدارة رصيدك.
|
||||
description: رصيد بسيط واحد يشغّل سير العمل لديك، ووكلاء الذكاء الاصطناعي، ودردشة الذكاء الاصطناعي — ما قيمة الرصيد، إلى أي مدى يمتد، وكيفية إدارته.
|
||||
---
|
||||
|
||||
## نظرة عامة
|
||||
## ما هي الأرصدة؟
|
||||
|
||||
الأرصدة تدعم أتمتة سير العمل وإمكانات الذكاء الاصطناعي. يتم استهلاكها عند تنفيذ إجراءات سير العمل، وعندما يعالج وكلاء الذكاء الاصطناعي المهام داخل سير العمل، وداخل دردشة الذكاء الاصطناعي.
|
||||
الأرصدة عبارة عن رصيد واحد يشغّل كل ما نقوم بتشغيله نيابةً عنك وله تكلفة فعلية: **أتمتة سير العمل**، و**وكلاء الذكاء الاصطناعي**، و**دردشة الذكاء الاصطناعي**. بدلًا من التعامل مع حصص منفصلة لـ "مرات تشغيل الأتمتة" و"رموز الذكاء الاصطناعي"، سيكون لديك رصيد واحد وبسيط لمتابعته.
|
||||
|
||||
## تخصيص الأرصدة
|
||||
**1 رصيد = 1 دولار من الاستخدام.** الرصيد هو مجرد دولار من العمل، لذا سيكون من السهل فهم رصيدك — دون أي وحدات مجرّدة تحتاج إلى تحويل.
|
||||
|
||||
تستند الأرصدة إلى دورة الفوترة لديك، وليس إلى خطتك:
|
||||
## ما مدى كفاية الرصيد الواحد؟
|
||||
|
||||
| دورة الفوترة | الأرصدة |
|
||||
| ------------ | ------- |
|
||||
| شهري | 5/شهر |
|
||||
| سنوي | 50/سنة |
|
||||
التكلفة تتناسب مع حجم العمل. أتمتة المهام اليومية والرسائل السريعة للذكاء الاصطناعي تكلف جزءًا صغيرًا جدًا من الرصيد؛ بينما تكلف مهام وكلاء الذكاء الاصطناعي الكبيرة ومتعددة الخطوات أكثر. إليك صورة تقريبية:
|
||||
|
||||
| ماذا تفعل | التكلفة التقريبية | ماذا يعني ذلك |
|
||||
| --------------------------------------------------------------------- | --------------------------------------- | ------------------------------ |
|
||||
| تشغيل خطوة سير عمل قياسية (بحث، إنشاء، تحديث السجلات) | ~$0.0001 | حوالي **10,000 خطوة لكل رصيد** |
|
||||
| استدعاء واجهة برمجة تطبيقات خارجية أو تشغيل عقدة كود | جزء صغير من رصيد واحد | آلاف لكل رصيد |
|
||||
| إرسال رسالة محادثة سريعة بالذكاء الاصطناعي أو خطوة ذكاء اصطناعي بسيطة | جزء من سنت | مئات لكل رصيد |
|
||||
| تشغيل مهمة كبيرة لوكيل ذكاء اصطناعي (مثل "تهيئة 10 كائنات مساحة عمل") | قد تصل تكلفتها إلى **حوالي $1 أو أكثر** | عدد قليل لكل رصيد |
|
||||
| تشغيل بحث ويب بالذكاء الاصطناعي | تكلفة ثابتة لكل عملية بحث | مئات عمليات البحث لكل رصيد |
|
||||
|
||||
<Note>
|
||||
تم تصميم الأرصدة الشهرية الخمسة لتمكينك من تشغيل الأتمتة دون القلق بشأن التكاليف. بالنسبة إلى معظم مسارات العمل التي تستخدم الإجراءات القياسية، فهذا أكثر من كافٍ. ستحتاج إلى أرصدة إضافية فقط عند تشغيل عقد برمجية متقدمة أو ميزات مدعومة بالذكاء الاصطناعي.
|
||||
بالنسبة لمعظم الفرق، تكون الأتمتة القياسية مجانية فعليًا — فلن تلاحظ انخفاضًا ملموسًا في رصيدك إلا عندما تعتمد على ميزات الذكاء الاصطناعي أو تشغّل عقد كود ثقيلة. وهذا مقصود: صُمِّمت الأرصدة المضمّنة لتمكّنك من البناء دون الحاجة إلى مراقبة عدّاد.
|
||||
</Note>
|
||||
|
||||
## كيفية احتساب استخدام الذكاء الاصطناعي
|
||||
|
||||
عندما تستدعي أي إجراء نموذج ذكاء اصطناعي، نقيس عدد الرموز المستخدمة بدقة ونحتسبها وفق **الأسعار المنشورة من مزود النموذج**، ثم نحول مبلغ الدولار الناتج مباشرة إلى أرصدة — بحيث يعكس إنفاقك التكلفة الحقيقية للعمل، وليس سعرًا داخليًا معادًا تسعيره. رسالة محادثة قصيرة تكلف جزءًا من سنت. مهمة كبيرة لوكيل — مثل تهيئة عشرة كائنات مساحة عمل — تتضمن العديد من استدعاءات النماذج على سياق متزايد، لذا يمكن أن تصل تكلفتها إلى دولار واحد أو أكثر. يتم احتساب الرسوم بناءً على ما تستخدمه فعليًا، حتى على مستوى الرمز الواحد.
|
||||
|
||||
تختلف التكلفة حسب النموذج: فالنموذج خفيف الوزن أرخص بكثير لكل رسالة من نموذج الاستدلال المتقدم من أعلى الفئة. يمكنك رؤية تفاصيل التكلفة لكل إجراء — بما في ذلك أي نموذج تم استخدامه — في **الإعدادات → الفوترة**.
|
||||
|
||||
## ما الذي يتضمّنه
|
||||
|
||||
يتضمّن كل اشتراك أرصدة، وتختلف الكمية حسب **دورة الفوترة** الخاصة بك، وليس حسب خطتك:
|
||||
|
||||
| دورة الفوترة | الأرصدة المضمّنة | استخدام مكافئ |
|
||||
| ------------ | ---------------- | ------------------------- |
|
||||
| شهري | 5 / شهر | استخدام بقيمة ~$5 كل شهر |
|
||||
| سنوي | 50 / سنة | استخدام بقيمة ~$50 كل سنة |
|
||||
|
||||
هذه الأرصدة مصممة لتغطية الأتمتة اليومية براحة. خمسة أرصدة تغطي عشرات الآلاف من خطوات الأتمتة القياسية أو مئات من رسائل الذكاء الاصطناعي السريعة — مع أن عددًا قليلاً من مهام الوكلاء الكبيرة ومتعددة الخطوات يمكن أن يستهلكها بسرعة أكبر. يمكنك إضافة رصيد في أي وقت (انظر أدناه).
|
||||
|
||||
## ترحيل الأرصدة
|
||||
|
||||
تُرحَّل الأرصدة غير المستخدمة في نهاية فترة الفوترة تلقائيًا إلى الفترة التالية.
|
||||
يتم ترحيل الأرصدة غير المستخدمة تلقائيًا إلى فترة الفوترة التالية.
|
||||
|
||||
* **الحد الأقصى**: يتم تحديد مقدار الترحيل بسقف يعادل التخصيص الكامل لفترة واحدة، لذا لا يمكنك أبدًا ترحيل أرصدة أكثر مما توفره خطتك لكل فترة.
|
||||
* **الحد الأقصى**: يتم تحديد مقدار الترحيل بسقف يعادل التخصيص الكامل لفترة واحدة، لذا لا يمكنك أبدًا ترحيل أرصدة أكثر مما توفّره خطتك لكل فترة.
|
||||
* **الظهور**: عند توفّر أرصدة مُرحّلة، تظهر كبند منفصل بعنوان **الأرصدة المُرحّلة** في **الإعدادات → الفوترة**، إلى جانب رصيد **الإجمالي المتاح**.
|
||||
|
||||
## استهلاك الأرصدة
|
||||
|
||||
تستهلك الإجراءات المختلفة كميات مختلفة من الأرصدة:
|
||||
|
||||
| نوع الإجراء | استخدام الأرصدة |
|
||||
| ----------------------------------------------------- | ---------------------- |
|
||||
| **العمليات الأساسية** (البحث، التحديث، إنشاء السجلات) | ضئيل |
|
||||
| **عمليات معقدة** (عُقَد برمجية، استدعاءات API خارجية) | مزيد من الأرصدة |
|
||||
| **موجّه الذكاء الاصطناعي ودردشات الذكاء الاصطناعي** | متغيِّرة حسب الاستخدام |
|
||||
|
||||
يتم خصم الأرصدة فورًا عند تنفيذ سير العمل.
|
||||
|
||||
## مراقبة الاستخدام
|
||||
|
||||
تتبَّع استهلاكك من الأرصدة:
|
||||
تابع رصيدك وأين يتم استهلاكه:
|
||||
|
||||
1. اذهب إلى **الإعدادات → الفواتير**
|
||||
2. اعرض استخدامك الحالي والأرصدة المتبقية
|
||||
3. راقِب الاتجاهات للتخطيط للحصول على أرصدة إضافية إذا لزم الأمر
|
||||
2. اطّلع على **الأرصدة المتبقية** و**الاستخدام خلال الفترة الحالية**
|
||||
3. تعمّق في التفاصيل لترى أي سير عمل وإجراءات ذكاء اصطناعي تستهلك الأرصدة — وأي النماذج استخدمتها إجراءات الذكاء الاصطناعي
|
||||
|
||||
## شراء أرصدة إضافية
|
||||
مراجعة هذا بانتظام تسهّل عليك اكتشاف سير عمل كثيف مبكرًا واتخاذ قرار بشأن تحسينه أو إضافة رصيد.
|
||||
|
||||
هل تحتاج إلى المزيد من الأرصدة؟
|
||||
## هل تحتاج إلى المزيد من الأرصدة؟
|
||||
|
||||
إذا نفد رصيدك — أو أردت هامش أمان قبل دفعة أتمتة كبيرة — يمكنك شراء حزم أرصدة إضافية في أي وقت:
|
||||
|
||||
1. اذهب إلى **الإعدادات → الفواتير**
|
||||
2. انقر على الخيار لشراء حزم أرصدة إضافية
|
||||
2. اختر **شراء أرصدة إضافية**
|
||||
3. اختر الكمية التي تحتاج إليها
|
||||
|
||||
تُضاف الأرصدة المشتراة إلى رصيدك المتاح فورًا.
|
||||
|
||||
@@ -262,6 +262,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
Identifikátor je `universalIdentifier` resolveru z vašeho manifestu. Zaregistrujte tuto adresu URL u poskytovatele.
|
||||
|
||||
<Note>
|
||||
**Aplikace musí být převzata do vlastnictví a nainstalována v pracovním prostoru vlastníka.** Protože resolver běží v **pracovním prostoru vlastníka** (pracovní prostor, který vlastní registraci aplikace), spouštěč serverové trasy funguje pouze tehdy, když byla aplikace *převzata do vlastnictví* — tj. má pracovní prostor vlastníka — **a** tato aplikace je **nainstalována v pracovním prostoru vlastníka**. Dokud nejsou obě podmínky splněny, resolver nemá kde běžet, takže trasu nelze zpracovat. Aplikace, která zpřístupňuje logickou funkci `serverRouteTriggerSettings`, proto nemůže být uvedena na Marketplace, dokud není převzata do vlastnictví a nainstalována v pracovním prostoru vlastníka.
|
||||
</Note>
|
||||
|
||||
**Smlouva resolveru.** Typ `LogicFunctionConfig` v SDK toto vynucuje v době kompilace: jakmile nastavíte `serverRouteTriggerSettings`, váš handler je omezen tak, aby vracel `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (nebo `Promise` této hodnoty). `workspaceId` musí být workspace, ve kterém je cílová funkce nainstalována, jinak je request odmítnut s chybou `404`.
|
||||
|
||||
| Pole | Typ | Poznámky |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Kredity
|
||||
description: Pochopení, jak kredity pohánějí pracovní postupy, AI agenty a AI chatbot — a jak spravovat svůj zůstatek.
|
||||
description: Jeden jednoduchý kreditní zůstatek, který pohání vaše pracovní postupy, AI agenty a AI chat – jakou má jeden kredit hodnotu, na co vystačí a jak ho spravovat.
|
||||
---
|
||||
|
||||
## Přehled
|
||||
## Co jsou kredity?
|
||||
|
||||
Kredity pohánějí automatizace pracovních postupů a funkce AI. Spotřebovávají se při provádění akcí pracovních postupů, když AI agenti zpracovávají úlohy v rámci pracovních postupů a v AI chatu.
|
||||
Kredity jsou jeden společný zůstatek, který pokrývá vše, co za vás provozujeme a co má skutečné náklady: **automatizace pracovních postupů**, **AI agenty** a **AI chat**. Místo žonglování se samostatnými kvótami pro "běhy automatizace" a "AI tokeny" máte jeden jednoduchý zůstatek, který stačí sledovat.
|
||||
|
||||
## Přidělení kreditů
|
||||
**1 kredit = 1 $ za využití.** Kredit je jen dolar práce, takže je snadné pochopit váš zůstatek – žádné abstraktní jednotky k převodu.
|
||||
|
||||
Kredity se odvíjejí od vašeho fakturačního cyklu, nikoli od plánu:
|
||||
## Jak daleko vystačí jeden kredit?
|
||||
|
||||
| Fakturační cyklus | Kredity |
|
||||
| ----------------- | ------- |
|
||||
| Měsíční | 5/měsíc |
|
||||
| Roční | 50/rok |
|
||||
Náklady se škálují podle vykonané práce. Běžné automatizace a rychlé AI zprávy stojí zlomkovou část kreditu; velké, vícekrokové úlohy AI agentů stojí více. Přibližně to vypadá takto:
|
||||
|
||||
| Co děláte | Přibližná cena | Co to znamená |
|
||||
| ------------------------------------------------------------------------------------------ | --------------------------------- | ------------------------------------------ |
|
||||
| Spuštění standardního kroku pracovního postupu (vyhledání, vytvoření, aktualizace záznamů) | ~$0.0001 | Přibližně **10 000 kroků na jeden kredit** |
|
||||
| Zavolání externího API nebo spuštění uzlu s kódem | Malý zlomek kreditu | Tisíce na jeden kredit |
|
||||
| Odeslání rychlé AI chatové zprávy nebo jednoduchého AI kroku | Zlomek centu | Stovky na jeden kredit |
|
||||
| Spuštění velké úlohy AI agenta (např. „konfigurovat 10 objektů pracovního prostoru“) | Může stát **~$1 nebo více** | Několik na jeden kredit |
|
||||
| Spuštění AI webového vyhledávání | Fixní náklad za jedno vyhledávání | Stovky vyhledávání na jeden kredit |
|
||||
|
||||
<Note>
|
||||
Těch 5 měsíčních kreditů je navrženo tak, aby vám umožnilo spouštět automatizace bez obav o náklady. Pro většinu pracovních postupů využívajících standardní akce je to více než dostačující. Další kredity budete potřebovat pouze při spouštění pokročilých uzlů kódu nebo funkcí poháněných AI.
|
||||
Pro většinu týmů jsou standardní automatizace v podstatě zdarma — znatelnější zásah do zůstatku zaznamenáte až tehdy, když se opřete o AI funkce nebo spustíte náročné uzly s kódem. Je to tak záměrně: zahrnuté kredity jsou navržené tak, abyste mohli tvořit, aniž byste museli sledovat „taxametr“.
|
||||
</Note>
|
||||
|
||||
## Jak se měří využití AI
|
||||
|
||||
Když akce zavolá AI model, změříme přesný počet použitých tokenů a naceníme je podle **publikovaných sazeb poskytovatele modelu**, poté tuto částku v dolarech přímo převedeme na kredity — takže vaše útrata odpovídá skutečným nákladům na práci, ne navýšené interní sazbě. Krátká chatová zpráva stojí zlomek centu. Velká úloha agenta — například konfigurace deseti objektů pracovního prostoru — provede mnoho volání modelu nad rostoucím kontextem, takže se může nasčítat na jeden dolar nebo více. Platíte za to, co skutečně využijete, až na úroveň jednotlivých tokenů.
|
||||
|
||||
Náklady se liší podle modelu: lehký model je dramaticky levnější za zprávu než špičkový reasoning model. Rozpis podle akcí — včetně informace, který model byl použit — najdete v **Nastavení → Fakturace**.
|
||||
|
||||
## Co je součástí
|
||||
|
||||
Každé předplatné obsahuje kredity a jejich množství závisí na vaší **fakturační periodě**, ne na tarifu:
|
||||
|
||||
| Fakturační cyklus | Zahrnuté kredity | Ekvivalentní využití |
|
||||
| ----------------- | ---------------- | -------------------- |
|
||||
| Měsíční | 5 / měsíc | ~$5 využití měsíčně |
|
||||
| Roční | 50 / rok | ~$50 využití ročně |
|
||||
|
||||
Tyto kredity jsou navržené tak, aby pohodlně pokryly každodenní automatizaci. Pět kreditů pokryje desítky tisíc standardních automatizačních kroků nebo stovky rychlých AI zpráv — i když několik velkých, vícekrokových úloh agentů je může spotřebovat rychleji. Kredity si můžete kdykoli dobít (viz níže).
|
||||
|
||||
## Převod kreditů
|
||||
|
||||
Nepoužité kredity na konci fakturačního období jsou automaticky převedeny do dalšího období.
|
||||
Nevyužité kredity se automaticky převádějí do dalšího fakturačního období.
|
||||
|
||||
* **Limit**: Částka převodu je omezena na plnou kvótu jednoho období, takže nikdy nemůžete převést více kreditů, než váš tarif poskytuje za období.
|
||||
* **Viditelnost**: Když jsou k dispozici převedené kredity, zobrazí se jako samostatný řádek **Převedené kredity** v **Nastavení → Fakturace**, vedle zůstatku **Celkem k dispozici**.
|
||||
|
||||
## Spotřeba kreditů
|
||||
|
||||
Různé akce spotřebovávají různá množství kreditů:
|
||||
|
||||
| Typ akce | Využití kreditů |
|
||||
| ------------------------------------------------------------------ | ------------------------ |
|
||||
| **Základní operace** (vyhledávání, aktualizace, vytváření záznamů) | Minimální |
|
||||
| **Komplexní operace** (uzly kódu, volání externího API) | Více kreditů |
|
||||
| **AI prompty & AI chaty** | Proměnlivé podle využití |
|
||||
|
||||
Kredity jsou odečítány v reálném čase, když se pracovní postupy provádějí.
|
||||
* **Limit**: Převod je omezený na plnou kvótu jednoho období, takže nikdy nemůžete převést více kreditů, než váš tarif poskytuje za období.
|
||||
* **Viditelnost**: Když máte převedené kredity, zobrazí se jako samostatný řádek **Převedené kredity** v **Nastavení → Fakturace**, vedle zůstatku **Celkem k dispozici**.
|
||||
|
||||
## Sledování využití
|
||||
|
||||
Sledujte svou spotřebu kreditů:
|
||||
Sledujte svůj zůstatek a jeho využití:
|
||||
|
||||
1. Přejděte na **Nastavení → Fakturace**
|
||||
2. Zobrazte si své aktuální využití a zbývající kredity
|
||||
3. Sledujte trendy, abyste v případě potřeby naplánovali pořízení dalších kreditů
|
||||
2. Podívejte se na své **zbývající kredity** a **využití za aktuální období**
|
||||
3. Podívejte se do podrobného rozpisu, abyste viděli, které pracovní postupy a akce AI spotřebovávají kredity — a které modely akce AI použily
|
||||
|
||||
## Nákup dalších kreditů
|
||||
Pravidelná kontrola vám usnadní včas odhalit náročný pracovní postup a rozhodnout se, zda jej optimalizovat, nebo kredity dobít.
|
||||
|
||||
Potřebujete více kreditů?
|
||||
## Potřebujete více kreditů?
|
||||
|
||||
Pokud vám kredity dojdou — nebo chcete mít rezervu před velkou vlnou automatizace — můžete si kdykoli dokoupit další balíčky kreditů:
|
||||
|
||||
1. Přejděte na **Nastavení → Fakturace**
|
||||
2. Klikněte na možnost koupit další balíčky kreditů
|
||||
2. Zvolte možnost **zakoupit další kredity**
|
||||
3. Vyberte množství, které potřebujete
|
||||
|
||||
Zakoupené kredity se okamžitě přičtou k vašemu dostupnému zůstatku.
|
||||
|
||||
@@ -261,6 +261,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
Der Bezeichner ist der `universalIdentifier` des Resolvers aus deinem Manifest. Registriere diese URL beim Provider.
|
||||
|
||||
<Note>
|
||||
**Die Anwendung muss beansprucht und im Arbeitsbereich ihres Besitzers installiert werden.** Da der Resolver im **Owner-Arbeitsbereich** ausgeführt wird (dem Arbeitsbereich, der die Anwendungsregistrierung besitzt), funktioniert ein Server-Route-Trigger nur, wenn die Anwendung *beansprucht* wurde – d. h. sie einen Owner-Arbeitsbereich hat – **und** diese Anwendung **im Owner-Arbeitsbereich installiert ist**. Solange beides nicht zutrifft, hat der Resolver keinen Ausführungsort, sodass die Route nicht ausgeführt werden kann. Eine Anwendung, die eine `serverRouteTriggerSettings`-Logikfunktion bereitstellt, kann daher nicht im Marketplace aufgeführt werden, bevor sie beansprucht und im Owner-Arbeitsbereich installiert wurde.
|
||||
</Note>
|
||||
|
||||
**Resolver-Vertrag.** Der `LogicFunctionConfig`-Typ des SDK erzwingt dies zur Compile-Zeit: Sobald du `serverRouteTriggerSettings` setzt, ist dein Handler darauf beschränkt, `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (oder ein `Promise` davon) zurückzugeben. Die `workspaceId` muss auf einen Workspace verweisen, in dem die Zielfunktion installiert ist, andernfalls wird die Anfrage mit `404` abgelehnt.
|
||||
|
||||
| Feld | Typ | Notizen |
|
||||
@@ -653,7 +657,7 @@ console.log(uploadedFile);
|
||||
| `fileBuffer` | `Buffer` | Der Rohinhalt der Datei |
|
||||
| `filename` | `string` | Der Name der Datei (wird für Speicherung und Anzeige verwendet) |
|
||||
| `contentType` | `Zeichenkette` | MIME-Typ (standardmäßig `application/octet-stream`, wenn weggelassen) |
|
||||
| `fieldMetadataUniversalIdentifier` | `Zeichenkette` | Der `universalIdentifier` des Dateityp-Felds in Ihrem Objekt |
|
||||
| `fieldMetadataUniversalIdentifier` | `string` | Der `universalIdentifier` des Dateityp-Felds in Ihrem Objekt |
|
||||
|
||||
Hauptpunkte:
|
||||
* Sie verwendet den `universalIdentifier` des Feldes (nicht dessen arbeitsbereichsspezifische ID), sodass Ihr Upload-Code in jedem Arbeitsbereich funktioniert, in dem Ihre App installiert ist.
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Guthaben
|
||||
description: Verstehen, wie Guthaben Workflows, KI-Agenten und den KI-Chatbot antreiben — und wie Sie Ihr Guthaben verwalten.
|
||||
description: Ein einfaches Guthaben, das Ihre Workflows, KI-Agenten und den KI-Chat antreibt – welchen Wert ein Guthaben hat, wie weit es reicht und wie Sie es verwalten.
|
||||
---
|
||||
|
||||
## Übersicht
|
||||
## Was ist Guthaben?
|
||||
|
||||
Guthaben ermöglichen Workflow-Automatisierungen und KI-Funktionen. Sie werden verbraucht, wenn Workflow-Aktionen ausgeführt werden, wenn KI-Agenten Aufgaben innerhalb von Workflows verarbeiten und wenn der KI-Chat verwendet wird.
|
||||
Guthaben ist ein einheitlicher Saldo, der alles antreibt, was wir in Ihrem Namen ausführen und das reale Kosten verursacht: **Workflow-Automatisierungen**, **KI-Agenten** und der **KI-Chat**. Anstatt getrennte Kontingente für "Automatisierungsläufe" und "KI-Tokens" zu jonglieren, behalten Sie einfach einen einzigen, übersichtlichen Guthabensaldo im Blick.
|
||||
|
||||
## Guthabenverteilung
|
||||
**1 Guthaben = 1 $ Nutzung.** Ein Guthaben entspricht einem Dollar an Arbeit, sodass Ihr Guthabenstand leicht nachvollziehbar ist – keine abstrakten Einheiten, die umgerechnet werden müssen.
|
||||
|
||||
Guthaben richten sich nach Ihrem Abrechnungszeitraum, nicht nach Ihrem Tarif:
|
||||
## Wie weit reicht ein Guthaben?
|
||||
|
||||
| Abrechnungszeitraum | Guthaben |
|
||||
| ------------------- | -------- |
|
||||
| Monatlich | 5/Monat |
|
||||
| Jährlich | 50/Jahr |
|
||||
Die Kosten steigen mit dem Aufwand. Alltägliche Automatisierungen und schnelle KI-Nachrichten kosten nur einen winzigen Bruchteil eines Guthabens; große, mehrstufige Aufgaben von KI-Agenten kosten mehr. Ungefähr sieht es so aus:
|
||||
|
||||
| Was Sie tun | Kostet ungefähr | Was das bedeutet |
|
||||
| ---------------------------------------------------------------------------------------- | ----------------------------------------- | ----------------------------------------- |
|
||||
| Einen Standard-Workflow-Schritt ausführen (suchen, Datensätze erstellen, aktualisieren) | ~$0.0001 | Ungefähr **10.000 Schritte pro Guthaben** |
|
||||
| Eine externe API aufrufen oder einen Code-Knoten ausführen | Ein kleiner Bruchteil eines Guthabens | Tausende pro Guthaben |
|
||||
| Eine schnelle KI-Chat-Nachricht senden oder einen einfachen KI-Schritt ausführen | Ein Bruchteil eines Cents | Hunderte pro Guthaben |
|
||||
| Eine große KI-Agentenaufgabe ausführen (z. B. "10 Arbeitsbereichsobjekte konfigurieren") | Kann sich auf **~1 $ oder mehr** belaufen | Einige pro Guthaben |
|
||||
| Eine KI-Websuche ausführen | Ein fester Preis pro Suche | Hunderte Suchvorgänge pro Guthaben |
|
||||
|
||||
<Note>
|
||||
Die 5 monatlichen Guthaben sind dafür gedacht, dass Sie Automatisierungen ausführen können, ohne sich um Kosten zu kümmern. Für die meisten Workflows mit Standardaktionen ist das mehr als ausreichend. Zusätzliches Guthaben benötigen Sie nur bei der Ausführung fortgeschrittener Code-Knoten oder KI-gestützter Funktionen.
|
||||
Für die meisten Teams sind Standardautomatisierungen praktisch kostenlos – eine spürbare Auswirkung auf Ihr Guthaben bemerken Sie erst, wenn Sie sich stark auf KI-Funktionen stützen oder rechenintensive Code-Knoten ausführen. Das ist so beabsichtigt: Das enthaltene Guthaben soll es Ihnen ermöglichen, zu arbeiten, ohne ständig auf einen Zähler achten zu müssen.
|
||||
</Note>
|
||||
|
||||
## Wie KI-Nutzung gemessen wird
|
||||
|
||||
Wenn eine Aktion ein KI-Modell aufruft, messen wir die tatsächlich verwendeten Tokens und berechnen sie zu **den veröffentlichten Preisen des Modellanbieters**. Anschließend wandeln wir diesen Dollarbetrag direkt in Credits um – sodass Ihre Ausgaben den tatsächlichen Kosten der Arbeit folgen und nicht einem intern aufgeschlagenen Tarif. Eine kurze Chat-Nachricht kostet einen Bruchteil eines Cents. Eine große KI-Agentenaufgabe – etwa das Konfigurieren von zehn Arbeitsbereichsobjekten – umfasst viele Modellaufrufe über einen wachsenden Kontext hinweg und kann sich daher auf einen Dollar oder mehr summieren. Sie zahlen nur für das, was Sie tatsächlich nutzen – bis hinunter auf Token-Ebene.
|
||||
|
||||
Die Kosten variieren je nach Modell: Ein leichtgewichtiges Modell ist pro Nachricht deutlich günstiger als ein erstklassiges Reasoning-Modell. In **Einstellungen → Abrechnung** sehen Sie die Aufschlüsselung pro Aktion – einschließlich des jeweils verwendeten Modells.
|
||||
|
||||
## Was enthalten ist
|
||||
|
||||
Jedes Abonnement enthält Guthaben, und die Menge hängt von Ihrem **Abrechnungszeitraum** ab, nicht von Ihrem Tarif:
|
||||
|
||||
| Abrechnungszeitraum | Enthaltenes Guthaben | Entsprechende Nutzung |
|
||||
| ------------------- | -------------------- | --------------------- |
|
||||
| Monatlich | 5 / Monat | ~$5 Nutzung pro Monat |
|
||||
| Jährlich | 50 / Jahr | ~$50 Nutzung pro Jahr |
|
||||
|
||||
Dieses Guthaben ist so ausgelegt, dass es alltägliche Automatisierungen bequem abdeckt. Fünf Guthabeneinheiten decken Zehntausende Standard-Automatisierungsschritte oder Hunderte schnelle KI-Nachrichten ab – allerdings können einige große, mehrstufige Aufgaben von Agenten es schneller aufbrauchen. Sie können Ihr Guthaben jederzeit aufstocken (siehe unten).
|
||||
|
||||
## Guthabenübertrag
|
||||
|
||||
Nicht genutzte Guthaben am Ende eines Abrechnungszeitraums werden automatisch in den nächsten Zeitraum übertragen.
|
||||
Ungenutztes Guthaben wird automatisch in den nächsten Abrechnungszeitraum übertragen.
|
||||
|
||||
* **Deckelung**: Der Übertragsbetrag ist auf die volle Zuteilung eines Zeitraums begrenzt, sodass Sie niemals mehr Guthaben übertragen können, als Ihr Tarif pro Zeitraum vorsieht.
|
||||
* **Sichtbarkeit**: Wenn übertragene Guthaben verfügbar sind, erscheinen sie als eigene Zeile **Übertragene Guthaben** in **Einstellungen → Abrechnung**, neben einem Saldo **Insgesamt verfügbar**.
|
||||
|
||||
## Guthabenverbrauch
|
||||
|
||||
Verschiedene Aktionen verbrauchen unterschiedliche Mengen an Guthaben:
|
||||
|
||||
| Aktionstyp | Guthabenverbrauch |
|
||||
| ---------------------------------------------------------------------------- | ------------------------ |
|
||||
| **Grundlegende Vorgänge** (Suchen, Aktualisieren, Erstellen von Datensätzen) | Minimal |
|
||||
| **Komplexe Vorgänge** (Code-Knoten, externe API-Aufrufe) | Mehr Guthaben |
|
||||
| **KI-Eingabeaufforderung & KI-Chats** | Variabel je nach Nutzung |
|
||||
|
||||
Guthaben werden in Echtzeit abgezogen, wenn Workflows ausgeführt werden.
|
||||
* **Sichtbarkeit**: Wenn übertragene Guthaben verfügbar sind, erscheinen sie als eigene Zeile **Übertragene Guthaben** in **Einstellungen → Abrechnung**, neben dem Saldo **Insgesamt verfügbar**.
|
||||
|
||||
## Nutzung überwachen
|
||||
|
||||
Verfolgen Sie Ihren Guthabenverbrauch:
|
||||
Behalten Sie Ihr Guthaben und dessen Verwendung im Blick:
|
||||
|
||||
1. Gehen Sie zu **Einstellungen → Abrechnung**
|
||||
2. Sehen Sie sich Ihre aktuelle Nutzung und Ihr verbleibendes Guthaben an
|
||||
3. Beobachten Sie Trends, um bei Bedarf zusätzliches Guthaben einzuplanen
|
||||
2. Sehen Sie Ihr **verbleibendes Guthaben** und die **Nutzung im aktuellen Zeitraum**
|
||||
3. Analysieren Sie die Aufschlüsselung, um zu sehen, welche Workflows und KI-Aktionen Credits verbrauchen – und welche Modelle diese KI-Aktionen verwendet haben
|
||||
|
||||
## Zusätzliche Guthaben kaufen
|
||||
Wenn Sie dies regelmäßig überprüfen, erkennen Sie einen ressourcenintensiven Workflow frühzeitig und können entscheiden, ob Sie ihn optimieren oder Ihr Guthaben aufstocken möchten.
|
||||
|
||||
Benötigen Sie mehr Guthaben?
|
||||
## Benötigen Sie mehr Guthaben?
|
||||
|
||||
Wenn Ihr Guthaben aufgebraucht ist – oder Sie vor einer großen Automatisierungswelle einen Puffer haben möchten – können Sie jederzeit zusätzliche Guthabenpakete kaufen:
|
||||
|
||||
1. Gehen Sie zu **Einstellungen → Abrechnung**
|
||||
2. Klicken Sie auf die Option, zusätzliche Guthabenpakete zu kaufen
|
||||
2. Wählen Sie die Option, **zusätzliches Guthaben zu kaufen**
|
||||
3. Wählen Sie die benötigte Menge
|
||||
|
||||
Gekauftes Guthaben wird Ihrem verfügbaren Guthaben sofort hinzugefügt.
|
||||
|
||||
@@ -262,6 +262,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
El identificador es el `universalIdentifier` del resolver de tu manifiesto. Registra esa URL con el proveedor.
|
||||
|
||||
<Note>
|
||||
**La aplicación debe reclamarse e instalarse en el espacio de trabajo propietario.** Dado que el resolver se ejecuta en el **espacio de trabajo propietario** (el espacio de trabajo que es propietario del registro de la aplicación), un desencadenador de ruta de servidor solo funciona una vez que la aplicación ha sido *reclamada*, es decir, tiene un espacio de trabajo propietario, **y** esa aplicación está **instalada en el espacio de trabajo propietario**. Hasta que ambas condiciones se cumplan, el resolver no tiene dónde ejecutarse, por lo que la ruta no puede despacharse. Por lo tanto, una aplicación que expone una función lógica `serverRouteTriggerSettings` no puede figurar en el marketplace hasta que haya sido reclamada e instalada en su espacio de trabajo propietario.
|
||||
</Note>
|
||||
|
||||
**Contrato del resolver.** El tipo `LogicFunctionConfig` del SDK aplica esto en tiempo de compilación: tan pronto como configuras `serverRouteTriggerSettings`, tu handler se ve obligado a devolver `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (o un `Promise` de esto). El `workspaceId` debe ser un espacio de trabajo donde la función de destino esté instalada; de lo contrario, la solicitud se rechaza con `404`.
|
||||
|
||||
| Campo | Tipo | Notas |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Créditos
|
||||
description: Cómo los créditos impulsan los flujos de trabajo, los agentes de IA y el chatbot de IA — y cómo gestionar tu saldo.
|
||||
description: Un saldo sencillo que impulsa tus flujos de trabajo, agentes de IA y chat de IA, y que define cuánto vale un crédito, hasta dónde llega y cómo administrarlo.
|
||||
---
|
||||
|
||||
## Resumen
|
||||
## ¿Qué son los créditos?
|
||||
|
||||
Los créditos impulsan las automatizaciones de flujos de trabajo y las capacidades de IA. Se consumen cuando se ejecutan acciones de flujos de trabajo, cuando los agentes de IA procesan tareas dentro de los flujos de trabajo y en el chat de IA.
|
||||
Los créditos son un saldo único que impulsa todo lo que ejecutamos en tu nombre y que tiene un costo real: **automatizaciones de flujos de trabajo**, **agentes de IA** y el **chat de IA**. En lugar de lidiar con cuotas separadas para "ejecuciones de automatización" y "tokens de IA", tienes un único saldo sencillo que debes vigilar.
|
||||
|
||||
## Asignación de créditos
|
||||
**1 crédito = $1 de uso.** Un crédito es simplemente un dólar de trabajo, por lo que tu saldo es fácil de entender: no hay unidades abstractas que convertir.
|
||||
|
||||
Los créditos se basan en tu ciclo de facturación, no en tu plan:
|
||||
## ¿Hasta dónde llega un crédito?
|
||||
|
||||
| Ciclo de facturación | Créditos |
|
||||
| -------------------- | -------- |
|
||||
| Mensual | 5/mes |
|
||||
| Anual | 50/año |
|
||||
El costo escala con el trabajo. La automatización diaria y los mensajes de IA rápidos cuestan una fracción diminuta de un crédito; las tareas grandes de agentes de IA con múltiples pasos cuestan más. A grandes rasgos, así se ve:
|
||||
|
||||
| Qué haces | Cuesta aproximadamente | Qué significa |
|
||||
| -------------------------------------------------------------------------------------------------- | ---------------------------------- | -------------------------------------------- |
|
||||
| Ejecutar un paso estándar de flujo de trabajo (buscar, crear, actualizar registros) | ~$0.0001 | Aproximadamente **10.000 pasos por crédito** |
|
||||
| Llamar a una API externa o ejecutar un nodo de código | Una pequeña fracción de un crédito | Miles por crédito |
|
||||
| Enviar un mensaje de chat de IA rápido o un paso de IA sencillo | Una fracción de un centavo | Cientos por crédito |
|
||||
| Ejecutar una tarea grande de agente de IA (p. ej., "configurar 10 objetos del espacio de trabajo") | Puede llegar a **~$1 o más** | Unos pocos por crédito |
|
||||
| Ejecutar una búsqueda web con IA | Un costo fijo por búsqueda | Cientos de búsquedas por crédito |
|
||||
|
||||
<Note>
|
||||
Los 5 créditos mensuales están diseñados para permitirte ejecutar automatizaciones sin preocuparte por los costos. Para la mayoría de los flujos de trabajo que usan acciones estándar, esto es más que suficiente. Solo necesitarás créditos adicionales al ejecutar nodos de código avanzados o funciones impulsadas por IA.
|
||||
Para la mayoría de los equipos, las automatizaciones estándar son prácticamente gratuitas: solo notarás una reducción apreciable en tu saldo cuando dependas de las funciones de IA o ejecutes nodos de código exigentes. Eso es intencional: los créditos incluidos están pensados para que puedas crear sin estar pendiente de un medidor.
|
||||
</Note>
|
||||
|
||||
## Cómo se mide el uso de IA
|
||||
|
||||
Cuando una acción llama a un modelo de IA, medimos exactamente los tokens usados y los valoramos según **las tarifas publicadas por el proveedor del modelo**, luego convertimos ese monto en dólares directamente en créditos; de este modo, lo que gastas refleja el costo real del trabajo, no una tarifa interna con recargo. Un mensaje de chat corto cuesta una fracción de un centavo. Una tarea grande de agente —por ejemplo, configurar diez objetos del espacio de trabajo— realiza muchas llamadas a modelos sobre un contexto creciente, por lo que puede sumar hasta un dólar o más. Se te factura por lo que realmente usas, hasta el nivel de token.
|
||||
|
||||
El costo varía según el modelo: un modelo ligero es drásticamente más barato por mensaje que un modelo de razonamiento de gama alta. Puedes ver el desglose por acción —incluido qué modelo se usó— en **Configuración → Facturación**.
|
||||
|
||||
## Qué incluye
|
||||
|
||||
Cada suscripción incluye créditos, y la cantidad depende de tu **ciclo de facturación**, no de tu plan:
|
||||
|
||||
| Ciclo de facturación | Créditos incluidos | Uso equivalente |
|
||||
| -------------------- | ------------------ | -------------------- |
|
||||
| Mensual | 5 / mes | ~$5 de uso cada mes |
|
||||
| Anual | 50 / año | ~$50 de uso cada año |
|
||||
|
||||
Estos créditos están diseñados para cubrir cómodamente la automatización diaria. Cinco créditos cubren decenas de miles de pasos de automatización estándar o cientos de mensajes rápidos de IA, aunque un puñado de tareas grandes de agente con múltiples pasos puede agotarlos más rápido. Puedes recargar en cualquier momento (ver más abajo).
|
||||
|
||||
## Acumulación de créditos
|
||||
|
||||
Los créditos no utilizados al final de un período de facturación se transfieren automáticamente al período siguiente.
|
||||
Los créditos no utilizados se acumulan automáticamente para el siguiente período de facturación.
|
||||
|
||||
* **Límite**: El monto acumulado está limitado a la asignación completa de un período, por lo que nunca podrás acumular más créditos de los que tu plan proporciona por período.
|
||||
* **Visibilidad**: Cuando haya créditos acumulados disponibles, aparecerán como una línea independiente de **Créditos acumulados** en **Configuración → Facturación**, junto a un saldo de **Total disponible**.
|
||||
|
||||
## Consumo de créditos
|
||||
|
||||
Diferentes acciones consumen distintas cantidades de créditos:
|
||||
|
||||
| Tipo de acción | Uso de créditos |
|
||||
| -------------------------------------------------------------------- | --------------------- |
|
||||
| **Operaciones básicas** (buscar, actualizar, crear registros) | Mínimo |
|
||||
| **Operaciones complejas** (nodos de código, llamadas a API externas) | Más créditos |
|
||||
| **Prompts de IA y chats de IA** | Variable según el uso |
|
||||
|
||||
Los créditos se deducen en tiempo real cuando se ejecutan los flujos de trabajo.
|
||||
* **Límite**: La acumulación está limitada a la asignación completa de un período, por lo que nunca podrás acumular más créditos de los que tu plan proporciona por período.
|
||||
* **Visibilidad**: Cuando tengas créditos acumulados, aparecerán como una línea independiente de **Créditos acumulados** en **Configuración → Facturación**, junto con tu saldo de **Total disponible**.
|
||||
|
||||
## Supervisión del uso
|
||||
|
||||
Lleva un seguimiento de tu consumo de créditos:
|
||||
Lleva un control de tu saldo y de en qué se está utilizando:
|
||||
|
||||
1. Ir a **Ajustes → Facturación**
|
||||
2. Consulta tu uso actual y los créditos restantes
|
||||
3. Supervisa las tendencias para planificar créditos adicionales si es necesario
|
||||
2. Consulta tus **créditos restantes** y el **uso del período actual**
|
||||
3. Profundiza en el desglose para ver qué flujos de trabajo y acciones de IA están consumiendo créditos y qué modelos usaron las acciones de IA
|
||||
|
||||
## Adquirir Créditos Adicionales
|
||||
Revisar esto con regularidad facilita detectar pronto un flujo de trabajo muy pesado y decidir si optimizarlo o recargar créditos.
|
||||
|
||||
¿Necesitas más créditos?
|
||||
## ¿Necesitas más créditos?
|
||||
|
||||
Si te quedas sin créditos —o quieres un colchón antes de una gran campaña de automatización— puedes comprar paquetes de créditos adicionales en cualquier momento:
|
||||
|
||||
1. Ir a **Ajustes → Facturación**
|
||||
2. Haz clic en la opción para adquirir paquetes de créditos adicionales
|
||||
2. Elige **adquirir créditos adicionales**
|
||||
3. Selecciona la cantidad que necesitas
|
||||
|
||||
Los créditos adquiridos se agregan de inmediato a tu saldo disponible.
|
||||
|
||||
@@ -262,6 +262,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
L’identifiant est le `universalIdentifier` du résolveur issu de votre manifeste. Enregistrez cette URL auprès du fournisseur.
|
||||
|
||||
<Note>
|
||||
**L’application doit être revendiquée et installée sur son espace de travail propriétaire.** Comme le résolveur s’exécute dans l’**espace de travail propriétaire** (l’espace de travail qui détient l’enregistrement de l’application), un déclencheur de route serveur ne fonctionne que lorsque l’application a été *revendiquée* — c’est‑à‑dire qu’elle possède un espace de travail propriétaire — **et** que cette application est **installée sur l’espace de travail propriétaire**. Tant que ces deux conditions ne sont pas remplies, le résolveur n’a nulle part où s’exécuter, donc la route ne peut pas être envoyée. Une application qui expose une fonction logique `serverRouteTriggerSettings` ne peut donc pas être répertoriée sur la place de marché tant qu’elle n’a pas été revendiquée et installée sur son espace de travail propriétaire.
|
||||
</Note>
|
||||
|
||||
**Contrat du résolveur.** Le type `LogicFunctionConfig` du SDK impose cela à la compilation : dès que vous définissez `serverRouteTriggerSettings`, votre gestionnaire est contraint de retourner `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (ou une `Promise` de cette valeur). Le `workspaceId` doit être celui d’un espace de travail où la fonction cible est installée, sinon la requête est rejetée avec un `404`.
|
||||
|
||||
| Champ | Type | Notes |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Crédits
|
||||
description: Comprendre comment les crédits alimentent les flux de travail, les agents IA et le chatbot IA — et comment gérer votre solde.
|
||||
description: Un solde unique simple qui alimente vos workflows, vos agents IA et votre chat IA — ce que vaut un crédit, jusqu’où il va, et comment le gérer.
|
||||
---
|
||||
|
||||
## Vue d'ensemble
|
||||
## Que sont les crédits ?
|
||||
|
||||
Les crédits alimentent les automatisations de flux de travail et les fonctionnalités d'IA. Ils sont consommés lorsque des actions de flux de travail s'exécutent, lorsque des agents IA traitent des tâches au sein des flux de travail, et dans le chat IA.
|
||||
Les crédits sont un solde unique qui alimente tout ce que nous faisons fonctionner en votre nom et qui a un coût réel : **automatisations de workflow**, **agents IA** et **chat IA**. Au lieu de jongler avec des quotas distincts pour les "exécutions d’automatisation" et les "jetons IA", vous disposez d’un solde unique simple à surveiller.
|
||||
|
||||
## Allocation des crédits
|
||||
**1 crédit = 1 $ d’utilisation.** Un crédit est simplement un dollar de travail, donc votre solde est facile à comprendre — aucune unité abstraite à convertir.
|
||||
|
||||
Les crédits dépendent de votre cycle de facturation, et non de votre forfait :
|
||||
## Jusqu'où va un crédit ?
|
||||
|
||||
| Cycle de facturation | Crédits |
|
||||
| -------------------- | ------- |
|
||||
| Mensuel | 5/mois |
|
||||
| Annuel | 50/an |
|
||||
Le coût augmente avec le volume de travail. Les automatisations quotidiennes et les messages IA rapides coûtent une infime fraction d’un crédit ; les tâches importantes d’agent IA en plusieurs étapes coûtent davantage. Voici l’ordre de grandeur approximatif :
|
||||
|
||||
| Ce que vous faites | Coût approximatif | Ce que cela signifie |
|
||||
| -------------------------------------------------------------------------------------------- | ------------------------------- | -------------------------------------- |
|
||||
| Exécuter une étape de workflow standard (recherche, création, mise à jour d’enregistrements) | ~$0.0001 | Environ **10 000 étapes par crédit** |
|
||||
| Appeler une API externe ou exécuter un nœud de code | Une petite fraction d’un crédit | Des milliers par crédit |
|
||||
| Envoyer un message de chat IA rapide ou une étape IA simple | Une fraction de centime | Des centaines par crédit |
|
||||
| Exécuter une grande tâche d’agent IA (par ex. « configurer 10 objets d’espace de travail ») | Peut atteindre **~$1 ou plus** | Quelques-uns par crédit |
|
||||
| Lancer une recherche web IA | Un coût fixe par recherche | Des centaines de recherches par crédit |
|
||||
|
||||
<Note>
|
||||
Les 5 crédits mensuels sont conçus pour vous permettre d'exécuter des automatisations sans vous soucier des coûts. Pour la plupart des flux de travail utilisant des actions standard, c'est plus que suffisant. Vous n'aurez besoin de crédits supplémentaires que lors de l'exécution de nœuds de code avancés ou de fonctionnalités alimentées par l'IA.
|
||||
Pour la plupart des équipes, les automatisations standard sont pratiquement gratuites — vous ne verrez une différence notable dans votre solde que lorsque vous vous appuierez sur les fonctionnalités IA ou exécuterez des nœuds de code lourds. C’est voulu : les crédits inclus sont conçus pour vous permettre de construire sans surveiller un compteur.
|
||||
</Note>
|
||||
|
||||
## Comment l’utilisation de l’IA est mesurée
|
||||
|
||||
Lorsqu’une action appelle un modèle IA, nous mesurons exactement les jetons utilisés et les facturons aux **tarifs publiés par le fournisseur du modèle**, puis nous convertissons ce montant en dollars directement en crédits — ainsi, ce que vous dépensez reflète le coût réel du travail, et non un tarif interne majoré. Un court message de chat coûte une fraction de centime. Une grande tâche d’agent IA — par exemple, configurer dix objets d’espace de travail — effectue de nombreux appels de modèle sur un contexte grandissant, ce qui peut représenter un dollar ou plus. Vous êtes facturé sur ce que vous utilisez réellement, jusqu’au jeton près.
|
||||
|
||||
Le coût varie selon le modèle : un modèle léger est nettement moins cher par message qu’un modèle de raisonnement haut de gamme. Vous pouvez voir la répartition par action — y compris le modèle utilisé — dans **Paramètres → Facturation**.
|
||||
|
||||
## Ce qui est inclus
|
||||
|
||||
Chaque abonnement inclut des crédits, et leur nombre dépend de votre **cycle de facturation**, pas de votre offre :
|
||||
|
||||
| Cycle de facturation | Crédits inclus | Utilisation équivalente |
|
||||
| -------------------- | -------------- | -------------------------- |
|
||||
| Mensuel | 5/mois | ~$5 d’utilisation par mois |
|
||||
| Annuel | 50/an | ~$50 d’utilisation par an |
|
||||
|
||||
Ces crédits sont conçus pour couvrir confortablement les automatisations quotidiennes. Cinq crédits couvrent des dizaines de milliers d’étapes d’automatisation standard ou des centaines de messages IA rapides — mais quelques grandes tâches d’agent en plusieurs étapes peuvent les consommer plus rapidement. Vous pouvez recharger à tout moment (voir ci-dessous).
|
||||
|
||||
## Report de crédits
|
||||
|
||||
Les crédits non utilisés à la fin d'une période de facturation sont automatiquement reportés à la période suivante.
|
||||
Les crédits inutilisés sont automatiquement reportés à la prochaine période de facturation.
|
||||
|
||||
* **Plafond**: Le montant reporté est plafonné à l'allocation complète d'une période, vous ne pouvez donc jamais reporter plus de crédits que ce que votre offre prévoit par période.
|
||||
* **Visibilité**: Lorsque des crédits reportés sont disponibles, ils apparaissent comme une ligne **Crédits reportés** distincte dans **Paramètres → Facturation**, aux côtés d'un solde **Total disponible**.
|
||||
|
||||
## Consommation de crédits
|
||||
|
||||
Les différentes actions consomment des quantités de crédits différentes :
|
||||
|
||||
| Type d'action | Utilisation des crédits |
|
||||
| ----------------------------------------------------------------------------- | ------------------------------------- |
|
||||
| **Opérations de base** (rechercher, mettre à jour, créer des enregistrements) | Minimale |
|
||||
| **Opérations complexes** (nœuds de code, appels d'API externes) | Plus de crédits |
|
||||
| **Prompts IA & chats IA** | Variable en fonction de l'utilisation |
|
||||
|
||||
Les crédits sont déduits en temps réel lorsque les flux de travail s'exécutent.
|
||||
* **Plafond**: Le montant reporté est plafonné à l’allocation complète d’une période, vous ne pouvez donc jamais reporter plus de crédits que ce que votre offre prévoit par période.
|
||||
* **Visibilité**: Lorsque des crédits reportés sont disponibles, ils apparaissent comme une ligne **Crédits reportés** distincte dans **Paramètres → Facturation**, aux côtés d’un solde **Total disponible**.
|
||||
|
||||
## Suivi de l'utilisation
|
||||
|
||||
Suivez votre consommation de crédits :
|
||||
Suivez votre solde et la façon dont il est utilisé :
|
||||
|
||||
1. Allez dans **Paramètres → Facturation**
|
||||
2. Consultez votre utilisation actuelle et vos crédits restants
|
||||
3. Surveillez les tendances pour planifier des crédits supplémentaires si nécessaire
|
||||
2. Consultez vos **crédits restants** et **l’utilisation de la période en cours**
|
||||
3. Examinez la répartition pour voir quels workflows et quelles actions IA consomment des crédits — et quels modèles les actions IA ont utilisés
|
||||
|
||||
## Achat de crédits supplémentaires
|
||||
Les examiner régulièrement permet de repérer tôt et facilement un workflow consommateur de ressources et de décider s’il faut l’optimiser ou recharger.
|
||||
|
||||
Besoin de plus de crédits ?
|
||||
## Besoin de plus de crédits ?
|
||||
|
||||
Si vous n’avez plus de crédits — ou si vous voulez une marge avant une grosse phase d’automatisation — vous pouvez acheter des packs de crédits supplémentaires à tout moment :
|
||||
|
||||
1. Allez dans **Paramètres → Facturation**
|
||||
2. Cliquez sur l'option pour acheter des packs de crédits supplémentaires
|
||||
2. Choisissez d’**acheter des crédits supplémentaires**
|
||||
3. Sélectionnez la quantité dont vous avez besoin
|
||||
|
||||
Les crédits achetés sont ajoutés immédiatement à votre solde disponible.
|
||||
|
||||
@@ -261,6 +261,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
L'identificatore è il `universalIdentifier` del resolver dal tuo manifest. Registra quell'URL presso il provider.
|
||||
|
||||
<Note>
|
||||
**L'applicazione deve essere rivendicata e installata nel workspace del proprietario.** Poiché il resolver viene eseguito nel **workspace del proprietario** (il workspace che possiede la registrazione dell'applicazione), un server route trigger funziona solo quando l'applicazione è stata *rivendicata*, cioè ha un workspace del proprietario, **e** quell'applicazione è **installata nel workspace del proprietario**. Finché entrambe non sono vere, il resolver non ha dove essere eseguito, quindi la route non può essere gestita. Un'applicazione che espone una funzione logica `serverRouteTriggerSettings` quindi non può essere elencata nel marketplace finché non è stata rivendicata e installata nel workspace del proprietario.
|
||||
</Note>
|
||||
|
||||
**Contratto del resolver.** Il tipo `LogicFunctionConfig` dell'SDK impone questo a tempo di compilazione: non appena imposti `serverRouteTriggerSettings`, il tuo handler è vincolato a restituire `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (o una `Promise` di questo valore). Il `workspaceId` deve essere un workspace in cui la funzione di destinazione è installata, altrimenti la richiesta viene rifiutata con `404`.
|
||||
|
||||
| Campo | Tipo | Note |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Crediti
|
||||
description: Comprendere come i crediti alimentano i flussi di lavoro, gli agenti di IA e il chatbot di IA — e come gestire il tuo saldo.
|
||||
description: Un saldo semplice che alimenta i tuoi workflow, gli agenti AI e la chat AI — quanto vale un credito, fin dove può arrivare e come gestirlo.
|
||||
---
|
||||
|
||||
## Panoramica
|
||||
## Cosa sono i crediti?
|
||||
|
||||
I crediti alimentano le automazioni dei flussi di lavoro e le funzionalità di IA. Vengono consumati quando vengono eseguite le azioni dei flussi di lavoro, quando gli agenti di IA elaborano attività nei flussi di lavoro e nella chat di IA.
|
||||
I crediti sono un unico saldo che alimenta tutto ciò che eseguiamo per tuo conto e che ha un costo reale: **automazioni dei workflow**, **agenti AI** e la **chat AI**. Invece di destreggiarti tra quote separate per "automation runs" e "AI tokens", hai un unico saldo semplice da tenere d’occhio.
|
||||
|
||||
## Allocazione dei crediti
|
||||
**1 credito = $1 di utilizzo.** Un credito è semplicemente un dollaro di lavoro, quindi il tuo saldo è facile da capire — nessuna unità astratta da convertire.
|
||||
|
||||
I crediti si basano sul tuo ciclo di fatturazione, non sul tuo piano:
|
||||
## Quanto può coprire un credito?
|
||||
|
||||
| Ciclo di fatturazione | Crediti |
|
||||
| --------------------- | ------- |
|
||||
| Mensile | 5/mese |
|
||||
| Annuale | 50/anno |
|
||||
Il costo varia in base al lavoro. Le automazioni quotidiane e i messaggi AI rapidi costano una piccola frazione di un credito; le grandi attività degli agenti AI multi-step costano di più. Ecco un quadro approssimativo:
|
||||
|
||||
| Cosa fai | Costo approssimativo | Cosa significa |
|
||||
| ---------------------------------------------------------------------------------------------- | ---------------------------------- | --------------------------------- |
|
||||
| Esegui uno step di workflow standard (ricerca, creazione, aggiornamento di record) | ~$0.0001 | Circa **10.000 step per credito** |
|
||||
| Chiama un'API esterna o esegui un nodo di codice | Una piccola frazione di un credito | Migliaia per credito |
|
||||
| Invia un messaggio di chat AI rapido o uno step AI semplice | Una frazione di un centesimo | Centinaia per credito |
|
||||
| Esegui una grande attività di agente AI (ad es. "configura 10 oggetti dello spazio di lavoro") | Può arrivare a **~$1 o più** | Alcuni per credito |
|
||||
| Esegui una ricerca web con AI | Un costo fisso per ricerca | Centinaia di ricerche per credito |
|
||||
|
||||
<Note>
|
||||
I 5 crediti mensili sono pensati per consentirti di eseguire automazioni senza preoccuparti dei costi. Per la maggior parte dei flussi di lavoro che utilizzano azioni standard, questo è più che sufficiente. Avrai bisogno di crediti aggiuntivi solo quando esegui nodi di codice avanzati o funzionalità basate sull'IA.
|
||||
Per la maggior parte dei team, le automazioni standard sono di fatto gratuite — noterai un impatto sul saldo solo quando ti affidi alle funzionalità AI o esegui nodi di codice pesanti. È voluto: i crediti inclusi sono pensati per permetterti di costruire senza dover controllare un contatore.
|
||||
</Note>
|
||||
|
||||
## Come viene misurato l'utilizzo dell'AI
|
||||
|
||||
Quando un'azione chiama un modello AI, misuriamo esattamente i token utilizzati e li tariffiamo alle **tariffe pubblicate dal provider del modello**, quindi convertiamo direttamente quell'importo in dollari in crediti — così ciò che spendi rispecchia il costo reale del lavoro, non una tariffa interna maggiorata. Un breve messaggio di chat costa una frazione di un centesimo. Una grande attività di agente — ad esempio, configurare dieci oggetti dello spazio di lavoro — effettua molte chiamate al modello su un contesto in crescita, quindi può arrivare a un dollaro o più. Ti viene addebitato ciò che usi effettivamente, fino al singolo token.
|
||||
|
||||
Il costo varia in base al modello: un modello leggero è drasticamente più economico per messaggio rispetto a un modello di ragionamento di fascia alta. Puoi vedere il dettaglio per azione — incluso quale modello è stato utilizzato — in **Impostazioni → Fatturazione**.
|
||||
|
||||
## Cosa è incluso
|
||||
|
||||
Ogni abbonamento include crediti e l'importo dipende dal tuo **ciclo di fatturazione**, non dal tuo piano:
|
||||
|
||||
| Ciclo di fatturazione | Crediti inclusi | Utilizzo equivalente |
|
||||
| --------------------- | --------------- | ------------------------------- |
|
||||
| Mensile | 5/mese | Circa $5 di utilizzo ogni mese |
|
||||
| Annuale | 50/anno | Circa $50 di utilizzo ogni anno |
|
||||
|
||||
Questi crediti sono pensati per coprire comodamente le automazioni quotidiane. Cinque crediti coprono decine di migliaia di step di automazione standard o centinaia di messaggi AI rapidi — anche se alcune grandi attività di agenti AI multi-step possono esaurirli più velocemente. Puoi effettuare una ricarica in qualsiasi momento (vedi sotto).
|
||||
|
||||
## Riporto dei crediti
|
||||
|
||||
I crediti non utilizzati alla fine di un periodo di fatturazione vengono automaticamente riportati al periodo successivo.
|
||||
I crediti non utilizzati vengono riportati automaticamente al periodo di fatturazione successivo.
|
||||
|
||||
* **Limite**: L'importo del riporto è limitato all'assegnazione completa di un periodo, quindi non puoi mai riportare più crediti di quanti il tuo piano ne preveda per periodo.
|
||||
* **Visibilità**: Quando sono disponibili crediti riportati, compaiono come una voce separata **Crediti riportati** in **Impostazioni → Fatturazione**, accanto al saldo **Totale disponibile**.
|
||||
|
||||
## Consumo di crediti
|
||||
|
||||
Azioni diverse consumano quantità diverse di crediti:
|
||||
|
||||
| Tipo di azione | Utilizzo dei crediti |
|
||||
| -------------------------------------------------------------------- | ------------------------------ |
|
||||
| **Operazioni di base** (ricerca, aggiornamento, creazione di record) | Minimo |
|
||||
| **Operazioni complesse** (nodi di codice, chiamate alle API esterne) | Più crediti |
|
||||
| **Prompt di IA e chat di IA** | Variabile in base all'utilizzo |
|
||||
|
||||
I crediti vengono detratti in tempo reale quando i flussi di lavoro vengono eseguiti.
|
||||
|
||||
## Monitoraggio dell'utilizzo
|
||||
|
||||
Monitora il consumo dei tuoi crediti:
|
||||
Tieni traccia del tuo saldo e di dove sta andando:
|
||||
|
||||
1. Vai a **Impostazioni → Fatturazione**
|
||||
2. Visualizza il tuo utilizzo attuale e i crediti rimanenti
|
||||
3. Monitora le tendenze per pianificare crediti aggiuntivi se necessario
|
||||
2. Vedi i **crediti rimanenti** e **l'utilizzo per il periodo corrente**
|
||||
3. Approfondisci il dettaglio per vedere quali workflow e azioni AI stanno consumando crediti — e quali modelli sono stati utilizzati dalle azioni AI
|
||||
|
||||
## Acquisto di crediti aggiuntivi
|
||||
Rivedere questo regolarmente rende facile individuare in anticipo un workflow pesante e decidere se ottimizzarlo o effettuare una ricarica.
|
||||
|
||||
Hai bisogno di più crediti?
|
||||
## Hai bisogno di più crediti?
|
||||
|
||||
Se esaurisci i crediti — o vuoi un margine prima di una grande iniziativa di automazione — puoi acquistare pacchetti di crediti aggiuntivi in qualsiasi momento:
|
||||
|
||||
1. Vai a **Impostazioni → Fatturazione**
|
||||
2. Fai clic sull'opzione per acquistare pacchetti di crediti aggiuntivi
|
||||
2. Scegli di **acquistare crediti aggiuntivi**
|
||||
3. Seleziona la quantità di cui hai bisogno
|
||||
|
||||
I crediti acquistati vengono aggiunti immediatamente al tuo saldo disponibile.
|
||||
|
||||
@@ -261,6 +261,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
이 식별자는 manifest에 있는 resolver의 `universalIdentifier`입니다. 해당 URL을 공급자에 등록하세요.
|
||||
|
||||
<Note>
|
||||
**애플리케이션은 소유자 워크스페이스가 지정되어 해당 워크스페이스에 설치되어 있어야 합니다.** 리졸버는 **소유자 워크스페이스**(애플리케이션 등록을 소유한 워크스페이스)에서 실행되므로, 서버 라우트 트리거는 애플리케이션에 소유자 워크스페이스가 *지정되고* — 즉, 소유자 워크스페이스가 있고 — **그리고** 그 애플리케이션이 **소유자 워크스페이스에 설치된** 때에만 동작합니다. 이 두 조건이 모두 충족되기 전에는 리졸버가 실행될 위치가 없으므로, 라우트를 디스패치할 수 없습니다. 따라서 `serverRouteTriggerSettings` 로직 함수를 노출하는 애플리케이션은 소유자 워크스페이스가 지정되어 그 워크스페이스에 설치되기 전까지는 마켓플레이스에 등록될 수 없습니다.
|
||||
</Note>
|
||||
|
||||
**Resolver 계약.** SDK의 `LogicFunctionConfig` 타입은 컴파일 타임에 이를 강제합니다. `serverRouteTriggerSettings`를 설정하는 즉시, 핸들러는 `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }`(또는 이 값을 반환하는 `Promise`)를 반환하도록 제한됩니다. `workspaceId`는 대상 함수가 설치된 워크스페이스여야 하며, 그렇지 않으면 요청은 `404`로 거부됩니다.
|
||||
|
||||
| 필드 | 유형 | 노트 |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: 크레딧
|
||||
description: 크레딧이 워크플로우, AI 에이전트, AI 챗봇을 어떻게 구동하는지 — 그리고 잔액을 관리하는 방법.
|
||||
description: 워크플로, AI 에이전트, AI 채팅을 모두 구동하는 하나의 단일 잔액 — 크레딧의 가치, 어느 정도까지 사용할 수 있는지, 그리고 관리 방법.
|
||||
---
|
||||
|
||||
## 개요
|
||||
## 크레딧이란 무엇인가요?
|
||||
|
||||
크레딧은 워크플로우 자동화와 AI 기능을 구동합니다. 워크플로우 액션이 실행될 때, 워크플로우 내에서 AI 에이전트가 작업을 처리할 때, 그리고 AI 채팅 내에서 크레딧이 소모됩니다.
|
||||
크레딧은 실제 비용이 드는, 여러분을 대신해 우리가 실행하는 모든 것 — **워크플로 자동화**, **AI 에이전트**, **AI 채팅** — 을 구동하는 단일 잔액입니다. "automation runs"와 "AI tokens"에 대한 개별 할당량을 따로 관리하는 대신, 모니터링하기 쉬운 하나의 단순한 잔액만 살펴보면 됩니다.
|
||||
|
||||
## 크레딧 할당
|
||||
**크레딧 1개 = $1 사용량.** 크레딧은 말 그대로 1달러어치의 작업이므로, 추상적인 단위를 따로 환산할 필요 없이 잔액을 직관적으로 이해할 수 있습니다.
|
||||
|
||||
크레딧은 플랜이 아니라 청구 주기에 따라 결정됩니다:
|
||||
## 크레딧 하나로 어느 정도까지 사용할 수 있나요?
|
||||
|
||||
| 청구 주기 | 크레딧 |
|
||||
| ----- | ---- |
|
||||
| 월간 | 월 5 |
|
||||
| 연간 | 연 50 |
|
||||
비용은 작업량에 비례해 증가합니다. 일상적인 자동화와 짧은 AI 메시지는 크레딧의 아주 일부분만 사용하지만, 크고 여러 단계를 거치는 AI 에이전트 작업은 더 많은 크레딧을 사용합니다. 대략적인 개요는 다음과 같습니다:
|
||||
|
||||
| 하는 일 | 대략적인 비용 | 의미 |
|
||||
| --------------------------------------- | ------------------------------- | ---------------------- |
|
||||
| 표준 워크플로 단계 실행(검색, 레코드 생성, 레코드 업데이트) | ~$0.0001 | 크레딧 **1개로 약 10,000단계** |
|
||||
| 외부 API를 호출하거나 코드 노드를 실행 | 크레딧의 작은 일부 | 크레딧 1개당 수천 회 |
|
||||
| 빠른 AI 채팅 메시지를 보내거나 단순한 AI 단계를 실행 | 1센트의 일부 | 크레딧 1개당 수백 회 |
|
||||
| 대형 AI 에이전트 작업 실행(예: "워크스페이스 객체 10개 구성") | 비용이 **약 $1 또는 그 이상**까지 올라갈 수 있음 | 크레딧 1개당 몇 회 |
|
||||
| AI 웹 검색 실행 | 검색 1회당 고정 비용 | 크레딧 1개당 수백 회 검색 |
|
||||
|
||||
<Note>
|
||||
월 5개의 크레딧은 비용을 걱정하지 않고 자동화를 실행할 수 있도록 설계되었습니다. 표준 동작을 사용하는 대부분의 워크플로우에는 이 정도로 충분합니다. 고급 코드 노드나 AI 기반 기능을 실행할 때에만 추가 크레딧이 필요합니다.
|
||||
대부분의 팀에게 표준 자동화는 사실상 무료에 가깝고, 눈에 띄게 잔액이 줄어드는 것은 AI 기능에 많이 의존하거나 무거운 코드 노드를 실행할 때뿐입니다. 이는 의도된 설계로, 포함된 크레딧은 사용량 계측기를 신경 쓰지 않고도 자유롭게 구축할 수 있도록 제공됩니다.
|
||||
</Note>
|
||||
|
||||
## AI 사용량은 어떻게 계측되나요
|
||||
|
||||
액션이 AI 모델을 호출하면, 사용된 토큰 수를 정확히 측정하고 **모델 제공자가 공개한 요금**을 기준으로 가격을 산정한 뒤, 그 달러 금액을 그대로 크레딧으로 환산합니다. 즉, 실제 작업 비용에 맞춰 사용량이 청구되며, 내부 마진이 붙은 요율로 과금되지 않습니다. 짧은 채팅 메시지는 1센트의 일부만 비용이 듭니다. 큰 에이전트 작업(예: 워크스페이스 객체 10개 구성)은 점점 커지는 컨텍스트에서 여러 번 모델을 호출하므로, 비용이 1달러 이상까지 쌓일 수 있습니다. 실제로 사용한 양, 토큰 단위까지 정확히 과금됩니다.
|
||||
|
||||
비용은 모델에 따라 달라지며, 가벼운 모델은 최고급 추론 모델에 비해 메시지당 비용이 훨씬 저렴합니다. **설정 → 결제**에서 각 액션별 사용 내역과 사용된 모델을 확인할 수 있습니다.
|
||||
|
||||
## 포함 내용
|
||||
|
||||
모든 구독에는 크레딧이 포함되며, 크레딧 양은 요금제가 아니라 **결제 주기**에 따라 달라집니다:
|
||||
|
||||
| 청구 주기 | 포함 크레딧 | 동등 사용량 |
|
||||
| ----- | ------ | ---------------- |
|
||||
| 월간 | 월 5 | 매월 약 $5 상당의 사용량 |
|
||||
| 연간 | 연 50 | 매년 약 $50 상당의 사용량 |
|
||||
|
||||
이 크레딧은 일상적인 자동화를 넉넉하게 처리할 수 있도록 설계되었습니다. 크레딧 5개면 수만 번의 표준 자동화 단계나 수백 건의 빠른 AI 메시지를 처리할 수 있지만, 일부 대형 다단계 에이전트 작업은 크레딧을 더 빨리 소진시킬 수 있습니다. 언제든지 크레딧을 추가 충전할 수 있습니다(아래 참조).
|
||||
|
||||
## 크레딧 이월
|
||||
|
||||
결제 기간 말에 사용하지 않은 크레딧은 자동으로 다음 기간으로 이월됩니다.
|
||||
사용하지 않은 크레딧은 다음 결제 기간으로 자동 이월됩니다.
|
||||
|
||||
* **한도**: 이월 가능한 크레딧은 한 기간의 전체 할당량으로 제한되므로, 기간당 요금제가 제공하는 크레딧보다 더 많이 이월할 수 없습니다.
|
||||
* **한도**: 이월은 한 기간의 전체 할당량으로 제한되므로, 기간당 요금제가 제공하는 크레딧보다 더 많이 이월할 수 없습니다.
|
||||
* **표시**: 이월 크레딧이 있으면 **설정 → 결제**에서 별도의 **이월 크레딧** 항목으로 표시되며, 그 옆에 **총 사용 가능** 잔액이 함께 표시됩니다.
|
||||
|
||||
## 크레딧 소모
|
||||
|
||||
동작에 따라 소모되는 크레딧 양이 다릅니다:
|
||||
|
||||
| 동작 유형 | 크레딧 사용량 |
|
||||
| ----------------------------- | ----------- |
|
||||
| **기본 작업** (검색, 업데이트, 레코드 생성) | 최소 |
|
||||
| **복잡한 작업** (코드 노드, 외부 API 호출) | 더 많은 크레딧 소모 |
|
||||
| **AI 프롬프트 & AI 채팅** | 사용량에 따라 변동 |
|
||||
|
||||
워크플로우가 실행될 때 크레딧은 실시간으로 차감됩니다.
|
||||
|
||||
## 사용량 모니터링
|
||||
|
||||
크레딧 소모량을 추적하세요:
|
||||
잔액과 사용처를 계속 파악하세요:
|
||||
|
||||
1. **설정 → 결제**로 이동
|
||||
2. 현재 사용량과 남은 크레딧을 확인하세요
|
||||
3. 추세를 모니터링하여 필요 시 추가 크레딧을 계획하세요
|
||||
2. **남은 크레딧**과 **현재 기간의 사용량**을 확인
|
||||
3. 세부 내역을 확인해 어떤 워크플로와 AI 액션이 크레딧을 사용하고 있는지, 또한 AI 액션이 어떤 모델을 사용했는지 파악하세요
|
||||
|
||||
## 추가 크레딧 구입
|
||||
이를 정기적으로 검토하면 무거운 워크플로를 일찍 발견해 최적화할지, 아니면 크레딧을 추가 충전할지 쉽게 결정할 수 있습니다.
|
||||
|
||||
크레딧이 더 필요하신가요?
|
||||
## 크레딧이 더 필요하신가요?
|
||||
|
||||
크레딧을 모두 사용했거나, 대규모 자동화를 진행하기 전에 여유분을 확보하고 싶다면 언제든지 추가 크레딧 팩을 구매할 수 있습니다:
|
||||
|
||||
1. **설정 → 결제**로 이동
|
||||
2. 추가 크레딧 팩을 구매하는 옵션을 클릭하세요
|
||||
2. **추가 크레딧 구매**를 선택
|
||||
3. 필요한 크레딧 수량을 선택하세요
|
||||
|
||||
구매한 크레딧은 즉시 사용 가능 잔액에 추가됩니다.
|
||||
|
||||
@@ -261,6 +261,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
O identificador é o `universalIdentifier` do resolver, vindo do seu manifest. Registre essa URL junto ao provedor.
|
||||
|
||||
<Note>
|
||||
**O aplicativo deve ser reivindicado e instalado em seu workspace proprietário.** Como o resolvedor é executado no **workspace proprietário** (o workspace que é proprietário do registro do aplicativo), um acionador de rota de servidor só funciona depois que o aplicativo tiver sido *reivindicado* — ou seja, tiver um workspace proprietário — **e** esse aplicativo estiver **instalado no workspace proprietário**. Até que ambas as condições sejam verdadeiras, o resolvedor não tem onde ser executado, portanto a rota não pode ser despachada. Um aplicativo que expõe uma função lógica `serverRouteTriggerSettings`, portanto, não pode ser listado no marketplace até que seja reivindicado e instalado em seu workspace proprietário.
|
||||
</Note>
|
||||
|
||||
**Contrato do resolver.** O tipo `LogicFunctionConfig` do SDK aplica isso em tempo de compilação: assim que você define `serverRouteTriggerSettings`, o seu handler fica limitado a retornar `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (ou uma `Promise` disso). O `workspaceId` deve ser um workspace onde a função de destino esteja instalada, caso contrário a requisição é rejeitada com `404`.
|
||||
|
||||
| Campo | Tipo | Notas |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Créditos
|
||||
description: Entenda como os créditos alimentam fluxos de trabalho, agentes de IA e o chatbot de IA — e como gerenciar seu saldo.
|
||||
description: Um saldo simples que alimenta seus fluxos de trabalho, agentes de IA e chat de IA — quanto vale um crédito, até onde ele vai e como gerenciá-lo.
|
||||
---
|
||||
|
||||
## Visão Geral
|
||||
## O que são créditos?
|
||||
|
||||
Os créditos alimentam as automações de fluxo de trabalho e os recursos de IA. Eles são consumidos quando ações de fluxo de trabalho são executadas, quando agentes de IA processam tarefas dentro de fluxos de trabalho e no chat de IA.
|
||||
Créditos são um saldo único que alimenta tudo o que executamos em seu nome e que tem um custo real: **automações de fluxos de trabalho**, **agentes de IA** e o **chat de IA**. Em vez de gerenciar cotas separadas para "execuções de automação" e "tokens de IA", você tem um saldo simples para acompanhar.
|
||||
|
||||
## Alocação de créditos
|
||||
**1 crédito = US$ 1 de uso.** Um crédito é apenas um dólar de trabalho, então o seu saldo é fácil de entender — sem unidades abstratas para converter.
|
||||
|
||||
Os créditos são baseados no seu ciclo de faturamento, não no seu plano:
|
||||
## Até onde vai um crédito?
|
||||
|
||||
| Ciclo de faturamento | Créditos |
|
||||
| -------------------- | -------- |
|
||||
| Mensal | 5/mês |
|
||||
| Anual | 50/ano |
|
||||
O custo escala com o trabalho. Automações do dia a dia e mensagens de IA rápidas custam uma pequena fração de um crédito; tarefas grandes de agentes de IA com várias etapas custam mais. Aqui está uma visão aproximada:
|
||||
|
||||
| O que você faz | Custa aproximadamente | O que significa |
|
||||
| ------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------- |
|
||||
| Executar uma etapa padrão de fluxo de trabalho (pesquisar, criar, atualizar registros) | ~$0.0001 | Cerca de **10.000 etapas por crédito** |
|
||||
| Chamar uma API externa ou executar um nó de código | Uma pequena fração de um crédito | Milhares por crédito |
|
||||
| Enviar uma mensagem de chat de IA rápida ou uma etapa simples de IA | Uma fração de centavo | Centenas por crédito |
|
||||
| Executar uma grande tarefa de agente de IA (por exemplo, "configurar 10 objetos do espaço de trabalho") | Pode chegar a **~$1 ou mais** | Alguns por crédito |
|
||||
| Executar uma pesquisa na web com IA | Um custo fixo por pesquisa | Centenas de pesquisas por crédito |
|
||||
|
||||
<Note>
|
||||
Os 5 créditos mensais foram projetados para permitir que você execute automações sem se preocupar com custos. Para a maioria dos fluxos de trabalho que usam ações padrão, isso é mais do que suficiente. Você só precisará de créditos adicionais ao executar nós de código avançados ou recursos com tecnologia de IA.
|
||||
Para a maioria das equipes, as automações padrão são praticamente gratuitas — você só vai notar um impacto no seu saldo quando depender de recursos de IA ou executar nós de código pesados. Isso é intencional: os créditos incluídos são pensados para permitir que você crie sem ficar de olho no medidor.
|
||||
</Note>
|
||||
|
||||
## Como o uso de IA é medido
|
||||
|
||||
Quando uma ação chama um modelo de IA, medimos exatamente os tokens usados e os cobramos pelas **tarifas publicadas pelo provedor do modelo**, depois convertemos esse valor em dólares diretamente em créditos — assim, o que você gasta acompanha o custo real do trabalho, não uma taxa interna com acréscimo. Uma mensagem de chat curta custa uma fração de centavo. Uma grande tarefa de agente — por exemplo, configurar dez objetos do espaço de trabalho — faz muitas chamadas de modelo em um contexto crescente, então pode somar até um dólar ou mais. Você é cobrado apenas pelo que realmente usa, até o nível de token.
|
||||
|
||||
O custo varia de acordo com o modelo: um modelo leve é dramaticamente mais barato por mensagem do que um modelo de raciocínio de nível superior. Você pode ver o detalhamento por ação — incluindo qual modelo foi usado — em **Configurações → Cobrança**.
|
||||
|
||||
## O que está incluído
|
||||
|
||||
Toda assinatura inclui créditos, e o valor depende do seu **ciclo de cobrança**, não do seu plano:
|
||||
|
||||
| Ciclo de faturamento | Créditos incluídos | Uso equivalente |
|
||||
| -------------------- | ------------------ | ------------------- |
|
||||
| Mensal | 5 / mês | ~$5 de uso por mês |
|
||||
| Anual | 50 / ano | ~$50 de uso por ano |
|
||||
|
||||
Esses créditos são projetados para cobrir confortavelmente as automações do dia a dia. Cinco créditos cobrem dezenas de milhares de etapas de automação padrão ou centenas de mensagens rápidas de IA — embora algumas tarefas grandes de agentes com várias etapas possam consumi-los mais rápido. Você pode recarregar a qualquer momento (veja abaixo).
|
||||
|
||||
## Acúmulo de créditos
|
||||
|
||||
Créditos não utilizados ao final de um período de faturamento são automaticamente transferidos para o próximo período.
|
||||
Créditos não utilizados são automaticamente acumulados para o próximo período de cobrança.
|
||||
|
||||
* **Limite**: O valor de transferência é limitado à alocação total de um período, portanto você nunca poderá transferir mais créditos do que o seu plano fornece por período.
|
||||
* **Visibilidade**: Quando houver créditos transferidos, eles aparecerão como uma linha separada chamada **Créditos transferidos** em **Configurações → Cobrança**, juntamente com um saldo de **Total disponível**.
|
||||
|
||||
## Consumo de créditos
|
||||
|
||||
Ações diferentes consomem quantidades diferentes de créditos:
|
||||
|
||||
| Tipo de ação | Uso de Créditos |
|
||||
| ----------------------------------------------------------------- | ------------------------ |
|
||||
| **Operações básicas** (pesquisar, atualizar, criar registros) | Mínimo |
|
||||
| **Operações complexas** (nós de código, chamadas de API externas) | Mais créditos |
|
||||
| **Prompt de IA e chats de IA** | Variável com base no uso |
|
||||
|
||||
Os créditos são deduzidos em tempo real à medida que os fluxos de trabalho são executados.
|
||||
* **Limite**: O valor de acúmulo é limitado à alocação total de um período, então você nunca poderá acumular mais créditos do que o seu plano fornece por período.
|
||||
* **Visibilidade**: Quando houver créditos acumulados, eles aparecerão como uma linha separada chamada **Créditos acumulados** em **Configurações → Cobrança**, juntamente com o saldo de **Total disponível**.
|
||||
|
||||
## Monitoramento do uso
|
||||
|
||||
Acompanhe seu consumo de créditos:
|
||||
Acompanhe o seu saldo e para onde ele está indo:
|
||||
|
||||
1. Vá para **Configurações → Faturamento**
|
||||
2. Veja seu uso atual e os créditos restantes
|
||||
3. Monitore tendências para planejar créditos adicionais, se necessário
|
||||
2. Veja seus **créditos restantes** e o **uso no período atual**
|
||||
3. Aprofunde-se no detalhamento para ver quais fluxos de trabalho e ações de IA estão consumindo créditos — e quais modelos as ações de IA usaram
|
||||
|
||||
## Compra de Créditos Adicionais
|
||||
Revisar isso regularmente torna fácil identificar cedo um fluxo de trabalho pesado e decidir se deseja otimizá-lo ou recarregar.
|
||||
|
||||
Precisa de mais créditos?
|
||||
## Precisa de mais créditos?
|
||||
|
||||
Se você ficar sem créditos — ou quiser uma folga antes de uma grande onda de automação — pode comprar pacotes de créditos adicionais a qualquer momento:
|
||||
|
||||
1. Vá para **Configurações → Faturamento**
|
||||
2. Clique na opção para comprar pacotes de créditos adicionais
|
||||
2. Escolha **comprar créditos adicionais**
|
||||
3. Selecione a quantidade de que você precisa
|
||||
|
||||
Os créditos comprados são adicionados imediatamente ao seu saldo disponível.
|
||||
|
||||
@@ -262,11 +262,15 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
Identificatorul este `universalIdentifier` al resolver-ului din manifestul dvs. Înregistrați acel URL la furnizor.
|
||||
|
||||
<Note>
|
||||
**Aplicația trebuie revendicată și instalată în spațiul de lucru al proprietarului.** Deoarece resolverul rulează în **spațiul de lucru al proprietarului** (spațiul de lucru care deține înregistrarea aplicației), un declanșator de rută de server funcționează doar după ce aplicația a fost *revendicată* — adică are un spațiu de lucru al proprietarului — **și** acea aplicație este **instalată în spațiul de lucru al proprietarului**. Până când ambele condiții sunt adevărate, resolverul nu are unde să ruleze, astfel ruta nu poate fi apelată. O aplicație care expune o funcție logică `serverRouteTriggerSettings` nu poate fi, așadar, listată în marketplace până când nu este revendicată și instalată în spațiul de lucru al proprietarului.
|
||||
</Note>
|
||||
|
||||
**Contractul resolver-ului.** Tipul `LogicFunctionConfig` din SDK impune acest lucru la compilare: de îndată ce setați `serverRouteTriggerSettings`, handler-ul este constrâns să returneze `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (sau un `Promise` al acestuia). `workspaceId` trebuie să fie un workspace în care funcția țintă este instalată, altfel cererea este respinsă cu `404`.
|
||||
|
||||
| Câmp | Tip | Notițe |
|
||||
| ---------------------------------------- | ------------------- | --------------------------------------------------------------------------------- |
|
||||
| `workspaceId` | `string` | UUID-ul workspace-ului în care va rula ținta. |
|
||||
| `workspaceId` | `șir` | UUID-ul workspace-ului în care va rula ținta. |
|
||||
| `targetLogicFunctionUniversalIdentifier` | `string` | `universalIdentifier` al funcției logice care trebuie invocată în acel workspace. |
|
||||
| `payload` | `object` (opțional) | Dacă este setat, înlocuiește corpul cererii trimis către țintă. |
|
||||
|
||||
@@ -654,7 +658,7 @@ console.log(uploadedFile);
|
||||
| `fileBuffer` | `Buffer` | Conținutul brut al fișierului |
|
||||
| `filename` | `string` | Numele fișierului (folosit pentru stocare și afișare) |
|
||||
| `contentType` | `string` | Tipul MIME (implicit `application/octet-stream` dacă este omis) |
|
||||
| `fieldMetadataUniversalIdentifier` | `string` | `universalIdentifier` al câmpului de tip fișier de pe obiectul dvs. |
|
||||
| `fieldMetadataUniversalIdentifier` | `șir` | `universalIdentifier` al câmpului de tip fișier de pe obiectul dvs. |
|
||||
|
||||
Puncte cheie:
|
||||
* Folosește `universalIdentifier` al câmpului (nu ID-ul specific spațiului de lucru), astfel încât codul dvs. de încărcare funcționează în orice spațiu de lucru în care aplicația dvs. este instalată.
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Credite
|
||||
description: Înțelegerea modului în care creditele alimentează fluxurile de lucru, agenții AI și chatbotul AI — și cum să vă gestionați soldul.
|
||||
description: Un singur sold simplu care alimentează fluxurile dvs. de lucru, agenții AI și chatul AI — cât valorează un credit, cât de departe ajunge și cum să îl gestionați.
|
||||
---
|
||||
|
||||
## Prezentare generală
|
||||
## Ce sunt creditele?
|
||||
|
||||
Creditele alimentează automatizările fluxurilor de lucru și capabilitățile AI. Acestea sunt consumate atunci când acțiunile din fluxurile de lucru se execută, când agenții AI procesează sarcini în cadrul fluxurilor de lucru și în chatul AI.
|
||||
Creditele reprezintă un singur sold care alimentează tot ceea ce rulăm în numele dvs. și are un cost real: **automatizări ale fluxurilor de lucru**, **agenți AI** și **chatul AI**. În loc să jonglați cu cote separate pentru „rulări de automatizare” și „jetoane AI”, aveți un singur sold simplu de urmărit.
|
||||
|
||||
## Alocarea creditelor
|
||||
**1 credit = $1 de utilizare.** Un credit este doar un dolar de lucru, astfel încât soldul dvs. este ușor de înțeles — fără unități abstracte de convertit.
|
||||
|
||||
Creditele se bazează pe ciclul de facturare, nu pe planul dvs.:
|
||||
## Cât de departe ajunge un credit?
|
||||
|
||||
| Ciclu de facturare | Credite |
|
||||
| ------------------ | ------- |
|
||||
| Lunar | 5/lună |
|
||||
| Anual | 50/an |
|
||||
Costul variază în funcție de volumul de lucru. Automatizările de zi cu zi și mesajele AI rapide costă o fracțiune foarte mică dintr-un credit; sarcinile mari, cu mai mulți pași, executate de agenți AI costă mai mult. Iată o aproximare:
|
||||
|
||||
| Ce faceți | Cost aproximativ | Ce înseamnă asta |
|
||||
| ------------------------------------------------------------------------------------------------ | ------------------------------------ | ----------------------------------------- |
|
||||
| Rulați un pas standard de flux de lucru (căutare, creare, actualizare de înregistrări) | ~$0.0001 | Aproximativ **10.000 de pași per credit** |
|
||||
| Apelați un API extern sau rulați un nod de cod | O mică fracțiune dintr-un credit | Mii per credit |
|
||||
| Trimiteți un mesaj AI rapid sau un pas AI simplu | O fracțiune de cent | Sute per credit |
|
||||
| Rulați o sarcină mare pentru un agent AI (de ex. „configurează 10 obiecte din spațiul de lucru”) | Poate ajunge la **~$1 sau mai mult** | Câteva per credit |
|
||||
| Rulați o căutare web AI | Un cost fix pe căutare | Sute de căutări per credit |
|
||||
|
||||
<Note>
|
||||
Cele 5 credite lunare sunt concepute pentru a vă permite să rulați automatizări fără să vă faceți griji în privința costurilor. Pentru majoritatea fluxurilor de lucru care folosesc acțiuni standard, acest lucru este mai mult decât suficient. Veți avea nevoie de credite suplimentare doar atunci când rulați noduri de cod avansate sau funcționalități bazate pe AI.
|
||||
Pentru majoritatea echipelor, automatizările standard sunt practic gratuite — soldul va începe să scadă vizibil doar atunci când vă bazați pe funcțiile AI sau rulați noduri de cod intensive. Asta este intenția: creditele incluse sunt gândite astfel încât să puteți construi fără să urmăriți constant un contor.
|
||||
</Note>
|
||||
|
||||
## Cum este contorizată utilizarea AI
|
||||
|
||||
Când o acțiune apelează un model AI, măsurăm exact jetoanele utilizate și le tarifăm la **tarifele publicate de furnizorul modelului**, apoi convertim suma respectivă în dolari direct în credite — astfel încât ceea ce cheltuiți să reflecte costul real al execuției, nu un tarif intern majorat. Un mesaj scurt în chat costă o fracțiune de cent. O sarcină mare pentru un agent — de exemplu, configurarea a zece obiecte din spațiul de lucru — face multe apeluri de model peste un context în creștere, astfel încât poate ajunge la un dolar sau mai mult. Plătiți pentru ceea ce folosiți efectiv, până la nivel de jeton.
|
||||
|
||||
Costul variază în funcție de model: un model ușor este considerabil mai ieftin pe mesaj decât un model de raționare de vârf. Puteți vedea defalcarea pe acțiuni — inclusiv ce model a fost folosit — în **Setări → Facturare**.
|
||||
|
||||
## Ce este inclus
|
||||
|
||||
Fiecare abonament include credite, iar cantitatea depinde de **ciclul de facturare**, nu de plan:
|
||||
|
||||
| Ciclu de facturare | Credite incluse | Utilizare echivalentă |
|
||||
| ------------------ | --------------- | -------------------------------- |
|
||||
| Lunar | 5 / lună | ~$5 de utilizare în fiecare lună |
|
||||
| Anual | 50 / an | ~$50 de utilizare în fiecare an |
|
||||
|
||||
Aceste credite sunt concepute pentru a acoperi confortabil automatizările de zi cu zi. Cinci credite acoperă zeci de mii de pași de automatizare standard sau sute de mesaje AI rapide — însă câteva sarcini mari, cu mai mulți pași, executate de agenți pot consuma creditele mai repede. Puteți suplimenta în orice moment (vedeți mai jos).
|
||||
|
||||
## Reportare de credite
|
||||
|
||||
Creditele neutilizate la sfârșitul unei perioade de facturare sunt reportate automat în perioada următoare.
|
||||
Creditele neutilizate se reportează automat în următoarea perioadă de facturare.
|
||||
|
||||
* **Limită**: Suma reportată este limitată la alocarea completă a unei perioade, astfel încât nu veți putea reporta mai multe credite decât oferă planul dvs. pe perioadă.
|
||||
* **Vizibilitate**: Când există credite reportate, acestea apar ca o linie separată **Credite reportate** în **Setări → Facturare**, alături de un sold **Total disponibil**.
|
||||
|
||||
## Consumul de credite
|
||||
|
||||
Acțiunile diferite consumă cantități diferite de credite:
|
||||
|
||||
| Tip de acțiune | Utilizare credit |
|
||||
| --------------------------------------------------------------------- | --------------------------------- |
|
||||
| **Operațiuni de bază** (căutare, actualizare, creare de înregistrări) | Minim |
|
||||
| **Operațiuni complexe** (noduri de cod, apeluri API externe) | Mai multe credite |
|
||||
| **Prompturi AI și chaturi AI** | Variabil, în funcție de utilizare |
|
||||
|
||||
Creditele sunt retrase în timp real când se execută fluxurile de lucru.
|
||||
* **Limită**: Reportarea este limitată la alocarea completă pentru o perioadă, astfel încât nu veți putea reporta mai multe credite decât oferă planul pe perioadă.
|
||||
* **Vizibilitate**: Când există credite reportate, acestea apar ca o linie separată **Credite reportate** în **Setări → Facturare**, alături de soldul **Total disponibil**.
|
||||
|
||||
## Monitorizarea utilizării
|
||||
|
||||
Urmăriți consumul de credite:
|
||||
Urmăriți-vă soldul și destinația acestuia:
|
||||
|
||||
1. Accesați **Setări → Facturare**
|
||||
2. Vizualizați utilizarea curentă și creditele rămase
|
||||
3. Monitorizați tendințele pentru a planifica credite suplimentare, dacă este necesar
|
||||
2. Vedeți **creditele rămase** și **utilizarea pentru perioada curentă**
|
||||
3. Explorați detalierea pentru a vedea care fluxuri de lucru și acțiuni AI consumă credite — și ce modele au fost utilizate de acțiunile AI
|
||||
|
||||
## Achiziționarea de credite suplimentare
|
||||
Revizuirea regulată a acestor date face ușoară identificarea din timp a unui flux de lucru intensiv și decizia dacă să îl optimizați sau să suplimentați creditele.
|
||||
|
||||
Aveți nevoie de mai multe credite?
|
||||
## Aveți nevoie de mai multe credite?
|
||||
|
||||
Dacă rămâneți fără credite — sau doriți un buffer înainte de o campanie mare de automatizare — puteți cumpăra oricând pachete suplimentare de credite:
|
||||
|
||||
1. Accesați **Setări → Facturare**
|
||||
2. Faceți clic pe opțiunea de a achiziționa pachete de credite suplimentare
|
||||
2. Alegeți să **achiziționați credite suplimentare**
|
||||
3. Selectați cantitatea de care aveți nevoie
|
||||
|
||||
Creditele achiziționate sunt adăugate imediat la soldul disponibil.
|
||||
|
||||
@@ -261,6 +261,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
Идентификатор — это `universalIdentifier` резолвера из вашего манифеста. Зарегистрируйте этот URL у поставщика.
|
||||
|
||||
<Note>
|
||||
**Приложение должно быть закреплено и установлено в рабочем пространстве владельца.** Поскольку резолвер выполняется в **рабочем пространстве владельца** (рабочем пространстве, которому принадлежит регистрация приложения), триггер серверного маршрута будет работать только после того, как приложение будет *закреплено* — то есть у него появится рабочее пространство владельца — **и** это приложение будет **установлено в рабочем пространстве владельца**. Пока оба этих условия не выполнены, резолверу негде выполняться, поэтому маршрут не может быть отправлен на обработку. Приложение, которое предоставляет логическую функцию `serverRouteTriggerSettings`, соответственно, не может быть размещено в маркетплейсе, пока оно не будет закреплено и установлено в рабочем пространстве владельца.
|
||||
</Note>
|
||||
|
||||
**Контракт резолвера.** Тип `LogicFunctionConfig` в SDK обеспечивает это на этапе компиляции: как только вы задаете `serverRouteTriggerSettings`, ваш обработчик обязан возвращать `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (или `Promise` этого объекта). `workspaceId` должен указывать на рабочее пространство, в котором установлена целевая функция, иначе запрос будет отклонен с кодом `404`.
|
||||
|
||||
| Поле | Тип | Заметки |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Кредиты
|
||||
description: Как кредиты обеспечивают работу рабочих процессов, агентов ИИ и ИИ-чат-бота — и как управлять балансом.
|
||||
description: Один простой баланс, который обеспечивает работу ваших рабочих процессов, AI-агентов и AI-чата — сколько стоит один кредит, насколько его хватает и как им управлять.
|
||||
---
|
||||
|
||||
## Обзор
|
||||
## Что такое кредиты?
|
||||
|
||||
Кредиты обеспечивают работу автоматизаций рабочих процессов и возможностей ИИ. Они расходуются при выполнении действий рабочих процессов, когда агенты ИИ обрабатывают задачи внутри рабочих процессов и в чате ИИ.
|
||||
Кредиты — это единый баланс, который оплачивает всё, что мы запускаем от вашего имени и что имеет реальную стоимость: **автоматизации рабочих процессов**, **AI‑агенты** и **AI‑чат**. Вместо того чтобы жонглировать раздельными квотами для «запусков автоматизации» и «AI‑токенов», у вас есть один простой баланс, за которым нужно следить.
|
||||
|
||||
## Распределение кредитов
|
||||
**1 кредит = $1 использования.** Кредит — это просто доллар работы, поэтому с вашим балансом легко разобраться — никаких абстрактных единиц для пересчёта.
|
||||
|
||||
Кредиты привязаны к вашему платёжному циклу, а не к плану:
|
||||
## Насколько хватает одного кредита?
|
||||
|
||||
| Платёжный цикл | Кредиты |
|
||||
| -------------- | ------- |
|
||||
| Ежемесячно | 5/месяц |
|
||||
| Ежегодно | 50/год |
|
||||
Стоимость масштабируется вместе с объемом работы. Повседневные автоматизации и быстрые AI‑сообщения стоят крошечную долю кредита; крупные, многошаговые задачи AI‑агента стоят дороже. Примерно это выглядит так:
|
||||
|
||||
| Что вы делаете | Примерная стоимость | Что это означает |
|
||||
| -------------------------------------------------------------------------------------------- | ------------------------------------- | --------------------------------------- |
|
||||
| Выполнить стандартный шаг рабочего процесса (поиск, создание, обновление записей) | ~$0.0001 | Около **10 000 шагов на один кредит** |
|
||||
| Вызвать внешнее API или выполнить узел с кодом | Небольшая доля кредита | Тысячи на один кредит |
|
||||
| Отправить быстрое AI‑сообщение в чате или простой AI‑шаг | Доля цента | Сотни на один кредит |
|
||||
| Выполнить крупную задачу AI‑агента (например, «настроить 10 объектов рабочего пространства») | Может стоить **~$1 или больше** | Несколько на один кредит |
|
||||
| Выполнить AI‑поиск в интернете | Фиксированная стоимость за один поиск | Сотни поисковых запросов на один кредит |
|
||||
|
||||
<Note>
|
||||
5 кредитов в месяц позволяют вам запускать автоматизации, не беспокоясь о расходах. Для большинства рабочих процессов, использующих стандартные действия, этого более чем достаточно. Дополнительные кредиты понадобятся только при запуске продвинутых узлов с кодом или функций на базе ИИ.
|
||||
Для большинства команд стандартные автоматизации фактически бесплатны — заметное снижение баланса произойдет только тогда, когда вы активно используете AI‑функции или запускаете ресурсоемкие узлы с кодом. Так задумано: включенные кредиты предназначены для того, чтобы вы могли создавать решения, не следя за счетчиком.
|
||||
</Note>
|
||||
|
||||
## Как учитывается использование AI
|
||||
|
||||
Когда действие вызывает AI‑модель, мы измеряем точное количество использованных токенов и оцениваем их по **опубликованным тарифам поставщика модели**, затем конвертируем эту сумму в долларах напрямую в кредиты — так что ваши расходы отражают реальную стоимость работы, а не внутренний тариф с наценкой. Короткое сообщение в чате стоит долю цента. Крупная задача агента — например, настройка десяти объектов рабочего пространства — делает много запросов к модели по мере роста контекста, поэтому ее стоимость может достигать доллара или больше. С вас берется плата только за фактическое использование, до уровня отдельного токена.
|
||||
|
||||
Стоимость зависит от модели: легковесная модель значительно дешевле за сообщение, чем топовая модель для сложных рассуждений. Вы можете увидеть детализацию по каждому действию — включая используемую модель — в **Настройки → Биллинг**.
|
||||
|
||||
## Что включено
|
||||
|
||||
Каждая подписка включает кредиты, и их количество зависит от **платежного периода**, а не от тарифного плана:
|
||||
|
||||
| Платёжный цикл | Включенные кредиты | Эквивалент использования |
|
||||
| -------------- | ------------------ | ------------------------------ |
|
||||
| Ежемесячно | 5 / месяц | ~$5 использования каждый месяц |
|
||||
| Ежегодно | 50 / год | ~$50 использования каждый год |
|
||||
|
||||
Эти кредиты рассчитаны на то, чтобы с запасом покрывать повседневную автоматизацию. Пяти кредитов хватает на десятки тысяч стандартных шагов автоматизации или сотни быстрых AI‑сообщений — хотя несколько крупных, многошаговых задач агента могут израсходовать их быстрее. Вы можете пополнить баланс в любой момент (см. ниже).
|
||||
|
||||
## Перенос кредитов
|
||||
|
||||
Неиспользованные кредиты в конце расчетного периода автоматически переносятся на следующий период.
|
||||
Неиспользованные кредиты автоматически переносятся на следующий платежный период.
|
||||
|
||||
* **Ограничение**: Сумма переноса ограничена полным объемом за один период, поэтому вы не сможете перенести больше кредитов, чем предусмотрено вашим планом за период.
|
||||
* **Видимость**: Когда доступны перенесенные кредиты, они отображаются отдельной строкой **Перенесенные кредиты** в **Настройки → Биллинг**, рядом с балансом **Всего доступно**.
|
||||
|
||||
## Потребление кредитов
|
||||
|
||||
Разные действия потребляют разное количество кредитов:
|
||||
|
||||
| Тип действия | Использование кредитов |
|
||||
| ---------------------------------------------------------- | ------------------------------------------ |
|
||||
| **Базовые операции** (поиск, обновление, создание записей) | Минимальное |
|
||||
| **Сложные операции** (узлы с кодом, внешние вызовы API) | Больше кредитов |
|
||||
| **ИИ-промпт и ИИ-чаты** | Варьируется в зависимости от использования |
|
||||
|
||||
Кредиты списываются в режиме реального времени при выполнении рабочих процессов.
|
||||
* **Ограничение**: Перенос ограничен полным объемом за один период, поэтому вы не сможете перенести больше кредитов, чем предусмотрено вашим планом за период.
|
||||
* **Видимость**: Когда у вас есть перенесенные кредиты, они отображаются отдельной строкой **Перенесенные кредиты** в **Настройки → Биллинг**, рядом с балансом **Всего доступно**.
|
||||
|
||||
## Отслеживание использования
|
||||
|
||||
Отслеживайте своё потребление кредитов:
|
||||
Следите за своим балансом и тем, на что он расходуется:
|
||||
|
||||
1. Перейдите в **Настройки → Оплата**
|
||||
2. Просматривайте текущее использование и остаток кредитов
|
||||
3. Отслеживайте тенденции, чтобы при необходимости планировать дополнительные кредиты
|
||||
2. Посмотрите свои **оставшиеся кредиты** и **использование за текущий период**
|
||||
3. Изучите детализацию, чтобы увидеть, какие рабочие процессы и AI‑действия расходуют кредиты — и какие модели использовали эти AI‑действия
|
||||
|
||||
## Приобретение дополнительных кредитов
|
||||
Регулярный просмотр этой информации помогает вовремя заметить ресурсоемкий рабочий процесс и решить, оптимизировать ли его или пополнить баланс.
|
||||
|
||||
Нужно больше кредитов?
|
||||
## Нужно больше кредитов?
|
||||
|
||||
Если кредиты закончились — или вы хотите иметь запас перед крупным запуском автоматизаций — вы можете в любой момент купить дополнительные пакеты кредитов:
|
||||
|
||||
1. Перейдите в **Настройки → Оплата**
|
||||
2. Нажмите на опцию, чтобы приобрести дополнительные пакеты кредитов
|
||||
2. Выберите вариант **Приобрести дополнительные кредиты**
|
||||
3. Выберите нужное количество
|
||||
|
||||
Приобретенные кредиты сразу же добавляются к вашему доступному балансу.
|
||||
|
||||
@@ -262,6 +262,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
Tanımlayıcı, manifest'inizdeki resolver'ın `universalIdentifier` değeridir. Bu URL’yi sağlayıcıya kaydedin.
|
||||
|
||||
<Note>
|
||||
**Uygulama, sahip çalışma alanında sahiplenilip kurulmalıdır.** Çözücü **sahip çalışma alanında** (uygulama kaydına sahip olan çalışma alanı) çalıştığı için, bir sunucu rota tetikleyicisi yalnızca uygulama *sahiplenildikten* — yani bir sahip çalışma alanına sahiptir — **ve** o uygulama **sahip çalışma alanına kurulduğunda** çalışır. Her ikisi de doğru olana kadar çözücünün çalışacağı bir yer yoktur, bu yüzden rota çalıştırılamaz. Bu nedenle, `serverRouteTriggerSettings` mantık işlevini sunan bir uygulama, sahip çalışma alanında sahiplenilip kurulana kadar pazaryerinde listelenemez.
|
||||
</Note>
|
||||
|
||||
**Resolver sözleşmesi.** SDK'nin `LogicFunctionConfig` türü bunu derleme zamanında zorunlu kılar: `serverRouteTriggerSettings`'i ayarladığınız anda, işleyicinizin `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (veya bunun bir `Promise`'i) döndürmesi gerekir. `workspaceId`, hedef fonksiyonun kurulu olduğu bir çalışma alanı olmalıdır, aksi takdirde istek `404` ile reddedilir.
|
||||
|
||||
| Alan | Tür | Notlar |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: Krediler
|
||||
description: Kredilerin iş akışlarına, AI ajanlarına ve AI sohbet botuna nasıl güç verdiğini — ve bakiyenizi nasıl yöneteceğinizi anlamak.
|
||||
description: İş akışlarınızı, yapay zeka ajanlarınızı ve yapay zeka sohbetini çalıştıran tek, basit bir bakiye — bir kredinin değeri, ne kadar yeter ve nasıl yönetileceği.
|
||||
---
|
||||
|
||||
## Genel Bakış
|
||||
## Krediler nedir?
|
||||
|
||||
Krediler, iş akışı otomasyonlarına ve AI yeteneklerine güç verir. Bunlar, iş akışı eylemleri yürütüldüğünde, AI ajanları iş akışları içinde görevleri işlerken ve AI sohbetinde harcanır.
|
||||
Krediler, sizin adınıza çalıştırdığımız ve gerçek bir maliyeti olan her şeyi güçlendiren tek bir bakiyedir: **iş akışı otomasyonları**, **yapay zeka ajanları** ve **yapay zeka sohbeti**. "otomasyon çalıştırmaları" ve "yapay zeka token'ları" için ayrı kotalarla uğraşmak yerine, takip edeceğiniz tek ve basit bir bakiyeniz olur.
|
||||
|
||||
## Kredi Tahsisi
|
||||
**1 kredi = $1 kullanım.** Kredi yalnızca bir dolarlık iştir, bu nedenle bakiyenizi anlamak kolaydır — dönüştürmeniz gereken soyut birim yoktur.
|
||||
|
||||
Krediler planınıza değil, faturalandırma döngünüze göre belirlenir:
|
||||
## Bir kredi ne kadar yeter?
|
||||
|
||||
| Faturalandırma Döngüsü | Krediler |
|
||||
| ---------------------- | -------- |
|
||||
| Aylık | 5/ay |
|
||||
| Yıllık | 50/yıl |
|
||||
Maliyet yapılan iş ile birlikte ölçeklenir. Gündelik otomasyonlar ve hızlı yapay zeka mesajları bir kredinin çok küçük bir kısmına mal olur; büyük, çok adımlı yapay zeka ajan görevleri daha fazla tutar. Kabaca tablo şöyle:
|
||||
|
||||
| Ne yaparsınız | Yaklaşık maliyet | Ne anlama gelir |
|
||||
| ----------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------- |
|
||||
| Standart bir iş akışı adımı çalıştırın (arama, kayıt oluşturma, kayıt güncelleme) | ~$0.0001 | Kredi başına yaklaşık **10.000 adım** |
|
||||
| Harici bir API çağırın veya bir kod düğümü çalıştırın | Bir kredinin küçük bir kısmı | Kredi başına binlerce |
|
||||
| Hızlı bir yapay zeka sohbet mesajı veya basit bir yapay zeka adımı gönderin | Sentin bir kısmı | Kredi başına yüzlerce |
|
||||
| Büyük bir yapay zeka ajan görevi çalıştırın (ör. "10 çalışma alanı nesnesini yapılandır") | **~$1 veya daha fazlasına** çıkabilir | Kredi başına birkaç tane |
|
||||
| Bir yapay zeka web araması çalıştırın | Arama başına sabit maliyet | Kredi başına yüzlerce arama |
|
||||
|
||||
<Note>
|
||||
Aylık 5 kredi, maliyetleri dert etmeden otomasyonları çalıştırabilmenizi sağlamak üzere tasarlanmıştır. Standart eylemler kullanan çoğu iş akışı için bu fazlasıyla yeterlidir. Yalnızca gelişmiş kod düğümlerini veya yapay zeka destekli özellikleri çalıştırırken ek krediye ihtiyaç duyarsınız.
|
||||
Çoğu ekip için, standart otomasyonlar fiilen ücretsizdir — bakiyenizde fark edilir bir azalma yalnızca yapay zeka özelliklerine yüklendiğinizde veya ağır kod düğümleri çalıştırdığınızda olur. Bu, tasarım gereğidir: dahil edilen krediler, bir sayaç izlemeden geliştirme yapabilmeniz için tasarlanmıştır.
|
||||
</Note>
|
||||
|
||||
## Kredi Devri
|
||||
## Yapay zeka kullanımı nasıl ölçülür
|
||||
|
||||
Fatura döneminin sonunda kullanılmayan krediler otomatik olarak bir sonraki döneme devredilir.
|
||||
Bir eylem bir yapay zeka modelini çağırdığında, kullanılan tam token sayısını ölçer ve bunları **model sağlayıcısının yayımlanmış tarifeleri** üzerinden fiyatlandırırız, ardından bu dolar tutarını doğrudan kredilere çeviririz — böylece harcamanız, şişirilmiş bir dahili oran yerine işin gerçek maliyetiyle bire bir örtüşür. Kısa bir sohbet mesajı sentin bir kısmına mal olur. Büyük bir ajan görevi — örneğin on çalışma alanı nesnesini yapılandırmak — büyüyen bir bağlam üzerinde birçok model çağrısı yapar, bu nedenle bir dolar veya daha fazlasına kadar çıkabilir. Kullandığınız her şey için, token seviyesine kadar ayrıntılı olarak ücretlendirilirsiniz.
|
||||
|
||||
* **Üst sınır**: Devir tutarı, bir dönemin tam tahsisatı ile sınırlandırılır; bu nedenle planınızın dönem başına sağladığından daha fazla krediyi asla devredemezsiniz.
|
||||
* **Görünürlük**: Devir kredileri mevcut olduğunda, **Ayarlar → Faturalandırma** bölümünde **Devreden Krediler** olarak ayrı bir satırda görünür ve **Toplam Kullanılabilir** bakiyenin yanında yer alır.
|
||||
Maliyet modele göre değişir: hafif bir model, üst seviye bir muhakeme modeline kıyasla mesaj başına çok daha ucuzdur. **Ayarlar → Faturalandırma** bölümünde, hangi modelin kullanıldığını da içeren eylem başına dökümü görebilirsiniz.
|
||||
|
||||
## Kredi Tüketimi
|
||||
## Neler dahil
|
||||
|
||||
Farklı eylemler farklı miktarlarda kredi tüketir:
|
||||
Her aboneliğe krediler dahildir ve tutar, planınıza değil **faturalandırma döngünüze** bağlıdır:
|
||||
|
||||
| Eylem Türü | Kredi Kullanımı |
|
||||
| ----------------------------------------------------------- | ---------------- |
|
||||
| **Temel işlemler** (arama, güncelleme, kayıt oluşturma) | Minimum |
|
||||
| **Karmaşık işlemler** (kod düğümleri, harici API çağrıları) | Daha fazla kredi |
|
||||
| **AI istemi & AI sohbetleri** | Kullanıma bağlı |
|
||||
| Faturalandırma Döngüsü | Dahil Edilen Krediler | Eşdeğer kullanım |
|
||||
| ---------------------- | --------------------- | ------------------------------ |
|
||||
| Aylık | 5 / ay | Her ay yaklaşık ~$5 kullanım |
|
||||
| Yıllık | 50 / yıl | Her yıl yaklaşık ~$50 kullanım |
|
||||
|
||||
Krediler, iş akışları yürütülürken gerçek zamanlı olarak düşer.
|
||||
Bu krediler, günlük otomasyonu rahatça karşılayacak şekilde tasarlanmıştır. Beş kredi, on binlerce standart otomasyon adımını veya yüzlerce hızlı yapay zeka mesajını kapsar — ancak birkaç büyük, çok adımlı ajan görevi bunları daha hızlı tüketebilir. İstediğiniz zaman ekleme yapabilirsiniz (aşağıya bakın).
|
||||
|
||||
## Kredi devri
|
||||
|
||||
Kullanılmamış krediler otomatik olarak bir sonraki faturalandırma dönemine devredilir.
|
||||
|
||||
* **Üst sınır**: Devir, bir dönemin tam tahsisatıyla sınırlandırılır; bu nedenle hiçbir zaman planınızın dönem başına sağladığından daha fazla krediyi devredemezsiniz.
|
||||
* **Görünürlük**: Devreden kredileriniz olduğunda, **Ayarlar → Faturalandırma** bölümünde **Devreden Krediler** olarak ayrı bir satırda görünür ve **Toplam Kullanılabilir** bakiyenin yanında yer alır.
|
||||
|
||||
## Kullanımı İzleme
|
||||
|
||||
Kredi tüketiminizi takip edin:
|
||||
Bakiyenizi ve nereye gittiğini takip edin:
|
||||
|
||||
1. **Ayarlar → Faturalama** bölümüne gidin
|
||||
2. Mevcut kullanımınızı ve kalan kredilerinizi görüntüleyin
|
||||
3. Gerekirse ek kredileri planlamak için eğilimleri izleyin
|
||||
2. **Kalan kredilerinizi** ve **mevcut dönem için kullanımınızı** görün
|
||||
3. Hangi iş akışlarının ve yapay zeka eylemlerinin kredi tükettiğini — ve yapay zeka eylemlerinin hangi modelleri kullandığını — görmek için döküme derinlemesine bakın
|
||||
|
||||
## Ek Kredi Satın Alma
|
||||
Bunu düzenli olarak incelemek, yoğun bir iş akışını erken fark etmeyi ve onu optimize edip etmeyeceğinize ya da kredi ekleyip eklemeyeceğinize karar vermeyi kolaylaştırır.
|
||||
|
||||
Daha fazla krediye mi ihtiyacınız var?
|
||||
## Daha fazla krediye mi ihtiyacınız var?
|
||||
|
||||
Eğer krediniz biterse — veya büyük bir otomasyon hamlesi öncesinde tampon oluşturmak isterseniz — istediğiniz zaman ek kredi paketleri satın alabilirsiniz:
|
||||
|
||||
1. **Ayarlar → Faturalama** bölümüne gidin
|
||||
2. Ek kredi paketleri satın alma seçeneğine tıklayın
|
||||
2. **Ek krediler satın almayı** seçin
|
||||
3. İhtiyacınız olan miktarı seçin
|
||||
|
||||
Satın alınan krediler hemen kullanılabilir bakiyenize eklenir.
|
||||
|
||||
@@ -262,6 +262,10 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
|
||||
|
||||
该标识符是清单（manifest）中 resolver 的 `universalIdentifier`。 在服务商处注册该 URL。
|
||||
|
||||
<Note>
|
||||
**应用程序必须在其所属工作区中被认领并安装。** 由于 resolver 在**所属工作区**中运行（即拥有应用程序注册的工作区），服务器路由触发器只有在应用程序已被*认领*——也就是说它已有一个所属工作区——**并且**该应用程序**已安装在所属工作区**之后才会生效。 在这两个条件都满足之前，resolver 无处可运行，因此无法分发该路由。 因此，暴露 `serverRouteTriggerSettings` 逻辑函数的应用程序在被认领并安装到其所属工作区之前，不能在 marketplace 中列出。
|
||||
</Note>
|
||||
|
||||
**Resolver 合约。** SDK 的 `LogicFunctionConfig` 类型在编译时强制执行这一点：一旦你设置了 `serverRouteTriggerSettings`，你的处理程序就被限制为返回 `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }`（或其 `Promise`）。 `workspaceId` 必须是已安装目标函数的工作区，否则请求会以 `404` 被拒绝。
|
||||
|
||||
| 字段 | 类型 | 备注 |
|
||||
|
||||
@@ -1,56 +1,70 @@
|
||||
---
|
||||
title: 积分
|
||||
description: 了解积分如何为工作流程、AI 代理和 AI 聊天机器人提供支持—以及如何管理您的积分余额。
|
||||
description: 一个简单的余额，为你的工作流、AI 代理和 AI 聊天提供支持——涵盖积分的价值、可用范围，以及管理方式。
|
||||
---
|
||||
|
||||
## 概览
|
||||
## 什么是积分？
|
||||
|
||||
积分为工作流程自动化和 AI 功能提供支持。 当工作流程操作执行时、当 AI 代理在工作流程内处理任务时，以及在 AI 聊天中，都会消耗积分。
|
||||
积分是一种统一的余额，用于支付我们代表你运行且实际产生成本的所有内容：**工作流自动化**、**AI 代理** 和 **AI 聊天**。 你无需再同时处理“自动化运行次数”和“AI 令牌”的单独配额，而只需关注一个简单的余额。
|
||||
|
||||
## 积分分配
|
||||
**1 积分 = $1 的用量。** 一个积分就相当于一美元的用量，因此你的余额很好理解——不需要折算任何抽象单位。
|
||||
|
||||
积分以您的计费周期为准，而非您的计划：
|
||||
## 一个积分能用多少？
|
||||
|
||||
| 计费周期 | 积分 |
|
||||
| ---- | ---- |
|
||||
| 每月 | 5/月 |
|
||||
| 每年 | 50/年 |
|
||||
成本会随着工作量而变化。 日常自动化和快速 AI 消息只会消耗极小部分积分；大型的多步骤 AI 代理任务则会消耗更多积分。 大致情况如下：
|
||||
|
||||
| 你要做什么 | 大致花费 | 含义 |
|
||||
| --------------------------------------------------- | ------------------- | ------------------------ |
|
||||
| 运行一个标准工作流步骤（搜索、创建、更新记录） | ~$0.0001 | 大约**每个积分可运行 10,000 个步骤** |
|
||||
| 调用一个外部 API 或运行一个代码节点 | 一个积分的一小部分 | 每个积分可运行数千次 |
|
||||
| 发送一条快速 AI 聊天消息或执行一个简单的 AI 步骤 | 几分之一美分 | 每个积分可运行数百次 |
|
||||
| 运行一个大型 AI 代理任务（例如 "configure 10 workspace objects"） | 成本可能高达 **约 $1 或更多** | 每个积分可运行几次 |
|
||||
| 运行一次 AI 网络搜索 | 按每次搜索收取固定费用 | 每个积分可进行数百次搜索 |
|
||||
|
||||
<Note>
|
||||
每月的 5 个积分旨在让您无需担心成本即可运行自动化。 对于使用标准操作的大多数工作流，这已经绰绰有余。 仅在运行高级代码节点或由 AI 驱动的功能时，您才需要额外积分。
|
||||
对大多数团队来说，标准自动化几乎等同于免费——只有在大量使用 AI 功能或运行高负载代码节点时，你的积分余额才会出现明显消耗。 这是有意为之：包含的积分旨在让你在构建时无需时刻盯着计量表。
|
||||
</Note>
|
||||
|
||||
## AI 使用如何计量
|
||||
|
||||
当某个操作调用 AI 模型时，我们会精确测量所使用的 token 数量，并按**模型提供商公布的费率**计价，然后将该美元金额直接折算为积分——因此你消耗的积分对应的是实际工作成本，而不是经过加价的内部费率。 一条简短的聊天消息只会花费几分之一美分。 一个大型代理任务——例如配置十个工作区对象——会在不断扩大的上下文中进行多次模型调用，因此总成本可能会累积到一美元或更多。 你的计费完全基于实际使用量，精确到单个 token。
|
||||
|
||||
成本会因模型而异：轻量模型每条消息的价格远低于顶级推理模型。 你可以在 **设置 → 账单** 中查看每个操作的详细拆分——包括使用了哪种模型。
|
||||
|
||||
## 包含内容
|
||||
|
||||
每个订阅都包含积分，数量取决于你的**计费周期**，而不是订阅套餐：
|
||||
|
||||
| 计费周期 | 包含的积分 | 等效使用量 |
|
||||
| ---- | ----- | ------------ |
|
||||
| 每月 | 5/月 | 每月约 $5 的使用量 |
|
||||
| 每年 | 50/年 | 每年约 $50 的使用量 |
|
||||
|
||||
这些积分旨在从容覆盖日常自动化。 5 个积分可以覆盖数万次标准自动化步骤或数百条快速 AI 消息——不过少量大型、多步骤代理任务也可能更快用完这些积分。 你可以随时充值（见下文）。
|
||||
|
||||
## 积分结转
|
||||
|
||||
计费周期结束时未使用的积分会自动结转到下一个周期。
|
||||
未使用的积分会自动结转到下一个计费周期。
|
||||
|
||||
* **上限**：结转额度以一个计费周期的完整配额为上限，因此您结转的积分不会超过您的套餐每个周期提供的积分数量。
|
||||
* **可见性**：当结转积分可用时，它们会在**设置 → 账单**中显示为单独的**结转积分**一行，并与**可用总额**余额并列。
|
||||
|
||||
## 积分消耗
|
||||
|
||||
不同的操作会消耗不同数量的积分：
|
||||
|
||||
| 操作类型 | 积分使用情况 |
|
||||
| ------------------------- | -------- |
|
||||
| **基础操作** (搜索、更新、创建记录) | 极少 |
|
||||
| **复杂操作** (代码节点、外部 API 调用) | 更多积分 |
|
||||
| **AI 提示词 & AI 聊天** | 根据使用情况而定 |
|
||||
|
||||
当工作流执行时，积分会实时扣除。
|
||||
* **上限**：结转额度以一个计费周期的完整配额为上限，因此你结转的积分不会超过你的套餐每个周期提供的积分数量。
|
||||
* **可见性**：当结转积分可用时，它们会在 **设置 → 账单** 中显示为单独的 **结转积分** 一行，并与 **可用总额** 余额并列。
|
||||
|
||||
## 监控使用情况
|
||||
|
||||
跟踪您的积分消耗：
|
||||
随时掌握你的积分余额及其去向：
|
||||
|
||||
1. 前往**设置 → 结算**
|
||||
2. 查看您当前的使用量和剩余积分
|
||||
3. 监控趋势，以便在需要时规划额外积分
|
||||
2. 查看你的**剩余积分**和**当前周期的使用量**
|
||||
3. 深入查看明细，了解哪些工作流和 AI 操作在消耗积分，以及这些 AI 操作使用了哪些模型
|
||||
|
||||
## 购买额外的积分
|
||||
定期查看这些信息，可以让你及早发现高负载的工作流，并决定是对其进行优化还是充值。
|
||||
|
||||
需要更多积分吗？
|
||||
## 需要更多积分吗？
|
||||
|
||||
如果你的积分用完了——或者在进行大规模自动化之前想要多一些余量——可以随时购买额外积分包：
|
||||
|
||||
1. 前往**设置 → 结算**
|
||||
2. 点击相应选项购买额外的积分包
|
||||
2. 选择**购买额外积分**
|
||||
3. 选择您需要的数量
|
||||
|
||||
购买的积分会立即计入你的可用余额。
|
||||
|
||||
Reference in New Issue
Block a user