AI اجنټان

AI اجنټ یو څو ګامیز مرستندویه دی. دا خبرې اترې لولي، پلان جوړوي، وسیلې بولي (ستاسو AI وسیلې، MCP وسیلې او د پوهې بنسټ لټون)، پایلې ګوري، او ماډل بیا بولي تر هغه چې ځواب ولري. د AI چټ بشپړونه جوړه کړئ نوډ یوه ماډل بلنه کوي او ځواب ورکوي؛ AI اجنټ نوډ کولی شي، د هغو حدونو دننه چې تاسو یې ټاکئ، د ځواب ورکولو دمخه څو ماډل او وسیله بلنو ته دوام ورکړي.

اجنټ هغه مهال وکاروئ چې یوې غوښتنې ته څو ګامونه په کار وي، د بېلګې په توګه "د پېرودونکي امر ومومئ، د رسولو حالت یې وګورئ او نوې نېټه وړاندې کړئ". د لارښوونو او پوهې بنسټ څخه د مستقیم ځواب لپاره، AI نوډ ساده او ارزانه دی.

جوړونکې برخې

برخه	دا څه ده	چیرته یې ټاکئ
AI Harness	هغه انجن چې د اجنټ لوپ چلوي: د MonoChat خپل، د اجنټ SDK، یا کوربه شوې اجنټ خدمت.	تنظیمات › اتومات کول › AI harnesses
ماډلونه	هغه AI ماډلونه چې اجنټ ورسره فکر کوي: اصلي ماډل، اختیاري بدیل ماډل او اختیاري چټک ماډل. کوربه شوي harnesses پر ځای د خپل وړاندې کوونکي ماډلونه کاروي.	AI اجنټ نوډ
وسیلې	AI scopes، AI Tool فنکشنونه او MCP وسیلې.	AI اجنټ نوډ
د اجرا بودیجه	د هرې اجرا لپاره د ماډل بلنو، وسیله بلنو، ټوکنونو، مودې او بیا هڅو حدونه.	AI اجنټ نوډ
اجرا	د اجنټ یوه اجرا. هره اجرا په د AI اجنټ اجراګانې کې ثبتېږي.	د نوډ یا API لخوا جوړېږي

AI harnesses

تنظیمات › اتومات کول › AI harnesses هغه harnesses لیست کوي چې ستاسو اجنټان پرې چلېدای شي: هغه چې MonoChat هر کاري ځای ته وړاندې کوي، او هغه چې تاسو د خپلو اسنادو سره زیاتوئ.

Harness	چیرته چلېږي	کوم ماډلونه کاروي	څوک یې زیاتوي
MonoChat Native	د MonoChat دننه	ستاسو AI ماډلونه	MonoChat
OpenAI Agents SDK	د MonoChat دننه	ستاسو AI ماډلونه	MonoChat
Claude Agent SDK	د MonoChat اجنټ چلوونکي کې	ستاسو AI ماډلونه	MonoChat
pi	د MonoChat اجنټ چلوونکي کې	ستاسو AI ماډلونه	MonoChat
OpenAI Agents API	د OpenAI په کلاوډ کې	د harness اجازه شوي ماډلونه	تاسو، د خپلې OpenAI API کیلي سره (MonoChat هم یو وړاندې کولی شي)
Claude Managed Agents	د Anthropic په کلاوډ کې	د harness اجازه شوي ماډلونه	تاسو، د خپلې Anthropic API کیلي سره (MonoChat هم یو وړاندې کولی شي)
Custom Endpoint	ستاسو په خپل سرور	ستاسو AI ماډلونه (اختیاري)	تاسو، د خپل endpoint او secret سره

هغه harnesses چې په MonoChat چلېږي د MonoChat لخوا وړاندې کېږي؛ ستاسو کاري ځای یوازې هغه harnesses زیاتولی شي چې خپل اسناد اخلي. Claude Agent SDK او pi د MonoChat اجنټ چلوونکي ته اړتیا لري: چیرته چې دا نه وي جوړ شوی، پر دوی اجرا د "This harness is not available on this server." سره ناکامېږي.

هر harness چې وي، MonoChat کنټرول ساتي: د هغه harness هره ماډل بلنه چې ستاسو AI ماډلونه کاروي د MonoChat له لارې تېرېږي (نو بیل کول او بودیجه پلي کېږي)، هره وسیله بلنه ستاسو په کاري ځای کې ستاسو فنکشنونه، MCP وسیلې او AI scopes چلوي، او بودیجه په هر harness کې پلي کېږي.

