Для перекладу цієї сторінки виконано машинний переклад. Ви можете переглянути оригінальну статтю англійською.

Налаштування шаблону застосунку Databricks у ChatGPT

Дізнайтеся, як адміністратори робочих просторів ChatGPT і користувачі ChatGPT Plus або ChatGPT Pro можуть підключити Databricks за допомогою OAuth-клієнта своєї організації.

Оновлено: 27 days ago

Цей посібник призначений для адміністраторів робочого простору ChatGPT і користувачів ChatGPT Plus або Pro, які налаштовують застосунок Databricks Genie за допомогою вбудованого OAuth або OAuth-клієнта своєї організації.

  • Вбудований OAuth: якщо він доступний у ChatGPT й увімкнений для вашого робочого простору Databricks, використовуйте попередньо налаштоване підключення. Вам не потрібно створювати OAuth-застосунок або вводити ідентифікатор чи секрет клієнта. Дотримуйтеся вказівок у розділі «Вбудований OAuth» нижче.

  • Власний OAuth-клієнт: виберіть цей спосіб, якщо вбудований OAuth недоступний або ваша організація вимагає використання власного OAuth-клієнта. Дотримуйтеся вказівок у розділі «Власний OAuth-клієнт» нижче.

Що ви налаштовуєте

Ви створюєте підключення застосунку Databricks для свого облікового запису або робочого простору ChatGPT. Для обох способів потрібні дані постачальника Databricks, які запитує ChatGPT, і дозволи на ресурси, які ви плануєте використовувати. Якщо ви використовуєте власний OAuth-клієнт, також підготуйте:

  • Підключення OAuth-застосунку Databricks, створене в консолі облікового запису Databricks.

  • Ідентифікатор і секрет OAuth-клієнта Databricks.

  • Точну URL-адресу зворотного виклику, скопійовану з ChatGPT.

  • Області доступу Databricks, що відповідають функціям застосунку, які ви хочете ввімкнути.

  • Усі дані постачальника Databricks, які запитує ChatGPT під час налаштування, як-от хост робочого простору, хост облікового запису, ідентифікатор облікового запису або сховище.

Перш ніж почати

Для налаштування в робочому просторі відкрийте консоль адміністратора, виберіть потрібний робочий простір ChatGPT і відкрийте розділ «Плагіни». Виберіть «Керування застарілими застосунками», щоб відкрити збережену сторінку «Застосунки». Відомості про навігацію в робочому просторі й доступ до застарілих застосунків наведено в статті «Адміністративні засоби керування, безпека й відповідність вимогам для плагінів і застосунків».

Вам знадобляться:

  • Права адміністратора або власника робочого простору ChatGPT чи обліковий запис ChatGPT Plus або Pro.

  • Для власного OAuth-клієнта — права адміністратора облікового запису Databricks. Для деяких завдань може бути достатньо прав адміністратора робочого простору, але підключення власних застосунків налаштовуються в консолі облікового запису Databricks. Для вбудованого OAuth адміністратор Databricks має перевірити, чи доступний застосунок ChatGPT і чи ввімкнений він для вашого робочого простору.

  • Для власного OAuth-клієнта — консоль облікового запису Databricks, відкрита в окремій вкладці.

  • Для власного OAuth-клієнта — відкритий у ChatGPT екран підключення Databricks Genie, щоб скопіювати точну URL-адресу зворотного виклику.

  • Рішення щодо потрібних функцій застосунку: Genie та інформаційні панелі AI/BI, ширший доступ до API Databricks чи робота виключно з API Databricks SQL. Доступу лише до SQL недостатньо для дій із Genie або інформаційними панелями.

  • Для власного OAuth-клієнта — безпечне місце для роботи із секретом клієнта Databricks.

  • Якщо ваш обліковий запис або робочий простір Databricks обмежує доступ за допомогою списку IP-доступу, контекстного контролю вхідного трафіку, брандмауера чи іншої мережевої політики — допомога адміністратора Databricks, який може дозволити актуальні діапазони вихідних IP-адрес застосунків ChatGPT.

