اگر مدیر فضای کاری ChatGPT یا کاربر ChatGPT Plus یا Pro هستید و میخواهید برنامه Databricks Genie را با OAuth داخلی یا کلاینت OAuth سازمانتان راهاندازی کنید، از این راهنما استفاده کنید.
OAuth داخلی: اگر این گزینه در ChatGPT در دسترس است و برای فضای کاری Databricks شما فعال شده، از اتصال ازپیشپیکربندیشده استفاده کنید. نیازی به ایجاد برنامه OAuth یا وارد کردن شناسه یا رمز محرمانه کلاینت ندارید. دستورالعملهای بخش «OAuth داخلی» را در ادامه دنبال کنید.
کلاینت OAuth سفارشی: اگر OAuth داخلی در دسترس نیست یا سازمانتان استفاده از کلاینت OAuth اختصاصی خود را الزامی میداند، از این روش استفاده کنید. دستورالعملهای بخش «کلاینت OAuth سفارشی» را در ادامه دنبال کنید.
آنچه راهاندازی میکنید
شما برای حساب یا فضای کاری ChatGPT خود، اتصال به برنامه Databricks ایجاد میکنید. در هر دو روش، به اطلاعات ارائهدهنده Databricks که در ChatGPT درخواست میشود و مجوز دسترسی به منابعی که قصد استفاده از آنها را دارید نیاز است. اگر از کلاینت OAuth سفارشی استفاده میکنید، این موارد را نیز آماده کنید:
اتصال برنامه OAuth مربوط به Databricks که در کنسول حساب Databricks خود ایجاد کردهاید.
شناسه و رمز محرمانه کلاینت OAuth مربوط به Databricks.
نشانی دقیق بازگشت که از ChatGPT کپی شده است.
دامنههای دسترسی Databricks متناسب با قابلیتهایی از برنامه که میخواهید فعال کنید.
هرگونه اطلاعات ارائهدهنده Databricks که در فرایند راهاندازی ChatGPT درخواست میشود، مانند میزبان فضای کاری، میزبان حساب، شناسه حساب یا انبار داده.
پیش از شروع
برای راهاندازی در فضای کاری، کنسول مدیریت را باز کنید، فضای کاری موردنظر ChatGPT را انتخاب کنید و به بخش «افزونهها» بروید. «مدیریت برنامههای قدیمی» را انتخاب کنید تا صفحه «برنامهها» که همچنان حفظ شده است باز شود. برای آشنایی با مسیرهای دسترسی در فضای کاری و دسترسی به برنامههای قدیمی، به کنترلهای مدیریتی، امنیت و انطباق برای افزونهها و برنامهها مراجعه کنید.
به این موارد نیاز دارید:
دسترسی مدیر یا مالک فضای کاری ChatGPT، یا حساب ChatGPT Plus یا Pro.
برای کلاینت OAuth سفارشی، دسترسی مدیر حساب Databricks. دسترسی مدیر فضای کاری ممکن است برای برخی کارها کافی باشد، اما اتصالهای برنامه سفارشی از طریق کنسول حساب Databricks پیکربندی میشوند. برای OAuth داخلی، مدیر Databricks باید بررسی کند که برنامه ChatGPT برای فضای کاری شما در دسترس و فعال باشد.
برای کلاینت OAuth سفارشی، کنسول حساب Databricks را در زبانهای جداگانه باز نگه دارید.
برای کلاینت OAuth سفارشی، صفحه اتصال Databricks Genie را در ChatGPT باز نگه دارید تا بتوانید نشانی دقیق بازگشت را کپی کنید.
درباره قابلیتهای موردنیاز برنامه تصمیم بگیرید: Genie و داشبوردهای AI/BI، دسترسی گستردهتر به APIهای Databricks، یا برنامهای محدود به APIهای Databricks SQL. دسترسی صرفاً SQL برای عملیات Genie یا داشبورد کافی نیست.
برای کلاینت OAuth سفارشی، محلی امن برای نگهداری و استفاده از رمز محرمانه کلاینت Databricks.
اگر حساب یا فضای کاری Databricks شما دسترسی را از طریق فهرست دسترسی IP، کنترل ترافیک ورودی مبتنی بر زمینه، دیواره آتش یا خطمشی شبکه دیگری محدود میکند، به کمک مدیر Databricks نیاز دارید که بتواند محدودههای فعلی IP خروجی برنامههای ChatGPT را مجاز کند.
برای کلاینت OAuth سفارشی، نشانی بازگشت نمایشدادهشده در ChatGPT را دقیقاً کپی کنید.
مقادیری که باید آماده کنید
برای کلاینت OAuth سفارشی، نشانی بازگشت: این نشانی را از فرایند راهاندازی برنامه در ChatGPT کپی کنید.
برای کلاینت OAuth سفارشی، شناسه کلاینت OAuth مربوط به Databricks.
برای کلاینت OAuth سفارشی، رمز محرمانه کلاینت OAuth مربوط به Databricks.
برای کلاینت OAuth سفارشی، دامنههای دسترسی Databricks متناسب با قابلیتهای برنامه. برای اتصال جدید Genie یا داشبورد که
ai-gateway،dashboardsوoffline_accessرا نمایش میدهد، همین دامنههای دسترسی را آماده کنید. همه APIها (all-apisبههمراهoffline_access) همچنان گزینه جایگزین قدیمیتر با دسترسی گستردهتر است. از SQL فقط برای برنامهای استفاده کنید که به APIهای Databricks SQL محدود است.فیلدهای فضای کاری یا حساب Databricks که در فرایند راهاندازی ChatGPT درخواست میشوند.
OAuth داخلی
ابتدا پیشنیازهای بالا را تکمیل کنید. فقط زمانی از این روش استفاده کنید که OAuth داخلی در ChatGPT در دسترس و برای فضای کاری Databricks شما فعال باشد.
از یک مدیر Databricks بخواهید بررسی کند که برنامه ChatGPT در تنظیمات یکپارچهسازی برنامهها در کنسول حساب موجود و برای فضای کاری شما فعال باشد. اگر برنامه ChatGPT در کنسول حساب Databricks شما فهرست نشده است، با نماینده حساب خود در Databricks تماس بگیرید و بپرسید آیا این قابلیت برای حسابتان در دسترس است.
در ChatGPT، به حساب یا فضای کاریای بروید که برنامه باید در آن در دسترس باشد. برای راهاندازی شخصی، به تنظیمات > افزونهها بروید؛ برای راهاندازی در فضای کاری، بهعنوان مدیر یا مالک فضای کاری به کنسول مدیریت > افزونهها بروید.
Databricks Genie را انتخاب کنید، سپس افزودن اتصال برنامه را انتخاب کنید.
نام میزبان فضای کاری (الزامی) را بدون
https://یا مسیر URL وارد کنید.ChatGPT از این نام میزبان، نقطه پایان Genie MCP درون فضای کاری، یعنی
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp، را میسازد. نیازی به نقطه پایان منطقهای جداگانه برای MCP نیست.ادامه را انتخاب کنید، سپس وارد Databricks شوید و درخواست کسب رضایت را بررسی کنید.
مراحل بخشهای «اتصال و آزمایش» و «مدیریت دسترسی» را در ادامه دنبال کنید، از جمله آزمایش با اعضای مجاز و بررسی دسترسی به فضای کاری.
کلاینت OAuth سفارشی
ابتدا پیشنیازهای بالا را فراهم کنید. اگر OAuth داخلی در دسترس نیست یا سازمانتان استفاده از کلاینت OAuth خودش را الزامی میداند، این روش را انتخاب کنید. پس از راهاندازی، مراحل بخشهای «اتصال و آزمایش» و «مدیریت دسترسی» را در ادامه تکمیل کنید.
شروع راهاندازی OAuth سفارشی در ChatGPT
در ChatGPT، به حساب یا فضای کاریای بروید که برنامه باید در آن در دسترس باشد.
برای راهاندازی شخصی، به تنظیمات > افزونهها بروید؛ برای راهاندازی در فضای کاری، بهعنوان مدیر یا مالک فضای کاری به کنسول مدیریت > افزونهها بروید.
Databricks Genie را در فهرست انتخاب کنید.
افزودن اتصال برنامه را انتخاب کنید.
در کادر اتصال Databricks Genie، فیلدهای شناسه کلاینت OAuth و رمز محرمانه کلاینت OAuth را پیدا کنید. وارد کردن اطلاعات احراز هویت در همین فیلدهای نمایشدادهشده، روش استفاده از کلاینت سفارشی است؛ نیازی به انتخاب گزینهای جداگانه نیست.
URL بازگشت را از ChatGPT کپی کنید. این کادر را باز نگه دارید.

