پرش به مطلب اصلی

اتصال یک ارائه‌دهندهٔ هوش مصنوعی

هدف​

پلتفرم را یک بار و برای کل سازمان به یک مدل هوش مصنوعی متصل کنید — تا دکمهٔ هوش مصنوعی در هر طراح از روی یک جمله طرح بسازد، و دستیار صفحهٔ خانه بتواند به پرسش‌ها پاسخ دهد و برایتان چیزهایی بسازد.

پیش‌نیازها​

  • با نقش مدیر پلتفرم وارد مرکز کنترل مدیریت شده‌اید.
  • نزد یک ارائه‌دهندهٔ هوش مصنوعی حساب و کلید API دارید — یا مدلی روی سرور خودتان (Ollama، LM Studio) اجرا می‌شود که کلید نمی‌خواهد.

مراحل​

  1. تنظیمات را باز کنید — چرخ‌دندهٔ نوار بالا، در هر صفحه — و زبانهٔ هوش مصنوعی را انتخاب کنید. اگر هنوز چیزی تنظیم نشده باشد، زبانه روی Anthropic و با مدل claude-opus-5 از پیش پرشده باز می‌شود — پس اتصال به Claude فقط مراحل ۴ و ۵ است.
  2. ارائه‌دهنده را انتخاب کنید:
    • Anthropic برای Claude. یک نقطهٔ پایانی بیشتر ندارد، پس ریشه‌ای پرسیده نمی‌شود، و مدل پیشنهادی برایتان پر می‌شود.
    • سازگار با OpenAI برای خود OpenAI، OpenRouter، Ollama، LM Studio و هر چیز دیگری که همان قرارداد /chat/completions را می‌فهمد. سپس ریشهٔ API را پر کنید — ریشه، نه نقطهٔ پایانی کامل: https://api.openai.com/v1 (برایتان پر شده)، https://openrouter.ai/api/v1 یا http://localhost:11434/v1.
  3. مدل را بررسی کنید — دقیقاً همان‌طور که ارائه‌دهنده می‌نویسد: claude-opus-5، gpt-4o، llama3.1. تغییر ارائه‌دهنده مدل پیش‌فرض همان ارائه‌دهنده را پر می‌کند، اما هرگز مدلی را که خودتان نوشته‌اید جایگزین نمی‌کند. خالی گذاشتن آن هوش مصنوعی را برای سازمان شما خاموش می‌کند.
  4. کلید API را بچسبانید. برای سرور محلی که کلید نمی‌خواهد خالی بگذارید. برای Claude، گرفتن کلید API از Anthropic را در ادامه ببینید.
  5. ذخیره و سپس آزمایش اتصال. آزمایش یک فراخوانی کوچک از طریق آنچه ذخیره کرده‌اید انجام می‌دهد و پاسخ خود مدل را نشان می‌دهد؛ پس نتیجهٔ سبز یعنی ارائه‌دهنده واقعاً پاسخ داده است.

گرفتن کلید API از Anthropic (Claude)​

کلید API با اشتراک claude.ai یکی نیست. ورود به claude.ai به یک نفر گفت‌وگو می‌دهد؛ پلتفرم به کلیدی از کنسول Claude نیاز دارد که حساب توسعه‌دهندگیِ جداگانه و پرداخت‌به‌ازای‌مصرف است و هزینهٔ آنچه کاربران سازمان تولید می‌کنند را از سازمان می‌گیرد.

  1. به platform.claude.com بروید و وارد شوید یا حساب بسازید. اگر شرکت شما از قبل سازمانی در کنسول دارد، از مدیر آن بخواهید شما را دعوت کند و سازمان دومی نسازید — کلید باید متعلق به سازمانی باشد که پرداخت می‌کند.
  2. در Settings → Billing روش پرداخت را اضافه کنید. حساب تازه باید پیش از آنکه کلیدهایش پاسخ دهند روش پرداخت یا اعتبار پیش‌خرید داشته باشد؛ کلید بدون اعتبار در آزمایش اتصال با خطای صورت‌حساب رد می‌شود، نه خطای احراز هویت.
  3. Settings → API keys را باز کنید (platform.claude.com/settings/keys) و Create key را بزنید. نامی بدهید که بگوید کجا استفاده می‌شود — Parsware platform — تاریخ انقضا انتخاب کنید و Linked account را تعیین کنید: برای پلتفرمی مشترک، کلید service account را به کلید شخصی ترجیح دهید، چون کلید شخصی روزی که صاحبش سازمان را ترک کند از کار می‌افتد.
  4. کلید را همان لحظه کپی کنید. با sk-ant- شروع می‌شود و کنسول آن را فقط یک بار، هنگام ساخت، کامل نشان می‌دهد؛ اگر گم شد به جای جست‌وجو، کلید تازه‌ای بسازید.
  5. به پلتفرم برگردید، آن را در کلید API بچسبانید، ذخیره و آزمایش اتصال کنید.

کلید را یک جا نگه دارید. پلتفرم آن را روی سرور ذخیره می‌کند و هرگز به مرورگر برنمی‌گرداند؛ آن را در سند یا گفت‌وگویی هم نگه ندارید. اگر روزی درز کرد، در همان صفحهٔ کنسول باطلش کنید و کلید تازه‌ای اینجا بچسبانید — چیز دیگری لازم نیست تغییر کند.

پشت صحنه چه می‌گذرد​

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

تنظیمات از آنِ سازمان شماست، نه هر شخص. همهٔ افراد سازمان با یک مدل کار می‌کنند و هزینه روی یک حساب می‌نشیند. پیش از این زبانه، ارائه‌دهنده را نصب‌کنندهٔ پلتفرم در پیکربندی تعیین می‌کرد؛ آن مقادیر همچنان پشتیبان هستند و تا زمانی که مقادیر خودتان را ذخیره نکرده‌اید، به‌عنوان نقطهٔ شروع اینجا نشان داده می‌شوند — خط بالای زبانه می‌گوید کدام‌یک فعال است.

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

کجا استفاده می‌شود​

  • دکمهٔ هوش مصنوعی در طراح فرایند، گزارش، داشبورد و استودیو — آنچه می‌خواهید را توصیف کنید تا طرحی ساخته، با طرح‌وارهٔ همان سند بررسی، و روی بوم بارگذاری شود.
  • دستیار صفحهٔ خانه که می‌تواند محتوای محیط را بخواند و، اگر اجازه دهید، جدول‌ها، برنامه‌ها و راهکارهای کامل بسازد.