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

برای Databricks، بیشتر مراحل راه‌اندازی در کنسول حساب Databricks انجام می‌شود. یک اتصال برنامه OAuth سفارشی ایجاد می‌کنید، URL بازگشت ChatGPT را ثبت می‌کنید، اعتبارنامه‌های مشتری ایجادشده را کپی می‌کنید، سپس آن مقادیر را در جریان راه‌اندازی قالب ChatGPT جای‌گذاری می‌کنید. پس از اینکه ChatGPT برنامه پیش‌نویس را ایجاد کرد، می‌توانید آن را منتشر کنید و مانند سایر برنامه‌های فضای کاری مدیریت کنید.

آنچه راه‌اندازی می‌کنید

در ChatGPT یک برنامه Databricks مخصوص فضای کاری ایجاد می‌کنید. برنامه از این موارد استفاده می‌کند:

• یک اتصال برنامه OAuth Databricks که در کنسول حساب Databricks شما ایجاد شده است.

• شناسه مشتری و رمز محرمانه مشتری OAuth Databricks.

• URL بازگشت دقیق که از ChatGPT کپی شده است.

• دامنه‌های Databricks که با قابلیت‌های اتصال‌دهنده‌ای که می‌خواهید فعال کنید مطابقت دارند.

• هرگونه جزئیات ارائه‌دهنده Databricks که جریان راه‌اندازی ChatGPT درخواست می‌کند، مانند میزبان فضای کاری، میزبان حساب، شناسه حساب یا انبار داده.

پیش از شروع

به این موارد نیاز دارید:

• دسترسی مدیر یا مالک فضای کاری ChatGPT.

• دسترسی مدیر حساب Databricks. دسترسی مدیر فضای کاری ممکن است برای برخی کارها کافی باشد، اما اتصال‌های برنامه سفارشی از کنسول حساب Databricks پیکربندی می‌شوند.

• کنسول حساب Databricks در یک زبانه جداگانه باز باشد.

• صفحه راه‌اندازی قالب برنامه Databricks در ChatGPT باز باشد تا بتوانید URL بازگشت دقیق را کپی کنید.

• تصمیمی درباره اینکه آیا برنامه به دسترسی عمومی به APIهای Databricks نیاز دارد یا فقط به دسترسی Databricks SQL.

• جایی امن برای نگهداری رمز محرمانه مشتری Databricks.

URL بازگشت را از خود نسازید. URL بازگشت دقیقی را که در ChatGPT نشان داده شده است کپی کنید.

مقادیر لازم برای آماده‌سازی

• URL بازگشت: این را از جریان راه‌اندازی قالب ChatGPT کپی کنید.

• شناسه مشتری OAuth Databricks.

• رمز محرمانه مشتری OAuth Databricks.

• دامنه‌های دسترسی Databricks، مانند ALL APIs یا SQL.

• فیلدهای فضای کاری یا حساب Databricks که جریان راه‌اندازی ChatGPT درخواست می‌کند.

انتشار و مدیریت برنامه در ChatGPT

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

1. برنامه پیش‌نویس را منتشر کنید.

2. تأیید کنید که برنامه در تنظیمات فضای کاری > برنامه‌ها > فعال‌شده ظاهر می‌شود.

3. دسترسی کاربر را برای نقش‌هایی که باید از آن استفاده کنند پیکربندی کنید.

4. کنترل اقدام را برای اقدام‌های Databricks که برنامه در دسترس قرار می‌دهد بررسی کنید.

5. مجوزهای برنامه را بررسی کنید تا انتخاب کنید ChatGPT چه زمانی پیش از استفاده از برنامه از اعضا سؤال کند.

6. از یک کاربر آزمایشی مجاز بخواهید برنامه‌ها را در ChatGPT باز کند و تأیید کند که برنامه ظاهر می‌شود.