نمونه URL بازگشت:
https://chatgpt.com/connector/oauth/<callback_id>
شناسه بازگشت را حذف نکنید، به انتهای نشانی اسلش اضافه نکنید و آن را با یک URL عمومی ChatGPT جایگزین نکنید. URL ثبتشده در Databricks باید دقیقاً با URL بازگشت نمایشدادهشده در ChatGPT مطابقت داشته باشد.
ایجاد اتصال برنامه OAuth سفارشی در Databricks
کنسول حساب Databricks را برای حساب Databricks خود باز کنید.
در نوار کناری سمت چپ، تنظیمات را باز کنید.
زبانه اتصالهای برنامه را باز کنید.
افزودن اتصال را انتخاب کنید.

نامی برای برنامه وارد کنید، مثلاً ChatGPT Databricks.
در نشانیهای تغییر مسیر، نشانی بازگشتی را که از ChatGPT کپی کردهاید، بدون هیچ تغییری جایگذاری کنید.
در بخش دامنههای دسترسی، دامنههای دسترسی موردنیاز برنامه را انتخاب کنید.
برای اتصال جدید Genie یا داشبورد که در ChatGPT دامنههای
ai-gateway،dashboardsوoffline_accessرا نمایش میدهد، همین دامنههای دسترسی را در برنامه OAuth مربوط به Databricks مجاز کنید.همه APIها همچنان گزینه جایگزین قدیمیتر با دسترسی گستردهتر برای دسترسی عمومی به APIهای Databricks است. برای این پیکربندی، از
all-apisوoffline_accessدر ChatGPT استفاده کنید و مطمئن شوید که برنامه OAuth مربوط به Databricks هر دو را مجاز میداند. برای اتصال جدید Genie یا داشبورد، دامنههای دسترسی جزئیترِ نمایشدادهشده را ترجیح دهید.از SQL فقط برای برنامهای استفاده کنید که به APIهای Databricks SQL محدود است. دسترسی صرفاً SQL برای عملیات Genie یا داشبورد کافی نیست.
مطمئن شوید که هر دامنه دسترسی که بعداً در ChatGPT فهرست میشود، در این برنامه OAuth مربوط به Databricks فعال باشد. Databricks برای برنامههایی که در رابط کاربری ایجاد میشوند، بهطور خودکار openid، email، profile و offline_access را مجاز میکند.
مدت اعتبار توکنها را روی مقادیر پیشفرض Databricks نگه دارید، مگر اینکه سازمانتان خطمشی مشخصی داشته باشد: ۶۰ دقیقه برای توکن دسترسی و ۱۰۰۸۰ دقیقه برای توکن نوسازی.
تولید رمز محرمانه کلاینت را فعال کنید. ChatGPT برای این فرایند به کلاینت OAuth از نوع محرمانه نیاز دارد.
اتصال را ایجاد کنید.