harness زیات کړئ

تنظیمات › اتومات کول › AI harnesses ته لاړ شئ او + (جوړول) کلیک کړئ.
یو نوم او، اختیاري، توضیح دننه کړئ.
Harness وټاکئ. هر اختیار وایي چې چیرته چلېږي.
د د ننوتلو معلومات الندې، هغه دننه کړئ چې harness ورته اړتیا لري:
- OpenAI Agents API، Claude Managed Agents: API کیلي.
- Custom Endpoint: Endpoint او API کیلي.
د کوربه شوي harness لپاره، اجازه شوي ماډلونه ډک کړئ: د وړاندې کوونکي د ماډل نومونه دننه کړئ (د بېلګې په توګه د OpenAI یا Anthropic ماډل ID). تر 10 ماډلونو پورې ماډل اضافه کړئ وکاروئ. پر دې harness اجنټان یوازې له دې لیست څخه غوره کولی شي.
خوندي کول کلیک کړئ.

کله چې harness ایډیټ کوئ، د Harness ډول نه شي بدلېدای، او د کیلي ساحه د API کیلي (د خوندي شوې کیلي د ساتلو لپاره تش پرېږدئ) ښيي.

Claude Managed Agents

لومړی ځل چې د دې ډول harness کارول کېږي، MonoChat په هغه Anthropic حساب کې یو اجنټ او یو چاپېریال جوړوي او وروسته یې بیا کاروي.

Custom Endpoint

د Custom Endpoint harness اجرا ستاسو خپلې خدمت ته لېږي، د بېلګې په توګه self-hosted اجنټ. د هرې اجرا لپاره MonoChat POST د Authorization: Bearer <API Key> سره <Endpoint>/runs ته لېږي. بدنه د اجرا ID، لارښوونې، ننوتنه، د خبرو اترو پیغامونه، بودیجه، د ماډل نومونه (agent-main، agent-fallback، agent-fast) او درې URLs د دې اجرا لپاره د ټوکن سره لري:

یو ماډل gateway (OpenAI-compatible …/v1 او Anthropic-compatible base URLs) چې د نوډ AI ماډلونه بولي او بودیجه پلي کوي،
یو MCP سرور چې د اجرا وسیلې ښيي،
یو events URL چیرته چې ستاسو خدمت پایله راپور کوي (completed د result سره، یا failed د error سره).

د اجرا ټوکن د اجرا پای ته رسېدو سره کار کول بندوي.

AI اجنټ نوډ

د بهیر ډیزاینر کې د hybrid نوډونو الندې، د AI اجنټ نوډ سره بهیر ته یو اجنټ زیات کړئ. د نوډونو د زیاتولو او نښلولو لپاره بهیرونه وګورئ.

ساحې

برخه	ساحه	توضیح
	نوم	د نوډ نوم چې پر canvas ښودل کېږي.
	AI Harness	اړین. هغه harness چې اجنټ چلوي.
	لارښوونې	د اجنټ سیسټم لارښوونې: رول، لهجه، قواعد او دا چې څه کولی شي یا نه شي کولی.
	دنده (د اجنټ لارښوونو ته اضافه کېږي؛ ټګونه کارولی شئ)	هغه څه چې دا نوډ له اجنټ غواړي. دا د لارښوونو وروسته اضافه کېږي او کولی شي د AI نوډ د prompt په څېر ټګونه وکاروي، د بېلګې په توګه د پېرودونکي معلوماتو شاملولو لپاره.
ماډلونه	اصلي ماډل	هغه ماډل چې اجنټ یې کاروي. د Custom Endpoint پرته د هر harness لپاره اړین.
	بدیل ماډل (د نرم حد وروسته)	هغه ماډل چې اجنټ ورته بدلېږي کله چې د ماډل بلنو نرم حد ته ورسېږي، معمولاً ارزانه یا چټک ماډل.
	چټک ماډل (سپک شالید کارونه)	هغه ماډل چې harness یې د خپلو سپکو شالید بلنو لپاره کارولی شي.
	ماډل (د harness له اجازه شویو ماډلونو څخه یو)	د کوربه شوي harness لپاره د پورتنیو درېیو ساحو پر ځای ښودل کېږي.
