i18n - docs translations (#23796)
Created by Github action <!-- This is an auto-generated description by cubic. --> <a href="https://cubic.dev/pr/twentyhq/twenty/pull/23796?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
61c72942ac
commit
6d83018b6f
@@ -100,7 +100,8 @@ export default defineAgent({
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="تشغيل وكيل من دالة منطقية">
|
||||
|
||||
تتيح `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`).
|
||||
|
||||
@@ -100,7 +100,7 @@ Poznámky ke schématu:
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="Spuštění agenta z logické funkce">
|
||||
|
||||
`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`).
|
||||
|
||||
@@ -100,7 +100,7 @@ Schema-Hinweise:
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="Einen Agenten aus einer Logikfunktion ausführen">
|
||||
|
||||
`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`).
|
||||
|
||||
@@ -100,7 +100,8 @@ Notas sobre el esquema:
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="Ejecutar un agente desde una función de lógica">
|
||||
|
||||
`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`).
|
||||
|
||||
@@ -100,7 +100,9 @@ Remarques sur le schéma :
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="Exécuter un agent depuis une fonction logique">
|
||||
|
||||
`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`).
|
||||
|
||||
@@ -100,7 +100,7 @@ Note sullo schema:
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="Esegui un agente da una funzione di logica">
|
||||
|
||||
`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`).
|
||||
|
||||
@@ -100,7 +100,7 @@ export default defineAgent({
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="ロジック関数からエージェントを実行する">
|
||||
|
||||
`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` を設定します）。
|
||||
|
||||
@@ -100,7 +100,7 @@ export default defineAgent({
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="로직 함수에서 에이전트를 실행">
|
||||
|
||||
`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`로 설정하세요.
|
||||
|
||||
@@ -100,7 +100,8 @@ Note despre schemă:
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="Rulează un agent dintr-o funcție logică">
|
||||
|
||||
`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`).
|
||||
|
||||
@@ -100,7 +100,7 @@ export default defineAgent({
|
||||
</Accordion>
|
||||
<Accordion title="runAgent" description="Bir mantık işlevinden bir ajan çalıştırın">
|
||||
|
||||
`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).
|
||||
|
||||
Reference in New Issue
Block a user