Скористайтеся цим посібником, якщо ви адміністратор робочого простору ChatGPT і налаштовуєте шаблон застосунку Databricks для своєї організації. Шаблон — це не кінцевий застосунок, яким користуються учасники. Це процес налаштування, який створює чернетку застосунку для конкретного робочого простору після того, як ви надасте потрібну конфігурацію Databricks.
Для Databricks більшість налаштувань виконується в консолі облікового запису Databricks. Ви створюєте підключення власного застосунку OAuth, реєструєте URL-адресу зворотного виклику ChatGPT, копіюєте згенеровані облікові дані клієнта, а потім вставляєте ці значення в процес налаштування шаблону ChatGPT. Після того як ChatGPT створить чернетку застосунку, ви зможете опублікувати її та керувати нею, як іншими застосунками робочого простору.
Що ви налаштовуєте
Ви створюєте в ChatGPT застосунок Databricks для конкретного робочого простору. Застосунок використовує:
Підключення застосунку Databricks OAuth, створене в консолі облікового запису Databricks.
Ідентифікатор клієнта та секрет клієнта Databricks OAuth.
Точну URL-адресу зворотного виклику, скопійовану з ChatGPT.
Області доступу Databricks, які відповідають можливостям конектора, що ви хочете ввімкнути.
Будь-які відомості про постачальника Databricks, які запитує процес налаштування ChatGPT, як-от хост робочого простору, хост облікового запису, ідентифікатор облікового запису або сховище.
Перш ніж почати
Вам потрібно:
Доступ адміністратора або власника робочого простору ChatGPT.
Доступ адміністратора облікового запису Databricks. Доступ адміністратора робочого простору може бути достатнім для деяких завдань, але підключення власних застосунків налаштовуються в консолі облікового запису Databricks.
Консоль облікового запису Databricks, відкрита на окремій вкладці.
Екран налаштування шаблону застосунку Databricks, відкритий у ChatGPT, щоб можна було скопіювати точну URL-адресу зворотного виклику.
Рішення про те, чи потрібен застосунку загальний доступ до API Databricks, чи лише доступ до Databricks SQL.
Безпечне місце для роботи із секретом клієнта Databricks.
Не вигадуйте URL-адресу зворотного виклику. Скопіюйте точну URL-адресу зворотного виклику, показану в ChatGPT.
Значення, які потрібно підготувати
URL-адреса зворотного виклику: скопіюйте її з процесу налаштування шаблону ChatGPT.
Ідентифікатор клієнта Databricks OAuth.
Секрет клієнта Databricks OAuth.
Області доступу Databricks, як-от ALL APIs або SQL.
Поля робочого простору або облікового запису Databricks, які запитує процес налаштування ChatGPT.
Опублікуйте застосунок і керуйте ним у ChatGPT
Створення чернетки застосунку не робить його автоматично доступним для учасників. Після перегляду чернетки:
Опублікуйте чернетку застосунку.
Переконайтеся, що застосунок відображається в розділі Налаштування робочого простору > Застосунки > Увімкнено.
Налаштуйте Доступ користувачів для ролей, які мають ним користуватися.
Перегляньте Керування діями для дій Databricks, які надає застосунок.
Перегляньте Дозволи застосунку, щоб вибрати, коли ChatGPT має запитувати учасників перед використанням застосунку.
Попросіть дозволеного тестового користувача відкрити Застосунки в ChatGPT і підтвердити, що застосунок відображається.
Ці дозволи застосунку застосовуються до розмов у ChatGPT. Агенти робочого простору використовують налаштування для кожного агента, задані його розробником, щоб визначати, які дії застосунку доступні та коли кінцевих користувачів просять їх схвалити. Щодо поведінки агентів див.: Агенти робочого простору ChatGPT для Enterprise і Business.
Почніть налаштування шаблону в ChatGPT
У ChatGPT перейдіть до робочого простору, де застосунок має бути доступний.
Відкрийте Налаштування робочого простору > Застосунки.
Виберіть Каталог.
Знайдіть Databricks.
Виберіть шаблон застосунку Databricks і почніть налаштування.
Введіть зрозумілі назву й опис застосунку, наприклад Databricks або Databricks - Data Platform.
У розділі клієнта OAuth скопіюйте URL-адресу зворотного виклику з ChatGPT. Залиште цю вкладку відкритою.
Приклад URL-адреси зворотного виклику: https://chatgpt.com/connector/oauth/<callback_id>
Не видаляйте ідентифікатор зворотного виклику, не додавайте кінцеву скісну риску й не замінюйте її загальною URL-адресою ChatGPT.
Створіть підключення застосунку OAuth у Databricks
Відкрийте консоль облікового запису Databricks для свого облікового запису Databricks.
На лівій бічній панелі відкрийте Налаштування.
Відкрийте вкладку Підключення застосунків.
Виберіть Додати підключення.
Введіть назву застосунку, наприклад ChatGPT Databricks Connector.
У URL-адреси переспрямування вставте точну URL-адресу зворотного виклику, скопійовану з ChatGPT.
У розділі Області доступу виберіть області, потрібні застосунку.
Використовуйте ALL APIs для загального застосунку Databricks, якому потрібні API Databricks поза SQL.
Використовуйте лише SQL для застосунку, обмеженого API Databricks SQL.
Залиште TTL токенів зі стандартними значеннями Databricks, якщо ваша організація не має спеціальної політики.
Увімкніть Згенерувати секрет клієнта. Для цього процесу ChatGPT потрібен конфіденційний клієнт OAuth.
Створіть підключення.
Скопіюйте облікові дані з Databricks
У діалоговому вікні створеного підключення скопіюйте Client ID.
Одразу скопіюйте Client secret і збережіть його в безпечному місці.
Якщо ви закрили діалогове вікно до копіювання секрету, створіть або змініть облікові дані застосунку OAuth і використайте новий секрет.
Databricks показує секрет лише один раз. Ставтеся до нього як до облікових даних і не додавайте його до знімків екрана, заявок, коментарів або чатів.
Завершіть налаштування в ChatGPT
Поверніться на вкладку налаштування шаблону ChatGPT.
Вставте Client ID Databricks у поле ідентифікатора клієнта OAuth.
Вставте Client secret Databricks у поле секрету клієнта OAuth.
Залиште області доступу без змін, якщо вам не потрібно навмисно перевизначити стандартні значення шаблону.
Заповніть усі поля постачальника Databricks, потрібні для процесу налаштування, як-от хост робочого простору, хост облікового запису, ідентифікатор облікового запису, сховище або інші значення, специфічні для Databricks.
Створіть чернетку застосунку.
Протестуйте застосунок як користувач
Запустіть процес підключення з ChatGPT як дозволений тестовий користувач.
Переконайтеся, що браузер відкриває очікуваний обліковий запис або робочий простір Databricks.
Схваліть запитані області доступу.
Перевірте, що браузер повертається до ChatGPT, а застосунок відображається як підключений.
Спочатку виконайте дію читання з низьким ризиком, наприклад отримання інформації про поточного користувача або запит до схваленого ресурсу Databricks SQL.
Якщо дії запису ввімкнено, перед ширшим розгортанням протестуйте їх за допомогою явно низькоризикового робочого процесу Databricks.
Керуйте доступом
Databricks і ChatGPT разом забезпечують контроль доступу.
У ChatGPT адміністратори робочого простору керують тим, чи доступний опублікований застосунок, які ролі робочого простору можуть ним користуватися, які дії ввімкнено та коли ChatGPT запитує користувачів перед використанням застосунку.
У Databricks адміністратори керують тим, які користувачі можуть авторизувати застосунок OAuth і до яких ресурсів Databricks ці користувачі мають доступ. Дозволи постачальника продовжують діяти після ввімкнення застосунку в ChatGPT.
Усунення несправностей
Невідповідність URI переспрямування: переконайтеся, що URL-адреса переспрямування Databricks точно збігається з URL-адресою зворотного виклику, показаною в ChatGPT, включно зі шляхом та ідентифікатором зворотного виклику.
Секрет відсутній: секрети Databricks відображаються лише один раз. Згенеруйте новий секрет клієнта, якщо його не було скопійовано.
Застосунок OAuth доступний не одразу: Databricks зазначає, що обробка оновлень застосунку OAuth може тривати до 30 хвилин.
Недостатня область доступу: якщо ChatGPT може автентифікуватися, але виклики API Databricks не виконуються, переконайтеся, що застосунок Databricks має ALL APIs, коли йому потрібні API не для SQL.
Дії SQL не виконуються: перевірте область доступу SQL, конфігурацію сховища та дозволи Databricks.
Неправильний робочий простір: створіть і опублікуйте застосунок у тому самому робочому просторі ChatGPT, де користувачі підключатимуть його.
Користувачі не можуть підключитися: переконайтеся, що користувач має доступ до Databricks і йому дозволено авторизувати застосунок OAuth.