Для власного OAuth-клієнта скопіюйте точне значення URL зворотного виклику, що відображається в ChatGPT.

Значення, які потрібно підготувати

  • Для власного OAuth-клієнта — URL зворотного виклику: скопіюйте його під час налаштування застосунку в 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.

  1. Попросіть адміністратора Databricks перевірити, чи застосунок ChatGPT доступний у налаштуваннях інтеграцій застосунків консолі облікового запису та чи ввімкнений він для вашого робочого простору. Якщо застосунку ChatGPT немає в консолі облікового запису Databricks, зверніться до представника Databricks, який супроводжує ваш обліковий запис, і запитайте, чи доступна вам ця функція.

  2. У ChatGPT перейдіть до облікового запису або робочого простору, у якому має бути доступний застосунок. Для особистого налаштування перейдіть до Налаштування > Плагіни, а для налаштування робочого простору — до Консоль адміністратора > Плагіни з правами адміністратора або власника робочого простору.

  3. Виберіть Databricks Genie, а потім — Додати підключення застосунку.

  4. У полі Ім’я хоста робочого простору (обов’язково) введіть значення без https:// і шляху URL.

    На основі цього імені хоста ChatGPT визначає кінцеву точку MCP для Genie в межах робочого простору: https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Окрема регіональна кінцева точка MCP не потрібна.

  5. Виберіть Продовжити, увійдіть у Databricks і перегляньте запит на згоду.

Далі виконайте кроки з розділів «Підключення та перевірка» й «Керування доступом» нижче, зокрема тести для учасників із дозволеним доступом і перевірки доступу до робочого простору.

Власний OAuth-клієнт

Спершу виконайте попередні вимоги, наведені вище. Виберіть цей спосіб, якщо вбудований OAuth недоступний або ваша організація вимагає використовувати власний OAuth-клієнт. Після налаштування виконайте вказівки з розділів «Підключення й тестування» та «Керування доступом» нижче.

Почніть налаштування власного клієнта OAuth у ChatGPT

  1. У ChatGPT перейдіть до облікового запису або робочого простору, у якому має бути доступний застосунок.

  2. Для особистого налаштування перейдіть до Налаштування > Плагіни, а для налаштування робочого простору — до Консоль адміністратора > Плагіни з правами адміністратора або власника робочого простору.

  3. Виберіть Databricks Genie у розділі Каталог.

  4. Виберіть Додати підключення застосунку.

  5. У діалоговому вікні Підключити Databricks Genie знайдіть поля Ідентифікатор клієнта OAuth і Секрет клієнта OAuth. Щоб налаштувати власний клієнт, достатньо ввести облікові дані в ці видимі поля; окремо вибирати цей спосіб не потрібно.

  6. Скопіюйте URL зворотного виклику з ChatGPT. Залиште це діалогове вікно відкритим.

ChatGPT Connect Databricks Genie dialog showing the callback URL field and OAuth client settings.

Приклад URL-адреси зворотного виклику:

https://chatgpt.com/connector/oauth/<callback_id>

Не видаляйте ідентифікатор зворотного виклику, не додавайте скісну риску в кінці й не замінюйте цю адресу загальною URL-адресою ChatGPT. URL-адреса, зареєстрована в Databricks, має точно збігатися зі значенням URL зворотного виклику, показаним у ChatGPT.