د اجنټ خبرې اترې	خبرې اترې	د اجنټ موجوده ناسته ته دوام ورکړئ (ډیفالټ) یا د اجنټ نوې ناسته پیل کړئ. د اجنټ ناستې وګورئ.
	د دندې کیلي (د هرې دندې لپاره جلا د اجنټ خبرې اترې)	اختیاري. په یوه خبرو اترو کې د هرې کیلي لپاره جلا د اجنټ ناسته ساتي، د بېلګې په توګه `booking` او `support`.
	د پیغام د تاریخچې حد	اجنټ ته د خبرو اترو څو پیغامونه رسېږي.
	د وینا څخه متن AI ماډلونه	هغه ماډل چې ټرانسکریپټ لري. په خبرو اترو کې غږیز پیغامونه اجنټ ته د متن په توګه رسېږي.
د وسایلو تنظیمات	AI scopes	هغه پوهې بنسټونه چې اجنټ یې لټولی شي. دوی اجنټ ته د پوهې بنسټ د لټون وسیلې په توګه وړاندې کېږي.
	AI وسیله	د AI وسیله ډول فنکشنونه چې اجنټ یې بلولی شي.
	د AI MCP Client د منځپانګې وسایل تنظیم کړئ	هغه drawer خلاصوي چیرته چې تاسو MCP وسیلې زیاتوئ. MCP کلاینټونه وګورئ.
پیغامونه	منځنی پیغامونه پیرودونکي ته ولېږئ	په ډیفالټ توګه بند. هغه څه چې اجنټ لا د کار پر مهال لیکي (د بېلګې په توګه "اجازه راکړئ ستاسو امر وګورم") کله چې فعال وي پېرودونکي ته لېږل کېږي؛ کله چې بند وي یوازې د whisper پیغام په توګه ناستې ته اضافه کېږي چې یوازې ستاسو ټیم یې ویني.
	ځواب ولیږئ	په ډیفالټ توګه فعال. د اجنټ وروستی ځواب پېرودونکي ته لېږي. د ځواب یوازې په بهیر دننه کارولو لپاره یې بند کړئ.
د اجرا بودیجه	د ماډل د بلنو اعظمي شمېر	ډیفالټ 4.
	نرم حد: د ماډل بلنې	اختیاري. د دومره ماډل بلنو وروسته اجنټ بدیل ماډل ته بدلېږي. باید له د ماډل د بلنو اعظمي شمېر کم وي او بدیل ماډل ته اړتیا لري.
	د وسایلو د بلنې اعظمي شمېر	ډیفالټ 6. د `0` سره، اجرا هر کله چې اجنټ د وسیلې بلنې هڅه وکړي د بودیجه تېره شوه په توګه پای ته رسېږي.
	ټولټال اعظمي ټوکنونه	ډیفالټ 20000. په اجرا کې د ټولو ماډل بلنو د ننوتنې او وتنې ټوکنونه.
	اعظمي موده (ثانیې)	ډیفالټ 30.
	د بیا هڅو اعظمي شمېر	ډیفالټ 2. ناکامه ماډل بلنه څو ځله بیا هڅه کېږي.

لارښوونه

ثابت قواعد په لارښوونو کې او د دې ګام ځانګړې دنده په دنده کې ولیکئ. په دې توګه په بهیر کې څو AI اجنټ نوډونه کولی شي ورته لارښوونې شریکې کړي او یوازې په خپله دنده توپیر ولري.

خبرداری

کوربه شوي harnesses نرم حد نه ملاتړ کوي، ځکه چې دوی نشي کولی بدیل ماډل ته بدل شي. د دوی لپاره نرم حد: د ماډل بلنې تش پرېږدئ.

کله چې بهیر نوډ ته ورسېږي څه پیښېږي

