---
read_when:
    - استفاده از داشبوردهای نشست در رابط کاربری کنترل یا توضیح آن‌ها
    - تصمیم‌گیری درباره اینکه عامل‌ها در یک برد چه کارهایی می‌توانند انجام دهند و چه کارهایی به اعطای مجوز اپراتور نیاز دارند
summary: 'داشبوردهای نشست: ویجت‌ها، بردها و زبانه‌های ساخته‌شده توسط عامل، و گفت‌وگوی متصل‌شده به کناره صفحه'
title: داشبوردهای نشست‌ها
x-i18n:
    generated_at: "2026-07-27T14:47:16Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 3babbc859e261aa959740ea778b44fdc1a07bce8ce7628cbabcfbc5fa207a0ce
    source_path: web/dashboards.md
    workflow: 16
---

هر رشته در رابط کاربری کنترل دو چهره دارد: گفت‌وگویی که می‌شناسید و یک
**داشبورد** — شبکه‌ای از ویجت‌های زنده که عامل برای شما می‌سازد. رشته‌ای بدون
ویجت صرفاً یک گفت‌وگو است. به‌محض سنجاق‌شدن یک ویجت، کلید **گفت‌وگو | داشبورد**
در سرصفحه ظاهر می‌شود و داشبورد به سطح اصلی تبدیل می‌شود، درحالی‌که
گفت‌وگوی شما در کنار آن جای می‌گیرد.

نیازی به راه‌اندازی یا پیکربندی برنامه‌ای جداگانه نیست: داشبوردها یک قابلیت
اصلی هستند، به رشته تعلق دارند، همراه عامل ذخیره می‌شوند و پس از
`/new` و `/reset` نیز باقی می‌مانند (بافت گفت‌وگو پاک می‌شود؛ تخته باقی می‌ماند).

## با درخواست‌کردن یک داشبورد بسازید

آنچه می‌خواهید ببینید از عامل خود بخواهید:

> ویجتی با نام revenue-graph ایجاد کن: یک نمودار میله‌ای تعاملی از درآمد
> ماهانه. دکمه‌های "میله‌ها" و "روند" را اضافه کن که نما را تغییر دهند. آن را به
> داشبورد من سنجاق کن.

عامل ابتدا ویجت را به‌صورت درون‌خطی در گفت‌وگو رندر می‌کند تا پیش از انتقال
آن به جایی بتوانید بررسی‌اش کنید. از آنجا:

- **خودتان آن را سنجاق می‌کنید**: نشانگر را روی یک ویجت درون‌خطی نگه دارید و **سنجاق‌کردن به داشبورد** را انتخاب کنید.
- **یا عامل آن را مستقیماً سنجاق می‌کند**، اگر چنین درخواستی بدهید، و بعداً آن را بر اساس
  نام به‌روزرسانی می‌کند — ویجت‌ها نام‌های ثابتی دارند، بنابراین «revenue-graph
  را با ارقام ماه ژوئن به‌روزرسانی کن» محتوا را در همان محل جایگزین می‌کند،
  درحالی‌که تخته سر جای خود باقی می‌ماند.

ویجت‌ها برنامه‌های کوچک و مستقلی هستند (HTML/JS/SVG در یک محیط ایزوله سخت‌گیرانه). دکمه‌ها
و کلیدهای تغییر نمای داخل ویجت بلافاصله کار می‌کنند — تغییر نمای نمودار
هرگز به عامل نیاز ندارد.

## تخته

- **شبکه روان.** ویجت‌ها را با دستگیره‌شان بکشید؛ همه‌چیز به‌طور خودکار بازچینی و
  فشرده می‌شود. اندازه را با دستگیره تغییر دهید یا از منوی ویجت یک اندازه از پیش تعیین‌شده
  (کوچک، متوسط، بزرگ، بسیار بزرگ) انتخاب کنید. هیچ‌کس پیکسل‌ها را جانمایی نمی‌کند —
  نه شما و نه عامل.
- **زبانه‌ها.** یک تخته می‌تواند چندین صفحه داشته باشد — مثلاً یک زبانه نمای کلی و یک
  زبانه متمرکز با یک ویجت بزرگ. هر زبانه موقعیت بخش گفت‌وگوی
  خودش را به خاطر می‌سپارد.
- **گفت‌وگوی جای‌گرفته.** در نمای داشبورد، گفت‌وگوی شما در سمت
  چپ، راست یا پایین جای می‌گیرد، مانند نوار کناری تغییر اندازه می‌دهد و می‌تواند
  کاملاً پنهان شود — وقتی دوباره آن را برگردانید، عامل همچنان صدای شما را می‌شنود.