Створення підключення власного OAuth-застосунку в Databricks

  1. Відкрийте консоль свого облікового запису Databricks.

  2. На лівій бічній панелі відкрийте Налаштування.

  3. Відкрийте вкладку Підключення застосунків.

  4. Виберіть Додати підключення.

    Databricks Account Console Settings page showing the App connections tab and Add connection button.
  5. Введіть назву застосунку, наприклад ChatGPT Databricks.

  6. У поле URL-адреси переспрямування вставте точну URL-адресу зворотного виклику, скопійовану з ChatGPT.

  7. У розділі Області доступу виберіть області, потрібні застосунку.

  8. Для нового підключення Genie/інформаційних панелей, у якому в ChatGPT відображаються ai-gateway, dashboards і offline_access, дозвольте ці самі області доступу в OAuth-застосунку Databricks.

  9. Усі API залишається попереднім варіантом із ширшим доступом для загального використання API Databricks. Для цієї конфігурації використовуйте all-apis і offline_access у ChatGPT та переконайтеся, що OAuth-застосунок Databricks дозволяє обидві області. Для нового підключення Genie/інформаційних панелей віддавайте перевагу відображеним деталізованим областям доступу.

  10. Використовуйте SQL лише для застосунку, що працює виключно з API Databricks SQL. Доступу лише до SQL недостатньо для дій із Genie або інформаційними панелями.

  11. Переконайтеся, що в цьому OAuth-застосунку Databricks увімкнено всі області доступу, які згодом буде вказано в ChatGPT. Databricks автоматично дозволяє openid, email, profile і offline_access для застосунків, створених в інтерфейсі користувача.

  12. Залиште стандартні строки дії токенів (TTL) Databricks, якщо ваша організація не має окремої політики: 60 хвилин для токена доступу й 10080 хвилин для токена оновлення.

  13. Увімкніть Згенерувати секрет клієнта. Для цієї процедури ChatGPT потрібен конфіденційний OAuth-клієнт.

  14. Створіть підключення.

Databricks OAuth connection settings showing redacted client ID and redirect URL, access scopes, and the client-secret option.

Копіювання облікових даних із Databricks

  1. У діалоговому вікні Підключення створено скопіюйте Ідентифікатор клієнта.

  2. Відразу скопіюйте Секрет клієнта й збережіть його в безпечному місці.

  3. Якщо ви закрили діалогове вікно, не скопіювавши секрет, створіть або замініть облікові дані OAuth-застосунку й використовуйте новий секрет.

Databricks показує секрет лише один раз. Захищайте його як облікові дані й не додавайте до знімків екрана, звернень у підтримку, коментарів або чатів.

Завершіть налаштування власного клієнта OAuth у ChatGPT

  1. Поверніться до діалогового вікна Підключити Databricks Genie.

  2. Введіть ідентифікатор клієнта Databricks у поле Ідентифікатор клієнта OAuth.

  3. Введіть секрет клієнта Databricks у поле Секрет клієнта OAuth.

    Після введення цих облікових даних використовуватиметься ваш власний клієнт OAuth; окремо вибирати його не потрібно.

  4. У полі Області доступу (необов’язково) введіть області доступу, потрібні для кінцевої точки 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 дозволяє обидві. Не запитуйте в ChatGPT три деталізовані області доступу, якщо застосунок Databricks дозволяє лише all-apis.

  5. Вводьте кожну область доступу з нового рядка або розділяйте їх комами. Кожну область доступу, зазначену в ChatGPT, має бути ввімкнено в застосунку OAuth у Databricks.

  6. У полі Ім’я хоста робочого простору (обов’язково) введіть значення без https:// і шляху URL. Заповніть усі інші обов’язкові поля провайдера Databricks, що відображаються під час налаштування.

    На основі цього імені хоста ChatGPT визначає кінцеву точку MCP для Genie в межах робочого простору: https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Окрема регіональна кінцева точка MCP не потрібна.

  7. Виберіть Продовжити.

ChatGPT запитує саме ті області доступу, які введено в полі Області доступу (необов’язково). Ширші області доступу із шаблону автоматично не додаються.

ChatGPT Connect Databricks Genie dialog showing a mock workspace hostname, mock client ID, masked secret, and scopes.

Підключення й перевірка