این مجوزهای برنامه برای گفت‌وگوهای ChatGPT اعمال می‌شوند. عامل‌های فضای کاری از کنترل‌های جداگانه هر عامل که توسط سازندهٔ عامل تنظیم می‌شود استفاده می‌کنند تا تعیین کنند کدام اقدام‌های برنامه در دسترس باشند و چه زمانی از کاربران نهایی خواسته شود آن‌ها را تأیید کنند. برای رفتار عامل، ببینید: عامل‌های فضای کاری ChatGPT برای Enterprise و Business.

شروع راه‌اندازی قالب در ChatGPT

1. در ChatGPT، به فضای کاری‌ای بروید که برنامه باید در آن در دسترس باشد.

2. تنظیمات فضای کاری > برنامه‌ها را باز کنید.

3. فهرست را انتخاب کنید.

4. Databricks را جست‌وجو کنید.

5. قالب برنامه Databricks را انتخاب کنید و راه‌اندازی را شروع کنید.

6. یک نام و توضیح روشن برای برنامه وارد کنید، مانند Databricks یا Databricks - Data Platform.

7. در بخش مشتری OAuth، URL بازگشت را از ChatGPT کپی کنید. این زبانه را باز نگه دارید.

نمونه URL بازگشت: https://chatgpt.com/connector/oauth/<callback_id>

شناسه بازگشت را حذف نکنید، اسلش پایانی اضافه نکنید، و آن را با یک URL عمومی ChatGPT جایگزین نکنید.

ایجاد اتصال برنامه OAuth در Databricks

1. کنسول حساب Databricks را برای حساب Databricks خود باز کنید.

2. در نوار کناری چپ، تنظیمات را باز کنید.

3. زبانه اتصال‌های برنامه را باز کنید.

4. افزودن اتصال را انتخاب کنید.

5. یک نام برنامه وارد کنید، مانند ChatGPT Databricks Connector.

6. در URLهای تغییرمسیر، URL بازگشت دقیقی را که از ChatGPT کپی کرده‌اید جای‌گذاری کنید.

7. در بخش دامنه‌های دسترسی، دامنه‌هایی را که برنامه نیاز دارد انتخاب کنید.

8. برای یک برنامه عمومی Databricks که فراتر از SQL به APIهای Databricks نیاز دارد، از ALL APIs استفاده کنید.

9. برای برنامه‌ای که به APIهای Databricks SQL محدود است، فقط از SQL استفاده کنید.

10. TTLهای توکن را روی پیش‌فرض‌های Databricks بگذارید، مگر اینکه سازمان شما سیاست خاصی داشته باشد.

11. ایجاد رمز محرمانه مشتری را فعال کنید. ChatGPT برای این جریان به یک مشتری OAuth محرمانه نیاز دارد.

12. اتصال را ایجاد کنید.

کپی کردن اعتبارنامه‌ها از Databricks

1. در گفت‌وگوی ایجاد اتصال، شناسه مشتری را کپی کنید.

2. رمز محرمانه مشتری را فوراً کپی کنید و آن را به‌صورت امن نگه دارید.

3. اگر پیش از کپی کردن رمز محرمانه، گفت‌وگو را ببندید، اعتبارنامه‌های برنامه OAuth را ایجاد یا چرخش دهید و از رمز محرمانه جدید استفاده کنید.

Databricks رمز محرمانه را فقط یک‌بار نشان می‌دهد. با آن مانند یک اعتبارنامه رفتار کنید و آن را در نماگرفت‌ها، تیکت‌ها، نظرها یا چت‌ها قرار ندهید.

تکمیل راه‌اندازی در ChatGPT

1. به زبانه راه‌اندازی قالب ChatGPT برگردید.

2. شناسه مشتری Databricks را در شناسه مشتری OAuth جای‌گذاری کنید.

3. رمز محرمانه مشتری Databricks را در رمز محرمانه مشتری OAuth جای‌گذاری کنید.

