مستندات برای تیم‌ها و سازمان‌ها

راهنمای استفادۀ سازمانی

سازمان‌ها چطور DaLAi را در اختیار تیم‌ها و برنامه‌هایشان بگذارند: ابزارهای مناسب، الگوهای استقرار، و مدیریت کلید، هزینه و امنیت.

DaLAi برای یک سازمان یعنی یک حساب و یک موجودی که تیم‌ها و برنامه‌های مختلف، هرکدام با کلید جداگانۀ خودشان، از آن استفاده می‌کنند. همۀ مدل‌ها با نام‌های ثابت در دسترس است و مصرف هر کلید جدا دیده می‌شود.

این راهنما سه پرسش را جواب می‌دهد: برای هر کار سازمان کدام ابزار مناسب است، این ابزارها را با چه الگویی به DaLAi وصل کنید، و کلید، هزینه و امنیت را چطور اداره کنید.

DaLAi برای سازمان چه فراهم می‌کند

یک موجودی برای همۀ مدل‌ها. خانواده‌های Claude، Gemini، DeepSeek، Qwen و بقیه، بدون حساب جداگانه نزد هر ارائه‌دهنده. فهرست کامل در مدل‌ها و قیمت‌ها.
نام‌های ثابت. اگر سرویس پشت یک مدل عوض شود، نام همان می‌ماند و برنامه‌های شما دست‌نخورده کار می‌کنند. شرح در آشنایی با مدل‌ها.
کلید جدا برای هر تیم یا برنامه، هرکدام با سقف اعتبار، تاریخ انقضا، فهرست مدل‌های مجاز و فهرست نشانی‌های IP مجاز.
مصرف شفاف. هر درخواست با نام کلید، مدل، توکن و هزینه در Usage Logs ثبت می‌شود.
دو گویش استاندارد. گویش OpenAI و گویش Anthropic Messages؛ ابزارهایی که سازمان امروز به کار می‌برد بدون افزونۀ اختصاصی وصل می‌شوند.

ابزار مناسب هر کار

نیاز سازمان	ابزار پیشنهادی و دلیل
گفت‌وگوی کارکنان	Open WebUI یا LibreChat. یک درگاه داخلی با ورود یکپارچه؛ کارکنان کلید را نمی‌بینند
پرسش از اسناد	AnythingLLM یا Open WebUI. فضای کاری جدا برای هر تیم و بارگذاری اسناد سازمان
برنامه‌نویسی	Claude Code، Cline، Kilo Code یا Continue. کلید جدا برای هر برنامه‌نویس یا تیم، با سقف اعتبار
خودکارسازی	n8n یا Dify. پاسخ اولیه به ایمیل‌ها، دسته‌بندی درخواست‌ها و خلاصۀ گزارش‌ها، روی سرور خود سازمان
پشتیبانی مشتری	Dify یا n8n. دسته‌بندی تیکت‌ها و پیش‌نویس پاسخ، با بازبینی کارشناس پیش از ارسال
محصول اختصاصی	OpenAI Agents SDK، LangGraph یا Claude Agent SDK. عامل یا محصول خودتان، با کنترل کامل در کد
درگاه داخلی	LiteLLM Proxy. یک نقطۀ ورود برای همۀ برنامه‌ها، با کلید مجازی و سقف هزینه برای هر تیم، پشت یک کلید DaLAi

جای تنظیم هر ابزار در آشنایی با ابزارها آمده است.

قابلیت گفت‌وگو با اسناد به یک مدل embedding نیاز دارد که DaLAi فعلاً عرضه نمی‌کند. AnythingLLM و Open WebUI مدل embedding محلی خودشان را دارند که روی سرور شما اجرا می‌شود.

چهار الگوی استقرار

۱. کلید جدا برای هر تیم یا برنامه

ساده‌ترین الگو، مناسب سازمانی که چند برنامه یا چند تیم کوچک دارد. برای هر تیم، هر برنامه و هر محیط (آزمایشی و عملیاتی) یک کلید جدا با نامی روشن بسازید، مثل support-bot-prod یا dev-team-backend. مصرف هر کلید در Usage Logs جدا دیده می‌شود، و اگر کلیدی لو رفت، فقط همان را حذف می‌کنید و بقیه کار می‌کنند.

۲. درگاه گفت‌وگوی داخلی

Open WebUI یا LibreChat را روی سرور سازمان نصب کنید و یک کلید DaLAi فقط به خود آن بدهید. کارکنان با حساب سازمانی وارد می‌شوند (OIDC یا LDAP)، کلید را هرگز نمی‌بینند، و مدیر تعیین می‌کند هر گروه به کدام مدل‌ها دسترسی داشته باشد. گفت‌وگوها روی سرور خود سازمان می‌ماند.

LibreChat برای هر کاربر موجودی جداگانه نگه می‌دارد. در Open WebUI مدل‌های یک اتصال تازه تا وقتی مدیر آن‌ها را عمومی نکند یا به گروهی ندهد، فقط برای خود مدیر دیده می‌شوند.

