در این گزارش
مکان: Settings → Content & publishing → Your AI accounts
این صفحه را باز کنید: admin.<your-site>/settings/ai/providers (به جای <your-site> آدرس سایت خود را بگذارید)
پیش‌نیازها
- یک حساب Azure که منبع Azure OpenAI روی آن فعال باشد.
- حداقل یک مدل دیپلوی‌شده (deployed) در آن منبع. Azure مدل‌ها را فقط بعد از دیپلوی اجرا می‌کند.
- دسترسی برای خواندن کلیدهای منبع در Azure.
- فقط اعضایی که دسترسی مدیریت AI دارند می‌توانند این اتصال را برقرار کنند، و باید به‌تازگی وارد حساب شده باشید.
مراحل انجام کار
- Azure portal را باز کرده و به منبع Azure OpenAI خود بروید.
- وارد Resource Management و سپس Keys and Endpoint شوید.
- مقدار Endpoint را کپی کنید. شبیه به
https://my-resource.openai.azure.comاست و حتماً باید به.openai.azure.comیا.cognitiveservices.azure.comختم شود. - بخش KEY 1 را کپی کنید. کلید KEY 2 را برای مواقع ضروری نگه دارید. پنل مدیریت کلیدهای ۳۲ کاراکتری (حروف a–f و اعداد) یا ۸۴ کاراکتری را می‌پذیرد.
- نام دیپلوی‌های خود را پیدا کنید. در پورتال Azure AI Foundry، بخش Deployments منبع خود را باز کنید. نام دیپلوی همان نامی است که موقع دیپلوی مدل تعیین کردید؛ ممکن است با نام اصلی مدل متفاوت باشد، مثلاً
gpt-4o-mini. - در پنل مدیریت سایت خود، تنظیمات → محتوا و انتشار → حساب‌های AI شما را باز کرده و کارت Azure OpenAI را پیدا کنید.
- مقدار اندپوینت Azure را جای‌گذاری کنید. هر دیپلوی را در بخش نام‌های استقرار وارد کرده و بعد از هر کدام روی افزودن بزنید. حداقل باید یک مورد اضافه کنید.
- کلید را جای‌گذاری کنید و روی آزمایش و اتصال بزنید. پیام "در حال بررسی کلید…" و بعد از آن Connected ✓ را خواهید دید.
نکات مهم
- می‌توانید تا دو منبع Azure را متصل کنید.
- در Azure امکانی برای دریافت خودکار لیست مدل‌ها از طریق کلید وجود ندارد، بنابراین پنل مدیریت فقط دیپلوی‌هایی را که دستی وارد کرده‌اید نمایش می‌دهد. اگر مدل‌های بیشتری دیپلوی کردید، بعداً آنها را اضافه کنید.
- وارد کردن قیمت‌ها اختیاری است. در صورت ثبت قیمت، پنل مدیریت هزینه‌ها را نشان می‌دهد. بدون قیمت‌ها، اگر یک حساب کار نکند، AI به‌طور خودکار روی این حساب سوییچ نخواهد کرد.
- صدور فاکتور توسط Azure انجام می‌شود. صورت‌حساب‌ها و سقف هزینه‌ها در پورتال Azure قابل مشاهده است. AI budget and limits
- کلید روی سرور خودتان می‌ماند. Keynate هرگز آن را نمی‌بیند.
مشکلات رایج
Use your Azure OpenAI endpoint
مقدار endpoint باید به .openai.azure.com یا .cognitiveservices.azure.com ختم شود. آن را مستقیماً از Keys and Endpoint کپی کنید. دامنه اختصاصی یا آدرس IP کار نمی‌کند.
This model or deployment isn't available on your Azure OpenAI account
نام دیپلویمنت همخوانی ندارد. نام‌ها باید دقیقاً و با رعایت حروف کوچک و بزرگ یکسان باشند. بخش Deployments را در Foundry بررسی کنید، نام روی کارت را اصلاح کرده و دوباره تست کنید.
Azure OpenAI refused this key
کلید را دوباره به‌طور کامل کپی کنید. کلیدها مختص هر منبع هستند، پس مطمئن شوید کلید دقیقاً از همان منبعی باشد که endpoint را از آن برداشته‌اید.
We couldn't reach this address
آدرس endpoint را برای غلط‌های املایی بررسی کنید. اگر منبع شما فقط به شبکه‌های خاصی اجازه دسترسی می‌دهد، این تست ممکن است رد شود. دسترسی عمومی (public access) را فعال کنید یا آدرس سرور خود را اضافه کرده و مجدداً تست کنید.
Azure says the quota or rate limit is reached
یک دقیقه صبر کنید، یا سقف مصرف (quota) دیپلویمنت را در Azure افزایش دهید.
پرسش‌ها
پرسش‌های متداول
Which key do I use, KEY 1 or KEY 2?
فرقی ندارد. از KEY 1 استفاده کنید. اگر کلیدها را در Azure تغییر دادید، کلید جدید را با تعویض کلید وارد کنید.
Why do I type deployment names?
در Azure شما خودتان نام دیپلویمنتها را انتخاب میکنید. پنل مدیریت نمیتواند آنها را حدس بزند، بنابراین باید مشخص کنید از کدام موارد استفاده شود.