4. دامنه‌ها را بدون تغییر بگذارید، مگر اینکه عمداً بخواهید پیش‌فرض‌های قالب را نادیده بگیرید.

5. هر فیلد ارائه‌دهنده Databricks را که جریان راه‌اندازی لازم می‌داند پر کنید؛ مانند میزبان فضای کاری، میزبان حساب، شناسه حساب، انبار داده یا سایر مقادیر ویژه Databricks.

6. برنامه پیش‌نویس را ایجاد کنید.

برنامه را به‌عنوان کاربر آزمایش کنید

1. جریان اتصال را از ChatGPT و به‌عنوان یک کاربر آزمایشی مجاز شروع کنید.

2. تأیید کنید که مرورگر حساب یا فضای کاری Databricks مورد انتظار را باز می‌کند.

3. دامنه‌های درخواست‌شده را تأیید کنید.

4. بررسی کنید که مرورگر به ChatGPT برمی‌گردد و برنامه به‌صورت متصل نشان داده می‌شود.

5. ابتدا یک اقدام خواندنی کم‌ریسک اجرا کنید، مانند دریافت اطلاعات کاربر فعلی یا پرس‌وجو از یک منبع Databricks SQL تأییدشده.

6. اگر اقدام‌های نوشتن فعال هستند، پیش از انتشار گسترده‌تر، با یک گردش کار Databricks که آشکارا کم‌ریسک است آزمایش کنید.

مدیریت دسترسی

Databricks و ChatGPT هر دو در کنترل دسترسی نقش دارند.

در ChatGPT، مدیران فضای کاری مدیریت می‌کنند که آیا برنامه منتشرشده در دسترس باشد، کدام نقش‌های فضای کاری بتوانند از آن استفاده کنند، کدام اقدام‌ها فعال باشند و ChatGPT چه زمانی پیش از استفاده از برنامه از کاربران سؤال کند.

در Databricks، مدیران مدیریت می‌کنند که کدام کاربران بتوانند برنامه OAuth را مجاز کنند و آن کاربران به کدام منابع Databricks دسترسی داشته باشند. پس از فعال شدن برنامه در ChatGPT، مجوزهای ارائه‌دهنده همچنان اعمال می‌شوند.

عیب‌یابی

• عدم تطابق URI تغییرمسیر: تأیید کنید URL تغییرمسیر Databricks دقیقاً با URL بازگشت نشان‌داده‌شده در ChatGPT، از جمله مسیر و شناسه بازگشت، مطابقت دارد.

• رمز محرمانه موجود نیست: رمزهای محرمانه Databricks فقط یک‌بار نمایش داده می‌شوند. اگر کپی نشده است، یک رمز محرمانه مشتری جدید ایجاد کنید.

• برنامه OAuth بلافاصله در دسترس نیست: Databricks می‌گوید پردازش به‌روزرسانی‌های برنامه OAuth می‌تواند تا ۳۰ دقیقه طول بکشد.

• دامنه ناکافی: اگر ChatGPT می‌تواند احراز هویت کند اما فراخوانی‌های API Databricks ناموفق هستند، تأیید کنید که وقتی برنامه به APIهای غیر SQL نیاز دارد، برنامه Databricks دارای ALL APIs باشد.

• اقدام‌های SQL ناموفق هستند: دامنه SQL، پیکربندی انبار داده و مجوزهای Databricks را تأیید کنید.

• فضای کاری اشتباه: برنامه را در همان فضای کاری ChatGPT ایجاد و منتشر کنید که کاربران در آن به برنامه وصل خواهند شد.

• کاربران نمی‌توانند وصل شوند: تأیید کنید کاربر دسترسی Databricks دارد و مجاز است برنامه OAuth را تأیید کند.

منابع

• مستندات Databricks: احراز هویت با استفاده از OAuth کاربر به ماشین

• مستندات Databricks: مدیریت اتصال‌های برنامه OAuth