From 6d83018b6f0eef4f873954b308cb1c9bc8e03f90 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 5 Aug 2026 11:25:39 +0200 Subject: [PATCH] i18n - docs translations (#23796) Created by Github action Review in cubic Co-authored-by: github-actions --- .../extend/apps/logic/skills-and-agents.mdx | 20 ++++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 19 +++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 19 +++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 20 ++++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 22 ++++++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 19 +++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 18 ++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 18 ++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 21 +++++++++++++++++- .../extend/apps/logic/skills-and-agents.mdx | 18 ++++++++++++++- 10 files changed, 184 insertions(+), 10 deletions(-) diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/logic/skills-and-agents.mdx index 35228063d9..3c504476f4 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,8 @@ export default defineAgent({ -تتيح `runAgent()` لدالة منطقية تشغيل أحد وكلاء تطبيقك (مع مهاراته وأدواته). عرِّف الوكيل عن طريق `universalIdentifier` الذي مررته إلى `defineAgent()`: +تتيح `runAgent()` لدالة منطقية تشغيل أحد وكلاء تطبيقك (مع مهاراته وأدواته). حدِّد الوكيل بواسطة `universalIdentifier` الذي مررته إلى `defineAgent()`. مرر إما سلسلة `prompt` أو سجل المحادثة `messages` +— وليس كليهما معًا: ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +112,24 @@ const { result, error, success } = await runAgent({ }); ``` +لبوتات المحادثة متعددة الجولات (Slack, Discord, Teams, …)، مرر سجل سلسلة المحادثة كـ +`messages` بدلًا من استخدام `prompt` واحد فقط: + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + النقاط الرئيسية: +* قدِّم **واحدًا فقط** من `prompt` (سلسلة نصية) أو `messages` (من 1 إلى 100 عنصر من `{ role: 'user' | 'assistant', content: string }`). * يعمل الوكيل **بشكل متزامن** ويمكنه قراءة/تحديث السجلات بنفسه عبر أدواته الخاصة — يتم حل `runAgent()` بمجرد اكتمال التشغيل. * لا يمكن للتطبيق تشغيل سوى وكلائه الخاصين. * يجب أن يمنح [الدور الافتراضي](/l/ar/developers/extend/apps/config/roles) للتطبيق علامة الإذن `AI` — أضِف `SystemPermissionFlag.AI` إلى `permissionFlagUniversalIdentifiers` الخاصة به (أو عيِّن `canAccessAllTools: true`). diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/logic/skills-and-agents.mdx index c8eda98bf8..0208389f0c 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,7 @@ Poznámky ke schématu: -`runAgent()` umožňuje logické funkci spustit jednoho z agentů vaší aplikace (s jeho dovednostmi a nástroji). Identifikujte agenta pomocí `universalIdentifier`, který jste předali do `defineAgent()`: +`runAgent()` umožňuje logické funkci spustit jednoho z agentů vaší aplikace (s jeho dovednostmi a nástroji). Identifikujte agenta pomocí `universalIdentifier`, který jste předali do `defineAgent()`. Předejte buď řetězec `prompt`, nebo historii konverzace `messages`, ale ne obojí zároveň: ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +111,24 @@ const { result, error, success } = await runAgent({ }); ``` +U vícekrokových botů (Slack, Discord, Teams, …) předejte historii vlákna jako `messages` místo jednoho `prompt`: + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + Hlavní body: +* Zadejte **přesně jednu** z možností: `prompt` (řetězec) nebo `messages` (1 až 100 položek + `{ role: 'user' | 'assistant', content: string }`). * Agent běží **synchronně** a může sám číst/aktualizovat záznamy pomocí vlastních nástrojů — `runAgent()` vrátí výsledek až po dokončení běhu. * Aplikace může spouštět pouze své vlastní agenty. * [Výchozí role](/l/cs/developers/extend/apps/config/roles) aplikace musí udělovat příznak oprávnění `AI` — přidejte `SystemPermissionFlag.AI` do `permissionFlagUniversalIdentifiers` (nebo nastavte `canAccessAllTools: true`). diff --git a/packages/twenty-docs/l/de/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/de/developers/extend/apps/logic/skills-and-agents.mdx index 1cab1273a4..352d8ff578 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,7 @@ Schema-Hinweise: -`runAgent()` ermöglicht es einer Logikfunktion, einen der Agenten Ihrer App auszuführen (mit seinen Fähigkeiten und Tools). Identifizieren Sie den Agenten über den `universalIdentifier`, den Sie an `defineAgent()` übergeben haben: +`runAgent()` ermöglicht es einer Logikfunktion, einen der Agenten Ihrer App auszuführen (mit seinen Fähigkeiten und Tools). Identifizieren Sie den Agenten über den `universalIdentifier`, den Sie an `defineAgent()` übergeben haben. Übergeben Sie entweder einen `prompt`-String oder einen `messages`-Konversationsverlauf – nicht beides: ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +111,24 @@ const { result, error, success } = await runAgent({ }); ``` +Für Multi-Turn-Bots (Slack, Discord, Teams, …) übergeben Sie den Thread-Verlauf als `messages` anstelle eines einzelnen `prompt`: + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + Hauptpunkte: +* Geben Sie **genau eines** von `prompt` (string) oder `messages` (1 bis 100 Einträge + von `{ role: 'user' | 'assistant', content: string }`) an. * Der Agent wird **synchron** ausgeführt und kann selbst Datensätze über seine eigenen Tools lesen/aktualisieren — `runAgent()` wird aufgelöst, sobald die Ausführung abgeschlossen ist. * Eine App kann nur ihre eigenen Agenten ausführen. * Die [Standardrolle](/l/de/developers/extend/apps/config/roles) der App muss das Berechtigungsflag `AI` gewähren — fügen Sie `SystemPermissionFlag.AI` zu ihren `permissionFlagUniversalIdentifiers` hinzu (oder setzen Sie `canAccessAllTools: true`). diff --git a/packages/twenty-docs/l/es/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/es/developers/extend/apps/logic/skills-and-agents.mdx index 0f55371476..36911e4e1d 100644 --- a/packages/twenty-docs/l/es/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/es/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,8 @@ Notas sobre el esquema: -`runAgent()` permite que una función de lógica ejecute uno de los agentes de tu app (con sus skills y tools). Identifica el agente mediante el `universalIdentifier` que pasaste a `defineAgent()`: +`runAgent()` permite que una función de lógica ejecute uno de los agentes de tu app (con sus skills y tools). Identifica el agente mediante el `universalIdentifier` que pasaste a `defineAgent()`. Pasa una cadena `prompt` o un historial de la conversación +en `messages`, pero no ambos: ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +112,24 @@ const { result, error, success } = await runAgent({ }); ``` +Para bots de múltiples turnos (Slack, Discord, Teams, …), pasa el historial del hilo como `messages` en lugar de un solo `prompt`: + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + Puntos clave: +* Proporciona **exactamente uno** de `prompt` (cadena) o `messages` (de 1 a 100 entradas + de `{ role: 'user' | 'assistant', content: string }`). * El agente se ejecuta **sincrónicamente** y puede leer/actualizar registros por sí mismo mediante sus propias tools; `runAgent()` se resuelve una vez que la ejecución finaliza. * Una app solo puede ejecutar sus propios agentes. * El [rol predeterminado](/l/es/developers/extend/apps/config/roles) de la app debe conceder el indicador de permiso `AI`; agrega `SystemPermissionFlag.AI` a sus `permissionFlagUniversalIdentifiers` (o establece `canAccessAllTools: true`). diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/logic/skills-and-agents.mdx index 1f0463833b..2f1db88566 100644 --- a/packages/twenty-docs/l/fr/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/fr/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,9 @@ Remarques sur le schéma : -`runAgent()` permet à une fonction logique d'exécuter l'un des agents de votre application (avec ses compétences et ses outils). Identifiez l'agent par le `universalIdentifier` que vous avez passé à `defineAgent()` : +`runAgent()` permet à une fonction logique d'exécuter l'un des agents de votre application (avec ses compétences et ses outils). Identifiez l'agent à l'aide du `universalIdentifier` que vous avez passé +à `defineAgent()`. Passez soit une chaîne de caractères `prompt`, soit un historique de conversation `messages`, +mais pas les deux : ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +113,25 @@ const { result, error, success } = await runAgent({ }); ``` +Pour les bots multi-tours (Slack, Discord, Teams, …), passez l'historique du fil de discussion en +`messages` au lieu d'un seul `prompt` : + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + Points clés : +* Fournissez **exactement l'un des deux** : `prompt` (string) ou `messages` (1 à 100 entrées + de `{ role: 'user' | 'assistant', content: string }`). * L'agent s'exécute **de manière synchrone** et peut lire/mettre à jour lui-même des enregistrements via ses propres outils — `runAgent()` se résout une fois l'exécution terminée. * Une application ne peut exécuter que ses propres agents. * Le [rôle par défaut](/l/fr/developers/extend/apps/config/roles) de l'application doit accorder l'indicateur d'autorisation `AI` — ajoutez `SystemPermissionFlag.AI` à ses `permissionFlagUniversalIdentifiers` (ou définissez `canAccessAllTools: true`). diff --git a/packages/twenty-docs/l/it/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/it/developers/extend/apps/logic/skills-and-agents.mdx index b5d0f14f28..6029afb425 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,7 @@ Note sullo schema: -`runAgent()` permette a una funzione di logica di eseguire uno degli agenti della tua app (con le sue skill e i suoi strumenti). Identifica l'agente tramite l'`universalIdentifier` che hai passato a `defineAgent()`: +`runAgent()` permette a una funzione di logica di eseguire uno degli agenti della tua app (con le sue skill e i suoi strumenti). Identifica l'agente tramite l'`universalIdentifier` che hai passato a `defineAgent()`. Passa una stringa `prompt` oppure una cronologia di conversazione `messages`, ma non entrambe: ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +111,24 @@ const { result, error, success } = await runAgent({ }); ``` +Per bot multi-turno (Slack, Discord, Teams, …), passa la cronologia del thread come `messages` invece di un singolo `prompt`: + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + Punti chiave: +* Fornisci **esattamente uno** tra `prompt` (string) o `messages` (da 1 a 100 elementi + di `{ role: 'user' | 'assistant', content: string }`). * L'agente viene eseguito in modo **sincrono** e può leggere/aggiornare direttamente i record tramite i propri strumenti — `runAgent()` viene risolta una volta completata l'esecuzione. * Un'app può eseguire solo i propri agenti. * Il [ruolo predefinito](/l/it/developers/extend/apps/config/roles) dell'app deve concedere il flag di autorizzazione `AI` — aggiungi `SystemPermissionFlag.AI` ai suoi `permissionFlagUniversalIdentifiers` (oppure imposta `canAccessAllTools: true`). diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/logic/skills-and-agents.mdx index cf592be8b6..b50cc39228 100644 --- a/packages/twenty-docs/l/ja/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/ja/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,7 @@ export default defineAgent({ -`runAgent()` を使用すると、ロジック関数からアプリのエージェント（そのスキルやツールを含む）を実行できます。 `defineAgent()` に渡した `universalIdentifier` でエージェントを識別します: +`runAgent()` を使用すると、ロジック関数からアプリのエージェント（そのスキルやツールを含む）を実行できます。 `defineAgent()` に渡した `universalIdentifier` でエージェントを識別します。 `prompt` 文字列または会話履歴である `messages` のいずれか一方のみを渡してください。両方は渡さないでください。 ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +111,23 @@ const { result, error, success } = await runAgent({ }); ``` +マルチターンのボット (Slack、Discord、Teams など) の場合は、単一の `prompt` ではなく、スレッド履歴を `messages` として渡してください。 + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + 主なポイント： +* `prompt` (string) または `messages`（1～100 個の `{ role: 'user' | 'assistant', content: string }` エントリ）のうち、**ちょうど一つだけ**を指定してください。 * エージェントは**同期的に**実行され、自身のツールを通じてレコードの読み取り/更新ができます。`runAgent()` は、実行が完了すると解決されます。 * アプリは自分自身のエージェントのみを実行できます。 * アプリの[デフォルトロール](/l/ja/developers/extend/apps/config/roles)には `AI` パーミッションフラグが付与されている必要があります — その `permissionFlagUniversalIdentifiers` に `SystemPermissionFlag.AI` を追加するか（または `canAccessAllTools: true` を設定します）。 diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/logic/skills-and-agents.mdx index b858c2bd33..b1ce1f0ca7 100644 --- a/packages/twenty-docs/l/ko/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/ko/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,7 @@ export default defineAgent({ -`runAgent()`를 사용하면 로직 함수가 앱의 에이전트(해당 skills 및 tools 포함) 중 하나를 실행할 수 있습니다. `defineAgent()`에 전달했던 `universalIdentifier`로 에이전트를 식별합니다: +`runAgent()`를 사용하면 로직 함수가 앱의 에이전트(해당 skills 및 tools 포함) 중 하나를 실행할 수 있습니다. `defineAgent()`에 전달한 `universalIdentifier`로 에이전트를 식별하세요: `prompt` 문자열 또는 `messages` 대화 기록 중 하나만 전달하고, 둘 다 전달하지는 마세요: ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +111,23 @@ const { result, error, success } = await runAgent({ }); ``` +멀티 턴 봇(Slack, Discord, Teams 등)의 경우, 단일 `prompt` 대신 스레드 기록을 `messages`로 전달하세요: + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + 핵심 요점: +* `prompt`(문자열) 또는 `messages`(1개에서 100개의 `{ role: 'user' | 'assistant', content: string }` 항목) 중 **정확히 하나만** 제공해야 합니다. * 에이전트는 **동기적으로** 실행되며, 자체 tools를 통해 레코드를 읽고/업데이트할 수 있습니다. 실행이 완료되면 `runAgent()`가 resolve됩니다. * 앱은 자신의 에이전트만 실행할 수 있습니다. * 앱의 [기본 역할](/l/ko/developers/extend/apps/config/roles)은 `AI` 권한 플래그를 부여해야 합니다. 이를 위해 `permissionFlagUniversalIdentifiers`에 `SystemPermissionFlag.AI`를 추가하거나, `canAccessAllTools: true`로 설정하세요. diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/logic/skills-and-agents.mdx index a915e1b76a..86031b18e9 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,8 @@ Note despre schemă: -`runAgent()` permite unei funcții logice să ruleze unul dintre agenții aplicației tale (cu abilitățile și instrumentele sale). Identifică agentul prin `universalIdentifier` pe care l-ai transmis către `defineAgent()`: +`runAgent()` permite unei funcții logice să ruleze unul dintre agenții aplicației tale (cu abilitățile și instrumentele sale). Identifică agentul prin `universalIdentifier` pe care l-ai transmis către `defineAgent()`. Transmite fie un șir `prompt`, fie un istoric de conversație `messages`, +nu ambele: ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +112,25 @@ const { result, error, success } = await runAgent({ }); ``` +Pentru boți multi-turn (Slack, Discord, Teams, …), transmite istoricul firului de discuție ca +`messages` în loc de un singur `prompt`: + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + Puncte cheie: +* Furnizează **exact unul** dintre `prompt` (șir) sau `messages` (1 până la 100 de intrări + de `{ role: 'user' | 'assistant', content: string }`). * Agentul rulează **sincron** și poate citi/actualiza direct înregistrări prin propriile sale instrumente — `runAgent()` este rezolvat după ce rularea se încheie. * O aplicație poate rula doar propriii săi agenți. * [Rolul implicit](/l/ro/developers/extend/apps/config/roles) al aplicației trebuie să acorde indicatorul de permisiune `AI` — adaugă `SystemPermissionFlag.AI` la `permissionFlagUniversalIdentifiers` (sau setează `canAccessAllTools: true`). diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/logic/skills-and-agents.mdx index ccf37fc669..7d450da743 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/logic/skills-and-agents.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/logic/skills-and-agents.mdx @@ -100,7 +100,7 @@ export default defineAgent({ -`runAgent()`, bir mantık işlevinin uygulamanızın ajanlarından birini (kendi yetenekleri ve araçlarıyla) çalıştırmasına olanak tanır. Ajanı, `defineAgent()` işlevine ilettiğiniz `universalIdentifier` ile belirleyin: +`runAgent()`, bir mantık işlevinin uygulamanızın ajanlarından birini (kendi yetenekleri ve araçlarıyla) çalıştırmasına olanak tanır. Ajanı, `defineAgent()` işlevine ilettiğiniz `universalIdentifier` ile belirleyin: Ya bir `prompt` dizesi ya da bir `messages` konuşma geçmişi iletin — ikisini birden değil: ```ts src/logic-functions/run-enricher.ts import { runAgent } from 'twenty-sdk/logic-function'; @@ -111,7 +111,23 @@ const { result, error, success } = await runAgent({ }); ``` +Çok turlu botlar (Slack, Discord, Teams, …) için, tek bir `prompt` yerine iş parçacığı geçmişini `messages` olarak iletin: + +```ts src/logic-functions/reply-in-thread.ts +import { runAgent } from 'twenty-sdk/logic-function'; + +const { result, error, success } = await runAgent({ + agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123', + messages: [ + { role: 'user', content: 'Who owns Acme?' }, + { role: 'assistant', content: 'Sarah owns the Acme account.' }, + { role: 'user', content: 'What was the last touchpoint?' }, + ], +}); +``` + Önemli noktalar: +* `prompt` (string) veya `messages`'tan (1 ila 100 adet `{ role: 'user' | 'assistant', content: string }` girişi) **yalnızca birini** sağlayın. * Ajan **senkron** olarak çalışır ve kendi araçları aracılığıyla kayıtları kendisi okuyup/güncelleyebilir — işlem tamamlandığında `runAgent()` çözümlenir. * Bir uygulama yalnızca kendi ajanlarını çalıştırabilir. * Uygulamanın [varsayılan rolü](/l/tr/developers/extend/apps/config/roles), `AI` izin bayrağını vermelidir — `permissionFlagUniversalIdentifiers` içine `SystemPermissionFlag.AI` ekleyin (veya `canAccessAllTools: true` olarak ayarlayın).