MonoChat ستاسو بیلانس او د نوډ تنظیمات ګوري، او یوه اجرا پیلوي. اجرا په کتار کې ده، بیا روان. د بهیر بیلګه په نوډ کې انتظار کوي.
اجنټ لارښوونې او دنده ترلاسه کوي، او کله چې بهیر یوې خبرو اترو پورې اړه ولري، د خبرو اترو پیغامونه د د پیغام د تاریخچې حد پورې، د ټرانسکریپټ شویو غږیزو پیغامونو سره.
اجنټ ماډلونه او وسیلې بولي تر هغه چې ځواب ولري یا حد ته ورسېږي. هغه متن چې د وسیله بلنو ترمنځ لیکي د منځني پیغام په توګه اداره کېږي.
کله چې اجرا پای ته ورسېږي:
- که بشپړ شوی وي او ځواب ولیږئ فعال وي، ځواب پېرودونکي ته لېږل کېږي. اوږده ځوابونه په څو پیغامونو ویشل کېږي کله چې د چینل له حد څخه زیات شي (په WhatsApp کې 4096 توري)؛
- که په بل ډول پای ته ورسېږي، د "AI agent run ended: status. error" whisper پیغام ستاسو د ټیم لپاره ناستې ته اضافه کېږي.
بهیر په هغه وتنه دوام کوي چې د اجرا له پای سره سمون لري.

د یوې اجنټ ناستې اجراګانې یو په یو، په ترتیب سره پروسس کېږي.

وتنې

وتنه	کله
بشپړ شوی	اجنټ د ځواب سره پای ته ورسېد.
بودیجه تېره شوه	اجرا د ماډل د بلنو اعظمي شمېر، د وسایلو د بلنې اعظمي شمېر یا ټولټال اعظمي ټوکنونه مصرف کړل.
وخت پای ته ورسېد	اجرا اعظمي موده (ثانیې) ته ورسېده.
کرکه، Jailbreak، ځان ته زیان، جنسي، تاوتریخوالی	د ماډل وړاندې کوونکي د منځپانګې فلټر اجرا د دې کټګورۍ لپاره ودروله. دا هماغه وتنې دي چې AI نوډ لري.
د ناکامۍ پر مهال	اجرا په کوم بل دلیل ناکامه شوه، یا لغوه شوه. د منځپانګې فلټر درول هم هغو نوډونو کې دلته ځي چې د دې وتنو له شتون مخکې خوندي شوي وو؛ د هغو ترلاسه کولو لپاره داسې نوډ خلاص او خوندي کړئ.

لږ تر لږه بشپړ شوی او د ناکامۍ پر مهال ونښلوئ. یو عام نمونه دا ده چې بودیجه تېره شوه، وخت پای ته ورسېد او د ناکامۍ پر مهال خبرې اترې سپارل نوډ ته ولېږل شي ترڅو یو ټیمي غړی یې په غاړه واخلي.

د اجنټ ناستې

د اجنټ ناسته د اجراګانو په اوږدو کې د اجنټ حافظه ده. MonoChat د هرې خبرې اترې، harness او د دندې کیلي لپاره یوه فعاله د اجنټ ناسته ساتي.

د اجنټ موجوده ناسته ته دوام ورکړئ یې بیا کاروي، نو اجنټ هلته دوام کوي چیرته چې پرېښی و. په کوربه شویو harnesses کې د وړاندې کوونکي خپله ناسته هم دوام مومي.
د اجنټ نوې ناسته پیل کړئ فعاله بندوي او نوې پیلوي، د بېلګې په توګه د نوي موضوع په پیل کې.
د دندې کیلي په یوه خبرو اترو کې خپلواکې ناستې یوځای ساتي.

بیل کول

د MonoChat لخوا وړاندې شوي AI ماډلونو ماډل بلنې د معمول په څېر ستاسو له بیلانس څخه بیل کېږي. په ستاسو خپلو ماډلونو بلنې ستاسو وړاندې کوونکی بیلوي.
هغه harness چې MonoChat وړاندې کوي کولی شي خپل فیسونه د هرې اجرا، هرې دقیقې او هرې وسیله بلنې لپاره زیات کړي، او د کوربه شوي harness لپاره، هغه ټوکنونه چې وړاندې کوونکی یې راپور ورکوي. دوی په راکړې ورکړې کې د د AI اجنټ اجرا، د AI اجنټ موده، د AI اجنټ د وسیلې بلنه او د AI ټوکن کټګوریو په توګه ښکاري.
هغه harness چې تاسو د خپلو اسنادو سره زیاتوئ د MonoChat فیس نه لري؛ ستاسو وړاندې کوونکی تاسو ته بیل درکوي.
که ستاسو بیلانس بس نه وي، اجرا نه پیلېږي.