Незалежно від вибраного способу OAuth виконайте наведені нижче перевірки підключення й доступу.

  1. Перегляньте відомості про застосунок, дії та налаштування автентифікації.

  2. Якщо ви адміністратор робочого простору, увімкніть застосунок для нього й визначте, хто може ним користуватися, відповідно до політики робочого простору.

  3. Почніть підключення з ChatGPT від імені тестового користувача з дозволеним доступом, а потім увійдіть у Databricks.

  4. Переконайтеся, що браузер відкриває потрібний обліковий запис або робочий простір Databricks.

  5. Перегляньте запитувані області доступу, а потім виберіть Авторизувати.

    Databricks permission request for a mock ChatGPT Databricks Connector showing requested access and the Authorize button.
  6. Переконайтеся, що браузер повертається до ChatGPT, а застосунок відображається як підключений.

  7. Виконайте дію читання з низьким ризиком, що відповідає можливостям підключення. Для підключення Genie надішліть запит Genie щодо даних, до яких тестовому користувачеві дозволено доступ. Для інших підтримуваних функцій отримайте відомості про поточного користувача або виконайте запит до дозволеного ресурсу Databricks SQL. Переконайтеся, що користувач має потрібні дозволи на ресурси Databricks; самі лише області доступу OAuth не надають доступу до даних.

  8. Якщо ввімкнено дії запису, перед ширшим розгортанням перевірте їх на робочому процесі Databricks із завідомо низьким ризиком.

  9. Для налаштування в робочому просторі попросіть учасника з дозволеним доступом, але без прав адміністратора, підключитися й повторити перевірку з низьким ризиком.

Керування доступом

Контроль доступу здійснюється як у Databricks, так і в ChatGPT.

У ChatGPT адміністратори робочого простору визначають, чи доступний застосунок і як учасники можуть ним користуватися. У Business адміністратори визначають, чи ввімкнений застосунок для всього робочого простору. Перегляньте адміністративні засоби керування застосунками Databricks (Налаштування робочого простору > Застосунки або Консоль адміністратора > Плагіни > Керування застарілими застосунками), щоб налаштувати:

  • Доступ користувачів — визначає, які ролі робочого простору можуть використовувати застосунок у робочих просторах Enterprise і Edu, де це підтримується.

  • Керування діями — визначає, які дії Databricks увімкнено.

  • Дозволи застосунку — визначає, коли ChatGPT запитує згоду учасників перед використанням застосунку.

Ці дозволи застосунку діють у розмовах ChatGPT. Агенти робочого простору використовують окремі налаштування, які задає автор кожного агента. Вони визначають, які дії застосунку доступні й коли кінцевим користувачам потрібно їх схвалювати. Докладніше про поведінку агентів див. у статті «Агенти робочого простору ChatGPT для Enterprise і Business».

У Databricks адміністратори визначають, які користувачі можуть авторизувати OAuth-застосунок і до яких ресурсів Databricks ці користувачі мають доступ. Дозволи постачальника залишаються чинними після ввімкнення застосунку в ChatGPT.

Відомості про навігацію в робочому просторі, доступ до застосунків і засоби керування ними в різних планах наведено в статті «Адміністративні засоби керування, безпека й відповідність вимогам у застосунках».

Усунення проблем із налаштуванням застосунку Databricks

  • Невідповідність URI переспрямування: якщо ви використовуєте власний OAuth-клієнт, переконайтеся, що значення URL-адреси переспрямування в Databricks точно збігається зі значенням URL зворотного виклику в ChatGPT, включно зі шляхом та ідентифікатором зворотного виклику. Не видаляйте ідентифікатор зворотного виклику, не додавайте скісну риску в кінці й не підставляйте іншу URL-адресу переспрямування ChatGPT.

  • Відсутній секрет: якщо ви використовуєте власний OAuth-клієнт, пам’ятайте, що секрети Databricks відображаються лише один раз. Згенеруйте новий секрет клієнта, якщо попередній не було скопійовано.

  • OAuth-застосунок доступний не відразу: за інформацією Databricks, обробка оновлень OAuth-застосунку може тривати до 30 хвилин.

  • Недостатні або невідповідні області доступу: якщо ви використовуєте власний 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-адрес джерела застосунку.

Чи була ця стаття корисною?