۳. درگاه داخلی با بودجۀ تیمی

وقتی ده‌ها برنامه و تیم دارید، LiteLLM Proxy را میان آن‌ها و DaLAi بگذارید. هر تیم کلید مجازی خودش را با سقف بودجه و فهرست مدل‌های مجاز از این درگاه می‌گیرد، و پشت همه، تنها یک کلید DaLAi روی سرور شماست.

model_list:
  - model_name: claude-sonnet-4-5
    litellm_params:
      model: openai/claude-sonnet-4-5
      api_base: https://dalai.ir/v1
      api_key: os.environ/DALAI_API_KEY

کلید مجازی و بودجۀ هر تیم در نسخۀ متن‌باز LiteLLM هست. برخی امکانات، مثل ورود یکپارچه به پنل مدیریت آن برای بیش از پنج کاربر، مجوز تجاری خود LiteLLM را می‌خواهند.

۴. خودکارسازی فرایندها

n8n یا Dify را روی سرور سازمان نصب کنید و به هر گردش کار کلید جداگانه‌ای بدهید که فقط به مدل‌های لازم دسترسی دارد و سقف اعتبار دارد. این‌طور گردش کاری که در یک حلقه گیر کند، فقط اعتبار خودش را خرج می‌کند. دو تنظیم لازم این دو ابزار در آشنایی با ابزارها آمده است.

مدیریت کلید و هزینه

کلیدها در پنل کاربری، بخش API Keys، ساخته می‌شوند. برای هر کلید این فیلدها را تنظیم کنید:

Name: نامی که تیم، برنامه و محیط را نشان دهد.
Expiration Time: برای کلید پیمانکار یا پروژۀ موقت، تاریخ انقضا بگذارید.
Quota: سقف اعتبار همین کلید. وقتی تمام شود، فقط همین کلید می‌ایستد و بقیۀ موجودی سازمان دست‌نخورده می‌ماند.
Model Limits، در بخش Advanced Settings: فقط مدل‌هایی که این کلید لازم دارد. جلوی خرج ناخواسته روی مدل‌های گران را می‌گیرد.
IP Whitelist، در همان بخش: نشانی IP سرورهایی که از این کلید استفاده می‌کنند، به‌صورت تکی یا CIDR. درخواست از هر نشانی دیگری رد می‌شود.

درخواستی که از نشانی‌ای بیرون از IP Whitelist برسد، با خطای ۴۰۳ و این پیام برمی‌گردد: «نشانی IP شما در فهرست مجاز این کلید API نیست» (برای حسابی که زبانش فارسی نیست، به انگلیسی). معنی پیام‌های دیگر در خطاها و محدودیت‌ها آمده است.

برای گزارش مصرف یک تیم، در Usage Logs فیلتر Token Name را روی نام کلید همان تیم بگذارید. Dashboard نمای کلی مصرف و موجودی را نشان می‌دهد. موجودی سازمان پیش‌پرداخت است و به تومان نمایش داده می‌شود؛ شرح کامل در کیف پول، شارژ و صورت‌حساب.

امنیت و داده

کلید را فقط سمت سرور نگه دارید. کلید را هرگز در کد صفحۀ وب یا برنامۀ موبایل نگذارید؛ هرکس آن برنامه را داشته باشد، کلید را هم دارد.
برای هر محیط کلید جدا بسازید، و کلید آزمایشی را با سقف کم و تاریخ انقضا.
کلیدها را دوره‌ای عوض کنید: کلید تازه بسازید، برنامه را به آن ببرید، و بعد کلید قدیمی را حذف کنید.
کلیدی که IP Whitelist دارد، اگر از سرور بیرون برود، به کار کسی نمی‌آید.
هر متنی که به مدل می‌فرستید برای ساختن پاسخ پردازش می‌شود. پیش از اتصال یک فرایند، روشن کنید چه داده‌ای اجازۀ رفتن به مدل را دارد، و رمزها و اطلاعات محرمانه را نفرستید.

راه‌اندازی، قدم به قدم

برای حساب سازمانی به support@dalai.ir ایمیل بزنید. در دورۀ راه‌اندازی آزمایشی، دسترسی فقط با دعوت‌نامه است.
موجودی اولیه را هماهنگ کنید. شارژ فعلاً دستی و پس از هماهنگی انجام می‌شود.
فهرست تیم‌ها، برنامه‌ها و محیط‌ها را بنویسید و برای هرکدام کلید جدا بسازید، با سقف اعتبار و فهرست مدل‌های مجاز.
الگوی استقرار را انتخاب کنید و ابزارها را طبق آشنایی با ابزارها تنظیم کنید.
با یک تیم کوچک شروع کنید، یک هفته مصرف را در Usage Logs ببینید، و بعد سقف‌ها و مدل‌ها را تنظیم کنید. برای انتخاب مدل، آشنایی با مدل‌ها را ببینید.

برای حساب سازمانی، شارژ و هر پرسش دربارۀ صورت‌حساب به support@dalai.ir ایمیل بزنید.