د AI اجنټ اجرا پای ته ورسېده پېښه

د AI اجنټ اجرا پای ته ورسېده یو پېښې نوډ دی. دا هغه مهال فعالېږي چې د پېرودونکي سره تړلې اجرا پای ته ورسېږي، که اجرا د بهیر لخوا یا د API له لارې د ناستې سره پیل شوې وي. د نورو پېښو نوډونو په څېر دا اختیاري شرط او وخت پای ته ورسید تنظیمات لري. دا د اجنټ اجراګانو وروسته د جلا بهیر پیلولو لپاره وکاروئ، د بېلګې په توګه پایلې ثبتولو یا ټیم ته خبرولو لپاره.

له کوډ څخه اجنټ پیل کړئ

دودیز فنکشنونه او API کلاینټونه کولی شي دا میتودونه د اجنټانو چلولو لپاره وکاروي (اجازه په اتومات کې د AI اجنټ چلونو پیلول / لوستل / لغوه کول):

میتود	څه کوي
`business.tenants.automation.ai.aiAgentRuns.create`	اجرا پیلوي. `aiAgentRunId` او `aiAgentSessionId` بیرته ورکوي.
`business.tenants.automation.ai.aiAgentRuns.show`	اجرا (`_id`) د خپل حالت، کارونې، ګامونو او پایلې سره بیرته ورکوي.
`business.tenants.automation.ai.aiAgentRuns.cancel`	په کتار کې یا روانه اجرا (`_id`) لغوه کوي.

create اخلي aiHarnessClientId، input (دنده)، اختیاري sessionId (په خبرو اترو کې د کار لپاره)، aiAgentSessionId، taskKey او isNewSession، او options د نوډ په څېر ورته تنظیماتو سره: instructions، aiModelClientId، fallbackAiModelClientId، fastAiModelClientId، harnessModel، toolCustomFunctionIds، aiScopeIds، aiMcpClientDatas، messageHistoryLimit، speechToTextAiModelClientId، forwardIntermediateMessages، willSendAnswer او اړین budget. د API له لارې، forwardIntermediateMessages او willSendAnswer په ډیفالټ توګه false دي.

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
  payload: {
    aiHarnessClientId: 'HARNESS_ID',
    input: 'Summarise the open orders of this customer.',
    sessionId: 'SESSION_ID',
    options: {
      instructions: 'You are the order assistant of our store.',
      aiModelClientId: 'MODEL_ID',
      toolCustomFunctionIds: ['FUNCTION_ID'],
      budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
    },
  },
})

اجرا غیر همغږې ده: وروسته یې د show سره ولولئ، یا د د AI اجنټ اجرا پای ته ورسېده پېښې سره ورته عکس العمل وښیئ. پرته له sessionId، هره بلنه نوې د اجنټ ناسته پیلوي مګر دا چې تاسو هغه aiAgentSessionId ورکړئ چې مخکینۍ بلنې بیرته ورکړی؛ بیا اجنټ د هغې د اجنټ ناستې پخواني بشپړې شوې اجراګانې د خپلې تاریخچې په توګه ویني. له فنکشن څخه د میتودونو بلنې لپاره میتود وګورئ.

اجازې

اجازه	څه ممکنوي
په اتومات کې د AI harnesses لوستل / جوړول / تازه کول / ړنګول	د AI harnesses مدیریت
په اتومات کې د AI اجنټ چلونو لوستل	د د AI اجنټ اجراګانې لیدل
په اتومات کې د AI اجنټ چلونو پیلول	`aiAgentRuns.create` بلل
په اتومات کې د AI اجنټ چلونو لغوه کول	`aiAgentRuns.cancel` بلل

رولونه وګورئ.

د AI اجنټ اجراګانې: وګورئ چې هرې اجرا څه کړي
AI ماډلونه
MCP کلاینټونه
AI scopes
بهیرونه

جوړونکې برخې​

AI harnesses​

harness زیات کړئ​

Custom Endpoint​

AI اجنټ نوډ​

ساحې​

کله چې بهیر نوډ ته ورسېږي څه پیښېږي​

وتنې​

د اجنټ ناستې​

بیل کول​

د AI اجنټ اجرا پای ته ورسېده پېښه​

له کوډ څخه اجنټ پیل کړئ​

اجازې​

اړوند​