Използвайте това ръководство, ако сте администратор на работно пространство в ChatGPT или потребител на ChatGPT Plus или Pro и настройвате конектора Databricks Genie с OAuth клиента на Databricks на организацията си.
При Databricks по-голямата част от настройката се извършва в конзолата за акаунти на Databricks. Създавате персонализирана връзка с OAuth приложение, регистрирате URL адреса за обратно извикване на ChatGPT, копирате генерираните идентификационни данни на клиента и след това въвеждате тези стойности в процеса за настройване на конектора в ChatGPT.
Какво настройвате
Създавате връзка с приложение на Databricks за своя акаунт или работно пространство в ChatGPT. Връзката използва:
Връзка с OAuth приложение на Databricks, създадена в конзолата за акаунти на Databricks.
Идентификатора и клиентската тайна на OAuth клиента на Databricks.
Точния URL адрес за обратно извикване, копиран от ChatGPT.
Обхвати на Databricks, които съответстват на възможностите на конектора, които искате да активирате.
Всички данни за доставчика на Databricks, изисквани при настройването в ChatGPT, като хост на работното пространство, хост на акаунта, идентификатор на акаунта или хранилище.
Преди да започнете
Необходими са ви:
Достъп като администратор или собственик на работно пространство в ChatGPT или акаунт в ChatGPT Plus или Pro.
Администраторски достъп до акаунта в Databricks. За някои задачи може да е достатъчен достъп като администратор на работното пространство, но персонализираните връзки с приложения се конфигурират от конзолата за акаунти на Databricks.
Конзолата за акаунти на Databricks, отворена в отделен раздел.
Екранът за свързване с Databricks Genie, отворен в ChatGPT, за да можете да копирате точния URL адрес за обратно извикване.
Решение дали приложението се нуждае от общ достъп до API на Databricks, или само до Databricks SQL.
Сигурно място за съхраняване на клиентската тайна на Databricks.
Ако акаунтът или работното ви пространство в Databricks ограничава достъпа чрез списък с разрешени IP адреси, контекстно базиран контрол на входящия трафик, защитна стена или друга мрежова политика, ще ви е необходима помощ от администратор на Databricks, който може да разреши текущите диапазони от изходящи IP адреси на конекторите на ChatGPT.
Забележка: трябва да копирате точния URL адрес за обратно извикване, показан в ChatGPT.
Стойности, които да подготвите
URL адрес за обратно извикване: копирайте го от процеса за настройване на конектора в ChatGPT.
Идентификатор на OAuth клиента на Databricks.
Клиентска тайна на OAuth клиента на Databricks.
Обхвати за достъп до Databricks, като ALL APIs или SQL.
Полета за работното пространство или акаунта в Databricks, изисквани при настройването в ChatGPT.
Стартиране на настройката на приложението в ChatGPT
В ChatGPT превключете към акаунта или работното пространство, където приложението трябва да е достъпно.
Като администратор или собственик на работното пространство отворете Настройки на работното пространство > Приставки.
Изберете Databricks Genie в Директория.
Изберете Добавяне на връзка с приложение.
В диалоговия прозорец Свързване с Databricks Genie намерете раздела за OAuth клиента.
URL адрес за обратно извикване от ChatGPT. Оставете този диалогов прозорец отворен.
Примерен URL адрес за обратно извикване:
https://chatgpt.com/connector/oauth/<callback_id>
Не премахвайте идентификатора за обратно извикване, не добавяйте наклонена черта в края и не го заменяйте с общ URL адрес на ChatGPT. URL адресът, регистриран в Databricks, трябва напълно да съвпада с URL адреса за обратно извикване, показан в ChatGPT.
Създаване на връзката с OAuth приложението в Databricks
Отворете конзолата за акаунти на Databricks за своя акаунт в Databricks.
В лявата странична лента отворете Настройки.
Отворете раздела Връзки с приложения.
Изберете Добавяне на връзка.
Въведете име на приложението, например „Конектор ChatGPT Databricks“.
В URL адреси за пренасочване поставете точния URL адрес за обратно извикване, копиран от ChatGPT.
Под Обхвати за достъп изберете необходимите за приложението обхвати.
Използвайте ALL APIs за общо приложение на Databricks, което се нуждае от API на Databricks извън SQL.
Използвайте само SQL за приложение, ограничено до API на Databricks SQL.
Уверете се, че всеки обхват, който по-късно ще бъде посочен в ChatGPT, е активиран в това OAuth приложение на Databricks. Databricks автоматично разрешава openid, email, profile и offline_access за приложенията, създадени през потребителския интерфейс.
Оставете сроковете на валидност на токените със стойностите по подразбиране на Databricks, освен ако организацията ви няма конкретна политика: 60 минути за токена за достъп и 10 080 минути за токена за опресняване.
Включете Генериране на клиентска тайна. За този процес ChatGPT се нуждае от поверителен OAuth клиент.
Създайте връзката.
Копиране на идентификационните данни от Databricks
В диалоговия прозорец Връзката е създадена копирайте Идентификатор на клиента.
Незабавно копирайте Клиентската тайна и я съхранете на сигурно място.
Ако затворите диалоговия прозорец, преди да копирате тайната, създайте или сменете идентификационните данни на OAuth приложението и използвайте новата тайна.
Databricks показва тайната само веднъж. Третирайте я като идентификационни данни и не я включвайте в екранни снимки, заявки за поддръжка, коментари или чатове.
Завършване на настройката в ChatGPT
Върнете се в диалоговия прозорец Свързване с Databricks Genie.
Въведете идентификатора на клиента на Databricks в полето Идентификатор на OAuth клиента.
Въведете клиентската тайна на Databricks в полето Клиентска тайна на OAuth клиента.
В Обхвати (незадължително) запазете all-apis и offline_access за общ достъп до API.
Въведете по един обхват на ред или ги разделете със запетаи. Всеки обхват, посочен в ChatGPT, трябва да е активиран в OAuth приложението на Databricks.
Въведете Име на хоста на работното пространство (задължително) без https:// или път в URL адреса. Попълнете всички други задължителни полета за доставчика на Databricks, показани при настройването.
Изберете Продължаване.
ChatGPT заявява точно обхватите, въведени в Обхвати (незадължително). Не се добавят автоматично по-широките обхвати от шаблона.
Свързване и тестване
Прегледайте данните за конектора, действията и настройките за удостоверяване.
Ако сте администратор на работното пространство, активирайте конектора за него и определете кой може да го използва съгласно правилата на работното пространство.
Стартирайте свързването от ChatGPT като одобрен тестов потребител, след което влезте в Databricks.
Потвърдете, че браузърът отваря очаквания акаунт или работно пространство в Databricks.
Прегледайте заявените обхвати, след което изберете Упълномощаване.
Проверете дали браузърът се връща към ChatGPT и конекторът се показва като свързан.
Първо изпълнете нискорисково действие за четене, например извличане на данни за текущия потребител или заявка към одобрен ресурс на Databricks SQL.
Ако действията за запис са активирани, тествайте с очевидно нискорисков работен процес в Databricks, преди да разгърнете по-широко.
При настройка за работно пространство помолете одобрен негов член без администраторски права да се свърже и да повтори нискорисковия тест.
Управление на достъпа
Databricks и ChatGPT съвместно управляват достъпа.
В ChatGPT администраторите на работното пространство управляват дали приложението е достъпно и как членовете могат да го използват. Прегледайте администраторските контроли за приложенията на Databricks (Настройки на работното пространство > Приложения) за:
Потребителски достъп — за определяне кои роли в работното пространство могат да използват конектора.
Контрол на действията — за определяне кои действия на Databricks са активирани.
Разрешения за приложението — за определяне кога ChatGPT да иска потвърждение от членовете, преди да използва конектора.
Тези разрешения за приложението важат за разговорите в ChatGPT. Агентите в работното пространство използват индивидуални контроли, зададени от създателя на съответния Агент, за да определят кои действия на приложението са достъпни и кога от крайните потребители се иска одобрение. За поведението на Агентите вижте: Агенти в работното пространство на ChatGPT за Enterprise и Business.
В Databricks администраторите управляват кои потребители могат да упълномощават OAuth приложението и до кои ресурси на Databricks имат достъп тези потребители. Разрешенията на доставчика продължават да важат и след активирането на приложението в ChatGPT.
Отстраняване на проблеми при настройването на конектора Databricks
Несъответствие в URI за пренасочване: Уверете се, че стойността на URL адреси за пренасочване в Databricks напълно съвпада с URL адреса за обратно извикване, показан в ChatGPT, включително пътя и идентификатора за обратно извикване. Не премахвайте идентификатора за обратно извикване, не добавяйте наклонена черта в края и не използвайте друг URL адрес на ChatGPT за пренасочване.
Липсваща тайна: Тайните в Databricks се показват само веднъж. Ако не сте копирали клиентската тайна, генерирайте нова.
OAuth приложението не е достъпно веднага: Според Databricks обработването на актуализации на OAuth приложения може да отнеме до 30 минути.
Недостатъчен или несъответстващ обхват: Сравнете Обхвати (незадължително) в ChatGPT с Обхвати за достъп в OAuth приложението на Databricks. Всеки обхват, заявен от ChatGPT, трябва да е активиран там. За API, различни от SQL, проверете дали all-apis е активиран в Databricks и присъства в списъка с обхвати на ChatGPT.
Действията с SQL са неуспешни: Проверете обхвата SQL, конфигурацията на хранилището и разрешенията в Databricks.
Грешно работно пространство в ChatGPT: Създайте и активирайте конектора в същото работно пространство в ChatGPT, в което потребителите ще го свързват.
Грешен акаунт или работно пространство в Databricks: Проверете стойността на Име на хоста на работното пространство (задължително), след това повторете влизането и се уверете, че Databricks отваря очаквания акаунт или работно пространство.
Потребителите не могат да се свържат: Проверете дали потребителят има достъп до Databricks и има право да упълномощи OAuth приложението. Проверете също дали настройката Потребителски достъп в ChatGPT разрешава конектора за този потребител.
Мрежовата политика на Databricks блокира конектора: Ако Databricks разрешава само определени IP адреси на източника, администратор на Databricks трябва да актуализира съответните списъци с разрешени IP адреси за акаунта или работното пространство, контекстно базираните контроли на входящия трафик, защитната стена или други управлявани от клиента мрежови правила.
Разрешете входящи връзки от текущите диапазони от изходящи IP адреси на конекторите на ChatGPT.
Конфигурирайте това разрешаване в Databricks или в мрежовия слой, управляван от клиента. То е отделно от разрешаването на IP адреси за работното пространство в ChatGPT.
Публикуваните диапазони може да се променят. Когато е възможно, автоматизирайте актуализациите от JSON файла.
Не сменяйте клиентската тайна и не променяйте OAuth обхватите, за да заобиколите мрежово блокиране. Първо проверете дали Databricks отхвърля IP адресите на източника на конектора.