کپی کردن اطلاعات احراز هویت از Databricks
در کادر گفتوگوی اتصال ایجاد شد، شناسه کلاینت را کپی کنید.
رمز محرمانه کلاینت را فوراً کپی کنید و در محلی امن نگه دارید.
اگر پیش از کپی کردن رمز محرمانه، کادر گفتوگو را بستید، اطلاعات احراز هویت برنامه OAuth را ایجاد یا تعویض کنید و از رمز محرمانه جدید استفاده کنید.
Databricks رمز محرمانه را فقط یک بار نمایش میدهد. مانند سایر اطلاعات احراز هویت از آن محافظت کنید و آن را در تصاویر صفحه، تیکتها، نظرها یا گفتوگوها قرار ندهید.
تکمیل راهاندازی OAuth سفارشی در ChatGPT
به کادر اتصال Databricks Genie برگردید.
شناسه کلاینت Databricks را در شناسه کلاینت OAuth وارد کنید.
رمز محرمانه کلاینت Databricks را در رمز محرمانه کلاینت OAuth وارد کنید.
با وارد کردن این اطلاعات احراز هویت، از کلاینت OAuth سفارشی شما استفاده میشود؛ نیازی به انتخاب گزینهای جداگانه نیست.
در دامنههای دسترسی (اختیاری)، دامنههای دسترسی موردنیاز برای نقطه پایان Databricks و قابلیتهای برنامهتان را وارد کنید. آنها را با دامنههای دسترسی فعالشده در برنامه OAuth در Databricks مطابقت دهید.
برای اتصال جدید Genie/داشبورد که
ai-gateway،dashboardsوoffline_accessرا نمایش میدهد، همین دامنههای دسترسی را نگه دارید. مطمئن شوید برنامه OAuth در Databricks همین دامنههای دسترسی را مجاز میداند.ai-gatewayاتصال Genie MCP درون فضای کاری را فعال میکند،dashboardsعملیات داشبورد AI/BI را فعال میکند وoffline_accessامکان استفاده از توکنهای نوسازی را فراهم میکند.گزینه قدیمیتر و گستردهتر، یعنی
all-apisوoffline_access، همچنان برای دسترسی گستردهتر به API پشتیبانی میشود، اما برای این اتصال Genie/داشبورد گزینه ترجیحی نیست. اگر برنامه Databricks فقطall-apisرا مجاز میداند، آن را بهروزرسانی یا دوباره ایجاد کنید تاai-gateway،dashboardsوoffline_accessرا مجاز بداند. اگر دامنههای دسترسی جزئی در دسترس نیستند، آگاهانه ChatGPT را رویall-apisوoffline_accessتنظیم کنید و مطمئن شوید برنامه Databricks هر دو را مجاز میداند. وقتی برنامه Databricks فقطall-apisرا مجاز میداند، آن سه دامنه دسترسی جزئی را در ChatGPT درخواست نکنید.هر دامنه دسترسی را در یک خط وارد کنید یا آنها را با کاما از هم جدا کنید. هر دامنه دسترسی درجشده در ChatGPT باید در برنامه OAuth در Databricks فعال باشد.
نام میزبان فضای کاری (الزامی) را بدون https:// یا مسیر URL وارد کنید. سایر فیلدهای الزامی مربوط به ارائهدهنده Databricks را که در روند راهاندازی نمایش داده میشوند، تکمیل کنید.
ChatGPT از این نام میزبان، نقطه پایان Genie MCP درون فضای کاری، یعنی
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp، را میسازد. نیازی به نقطه پایان منطقهای جداگانه برای MCP نیست.ادامه را انتخاب کنید.
ChatGPT دقیقاً همان دامنههای دسترسی واردشده در دامنههای دسترسی (اختیاری) را درخواست میکند. دامنههای دسترسی گستردهترِ الگو را بهطور خودکار اضافه نمیکند.