- **برابری عامل.** هر کاری که شما می‌توانید انجام دهید، عامل نیز می‌تواند با ابزار
  `dashboard` خود انجام دهد: افزودن، به‌روزرسانی، جابه‌جایی، تغییر اندازه و حذف ویجت‌ها، مدیریت
  زبانه‌ها، تغییر زبانه قابل‌مشاهده و جابه‌جایی یا پنهان‌کردن بخش گفت‌وگو. بگویید «گفت‌وگو را
  در سمت چپ قرار بده و زبانه امور مالی را نشان بده» و اجرای آن را ببینید.

## ویجت‌ها مجاز به انجام چه کارهایی هستند

ویجتی که فقط رندر می‌کند به هیچ تأییدی نیاز ندارد — درست مانند ویجت‌های درون‌خطی
گفت‌وگو، فوراً ظاهر می‌شود و دسترسی شبکه آن کاملاً غیرفعال است.

ویجت‌هایی که **دسترسی** می‌خواهند باید آن را اعلام کنند و شما با یک ضربه،
برای هر ویجت یک‌بار آن را اعطا می‌کنید:

- **شبکه** (`net`): دریافت مستقیم از مبدأهای HTTPS اعلام‌شده در محیط ایزوله —
  برای مثال، یک کارت آب‌وهوا که خود را از یک API تازه‌سازی می‌کند.
- **داده‌های Gateway** (`data`): خوراک‌های فقط‌خواندنی مانند نشست‌ها، میزان استفاده یا وضعیت cron
  که Gateway آن‌ها را دریافت می‌کند — ویجت هرگز توکن شما را در اختیار ندارد.
- **خودکارسازی** (`actions`): اجرای یک کار cron مشخص تا یک دکمه بتواند
  بدون بیدارکردن گفت‌وگوی اصلی شما، یک کار واقعی را اجرا کند (که ممکن است از مدل کوچک‌تری استفاده کند).
- **پرامپت** (`prompt`): ارسال پیام به رشته شما بدون تأیید
  جداگانه برای هر کلیک که ویجت‌های تأییدنشده به آن نیاز دارند.

Pluginهای فعال می‌توانند خوراک‌های فقط‌خواندنی و کنش‌های نام‌گذاری‌شده خود را به این فهرست قابلیت‌ها اضافه کنند؛ غیرفعال‌کردن Plugin آن یکپارچه‌سازی‌ها را حذف می‌کند.

مجوزها به بایت‌ها و بازبینی دقیق ویجتی که بررسی کرده‌اید متصل هستند. اگر
عامل ویجت را تغییر دهد و چیزی _بیشتر_ از موارد تأییدشده درخواست کند، وضعیت آن دوباره
در انتظار قرار می‌گیرد؛ تازه‌سازی محتوا با همان مجوزها، مجوز اعطاشده را حفظ می‌کند.
تعامل‌هایی با ویجت که عامل باید از آن‌ها مطلع باشد (فیلترهایی که کلیک کرده‌اید، نماهایی
که تغییر داده‌اید) بی‌سروصدا به‌صورت اعلان‌های نشست به آن می‌رسند — عامل بدون
وقفه در کارش در جریان باقی می‌ماند.

## برنامه‌های MCP روی تخته

اگر Gateway شما سرورهای MCP پیکربندی‌شده داشته باشد، برنامه‌های تعاملی MCP که
در گفت‌وگو ظاهر می‌شوند می‌توانند مانند هر ویجت دیگری سنجاق شوند. برنامه‌های سنجاق‌شده با
نشست‌های تازه روی تخته دوباره فعال می‌شوند؛ به‌طور پیش‌فرض فقط برای نمایش هستند و اعطای
ابزارهای سرور اعلام‌شده به ویجت، آن را کاملاً تعاملی می‌کند — با همان
تأیید یک‌ضربه‌ای و وابسته به بازبینی که برای همه‌چیز اعمال می‌شود.

## نکات مفید

- بازنشانی رشته‌ای که تخته دارد، تأیید می‌خواهد و
  تخته را نگه می‌دارد.
- حذف یک رشته، تخته آن را حذف می‌کند.
- تخته‌ها روی Gateway شما (در پایگاه داده عامل مالک) قرار دارند و در
  هر دستگاهی که از آن متصل شوید ظاهر می‌شوند.
- مدل امنیتی، جزئیات ذخیره‌سازی و منطق طراحی در
  [معماری داشبورد](/web/dashboard-architecture) شرح داده شده‌اند، از جمله
  موازنه‌های مستندشده محیط ایزوله.