اتصال و آزمایش
برای هر یک از دو روش OAuth، آزمایشهای اتصال و بررسیهای دسترسی زیر را انجام دهید.
جزئیات برنامه، عملیات و تنظیمات احراز هویت را بررسی کنید.
اگر مدیر فضای کاری هستید، برنامه را برای فضای کاری فعال کنید و طبق خطمشی فضای کاری تعیین کنید چه کسانی میتوانند از آن استفاده کنند.
با حساب یک کاربر آزمایشی دارای مجوز، فرایند اتصال را از ChatGPT شروع کنید، سپس وارد Databricks شوید.
مطمئن شوید که مرورگر حساب یا فضای کاری موردنظر Databricks را باز میکند.
دامنههای دسترسی درخواستی را بررسی کنید، سپس اعطای مجوز را انتخاب کنید.

بررسی کنید که مرورگر به ChatGPT برگردد و وضعیت برنامه «متصل» نمایش داده شود.
یک عملیات خواندن کمخطر و متناسب با قابلیتهای اتصال اجرا کنید. برای اتصال Genie، درخواستی به Genie درباره دادههایی بفرستید که کاربر آزمایشی مجاز به دسترسی به آنهاست. برای سایر قابلیتهای پشتیبانیشده، اطلاعات کاربر فعلی را دریافت کنید یا روی یک منبع تأییدشده Databricks SQL پرسوجو اجرا کنید. مطمئن شوید که کاربر مجوزهای لازم برای منابع Databricks را دارد؛ دامنههای دسترسی OAuth بهتنهایی مجوز دسترسی به دادهها را نمیدهند.
اگر عملیات نوشتن فعال است، پیش از عرضه گستردهتر، آن را با یک گردشکار Databricks که از کمخطر بودنش مطمئن هستید آزمایش کنید.
برای راهاندازی در فضای کاری، از یکی از اعضای غیرمدیر که مجوز استفاده دارد بخواهید متصل شود و آزمایش کمخطر را تکرار کند.
مدیریت دسترسی
Databricks و ChatGPT هر دو در کنترل دسترسی نقش دارند.
در ChatGPT، مدیران فضای کاری در دسترس بودن برنامه و نحوه استفاده اعضا از آن را مدیریت میکنند. در Business، مدیران تعیین میکنند که برنامه در سراسر فضای کاری فعال باشد یا نه. برای موارد زیر، کنترلهای مدیریتی برنامههای Databricks را در مسیر (تنظیمات فضای کاری > برنامهها یا کنسول مدیریت > افزونهها > مدیریت برنامههای قدیمی) بررسی کنید:
دسترسی کاربران، برای تعیین اینکه کدام نقشهای فضای کاری میتوانند در فضاهای کاری پشتیبانیشده Enterprise و Edu از برنامه استفاده کنند.
کنترل عملیات، برای تعیین اینکه کدام عملیات Databricks فعال باشند.
مجوزهای برنامه، برای تعیین اینکه ChatGPT چه زمانی پیش از استفاده از برنامه از اعضا اجازه بگیرد.
این مجوزهای برنامه بر گفتوگوهای ChatGPT اعمال میشوند. عاملهای فضای کاری از کنترلهای اختصاصی هر عامل که سازنده آن تنظیم کرده است استفاده میکنند تا تعیین کنند کدام عملیات برنامه در دسترس باشد و چه زمانی از کاربران نهایی برای اجرای آنها تأیید گرفته شود. برای آشنایی با رفتار عامل، به عاملهای فضای کاری ChatGPT برای Enterprise و Business مراجعه کنید.
در Databricks، مدیران تعیین میکنند کدام کاربران میتوانند به برنامه OAuth اجازه دسترسی بدهند و این کاربران به کدام منابع Databricks دسترسی داشته باشند. پس از فعال شدن برنامه در ChatGPT، مجوزهای ارائهدهنده همچنان اعمال میشوند.
برای آشنایی با مسیرهای دسترسی در فضای کاری، دسترسی به برنامه و کنترلهای برنامه مختص هر طرح، به کنترلهای مدیریتی، امنیت و انطباق در برنامهها مراجعه کنید.
عیبیابی راهاندازی برنامه Databricks
عدم تطابق URI تغییر مسیر: اگر از کلاینت OAuth سفارشی استفاده میکنید، بررسی کنید که مقدار نشانیهای تغییر مسیر در Databricks دقیقاً با نشانی بازگشت نمایشدادهشده در ChatGPT، از جمله مسیر و شناسه بازگشت آن، مطابقت داشته باشد. شناسه بازگشت را حذف نکنید، به انتهای نشانی اسلش اضافه نکنید و نشانی تغییر مسیر دیگری از ChatGPT را جایگزین آن نکنید.
رمز محرمانه در دسترس نیست: اگر از کلاینت OAuth سفارشی استفاده میکنید، توجه داشته باشید که رمزهای محرمانه Databricks فقط یک بار نمایش داده میشوند. اگر رمز محرمانه کلاینت را کپی نکردهاید، رمز جدیدی تولید کنید.
برنامه OAuth بلافاصله در دسترس قرار نمیگیرد: به گفته Databricks، پردازش بهروزرسانیهای برنامه OAuth ممکن است تا ۳۰ دقیقه طول بکشد.
دامنه دسترسی ناکافی یا نامطابق: اگر از کلاینت OAuth سفارشی استفاده میکنید، دامنههای دسترسی (اختیاری) در ChatGPT را با دامنههای دسترسی در برنامه OAuth مربوط به Databricks مقایسه کنید. هر دامنه دسترسی که ChatGPT درخواست میکند، باید در آنجا فعال باشد. مطمئن شوید که دامنههای دسترسی از نقطه پایان و قابلیتهایی که استفاده میکنید پشتیبانی میکنند.
برای اتصال جدید Genie یا داشبورد که
ai-gateway،dashboardsوoffline_accessرا نمایش میدهد، این دامنههای دسترسی را در ChatGPT نگه دارید و مطمئن شوید که برنامه Databricks هر سه را مجاز میداند. اگر برنامه فقطall-apisرا مجاز میداند، آن را بهروزرسانی یا دوباره ایجاد کنید تا هر سه دامنه دسترسی جزئیتر را مجاز کند.اگر دامنههای دسترسی جزئیتر در دسترس نیستند، از گزینه جایگزین گستردهتر و پشتیبانیشده استفاده کنید: دامنههای دسترسی ChatGPT را روی
all-apisوoffline_accessتنظیم کنید و مطمئن شوید که برنامه Databricks هر دو را مجاز میداند. برنامهای که فقطall-apisرا مجاز میداند، با درخواست ChatGPT برایai-gateway،dashboardsوoffline_accessمطابقت ندارد. دسترسی صرفاً SQL فقط برای برنامهای مناسب است که به APIهای Databricks SQL محدود باشد؛ این دسترسی برای عملیات Genie یا داشبورد کافی نیست.عملیات SQL ناموفق است: برای برنامهای که به APIهای Databricks SQL محدود است، دامنه دسترسی SQL، پیکربندی انبار داده و مجوزهای Databricks را بررسی کنید.
فضای کاری ChatGPT اشتباه است: برنامه را در همان فضای کاری ChatGPT ایجاد و فعال کنید که کاربران قرار است آن را متصل کنند.
حساب یا فضای کاری Databricks اشتباه است: مقدار نام میزبان فضای کاری (الزامی) را بررسی کنید، سپس فرایند ورود را تکرار کنید و مطمئن شوید که Databricks حساب یا فضای کاری موردنظر را باز میکند.
کاربران نمیتوانند متصل شوند: مطمئن شوید که کاربر به Databricks دسترسی دارد و مجاز است به برنامه OAuth اجازه دسترسی بدهد. در Business، مطمئن شوید که برنامه در سراسر فضای کاری فعال است. در فضاهای کاری Enterprise و Edu که از این قابلیت پشتیبانی میکنند، همچنین بررسی کنید که تنظیمات دسترسی کاربران در ChatGPT استفاده از برنامه را مجاز کند.
خطمشی شبکه Databricks برنامه را مسدود میکند: اگر Databricks فقط IPهای مبدأ مشخصی را مجاز میداند، مدیر Databricks باید فهرستهای دسترسی IP حساب یا فضای کاری مربوطه، کنترلهای ترافیک ورودی مبتنی بر زمینه، دیواره آتش یا سایر قوانین شبکه تحت کنترل مشتری را بهروزرسانی کند.
اتصالهای ورودی از محدودههای فعلی IP خروجی برنامههای ChatGPT را مجاز کنید.
این فهرست مجاز را در Databricks یا لایه شبکه تحت کنترل مشتری پیکربندی کنید. این فهرست از فهرست IPهای مجاز فضای کاری ChatGPT جداست.
محدودههای منتشرشده ممکن است تغییر کنند. در صورت امکان، بهروزرسانی از فایل JSON را خودکار کنید.
برای دور زدن مسدودسازی شبکه، رمز محرمانه کلاینت را تعویض نکنید و دامنههای دسترسی OAuth را تغییر ندهید. ابتدا بررسی کنید که آیا Databricks اتصال از IPهای مبدأ برنامه را رد میکند یا خیر.
