Използвайте това ръководство, ако сте администратор на работно пространство в ChatGPT и настройвате шаблона за приложението Databricks за вашата организация. Шаблонът не е крайното приложение, което членовете използват. Той е процес на настройка, който създава чернова на приложение за конкретното работно пространство, след като предоставите необходимата конфигурация на Databricks.
За Databricks по-голямата част от настройката се извършва в Databricks Account Console. Създавате персонализирана връзка за OAuth приложение, регистрирате URL адреса за обратно извикване на ChatGPT, копирате генерираните клиентски идентификационни данни и след това поставяте тези стойности в процеса на настройка на шаблона в ChatGPT. След като ChatGPT създаде черновата на приложението, можете да я публикувате и управлявате като другите приложения в работното пространство.
Какво настройвате
Създавате приложение Databricks в ChatGPT за конкретното работно пространство. Приложението използва:
Връзка за OAuth приложение Databricks, създадена във вашия Databricks Account Console.
OAuth клиентския идентификатор и клиентската тайна на Databricks.
Точния URL адрес за обратно извикване, копиран от ChatGPT.
Обхвати на Databricks, които съответстват на възможностите на конектора, които искате да активирате.
Всички данни за доставчика Databricks, поискани от процеса на настройка в ChatGPT, като хост на работното пространство, хост на акаунта, ID на акаунта или склад.
Преди да започнете
Необходими са ви:
Достъп като администратор или собственик на работно пространство в ChatGPT.
Администраторски достъп до акаунт в Databricks. Администраторският достъп до работното пространство може да е достатъчен за някои задачи, но персонализираните връзки на приложения се конфигурират от Databricks Account Console.
Databricks Account Console, отворен в отделен раздел.
Екранът за настройка на шаблона на приложението Databricks, отворен в ChatGPT, за да можете да копирате точния URL адрес за обратно извикване.
Решение дали приложението се нуждае от общ достъп до API на Databricks, или само от достъп до Databricks SQL.
Сигурно място за обработка на клиентската тайна на Databricks.
Не измисляйте URL адреса за обратно извикване. Копирайте точния URL адрес за обратно извикване, показан в ChatGPT.
Стойности за подготовка
URL адрес за обратно извикване: копирайте го от процеса на настройка на шаблона в ChatGPT.
OAuth клиентски идентификатор на Databricks.
OAuth клиентска тайна на Databricks.
Обхвати за достъп на Databricks, като ALL APIs или SQL.
Полета за работно пространство или акаунт в Databricks, поискани от процеса на настройка в ChatGPT.
Публикуване и управление на приложението в ChatGPT
Създаването на чернова на приложението не я прави автоматично достъпна за членовете. След преглед на черновата:
Публикувайте черновата на приложението.
Потвърдете, че приложението се показва в Настройки на работното пространство > Приложения > Активирани.
Конфигурирайте Потребителски достъп за ролите, които трябва да го използват.
Прегледайте Контрол на действията за действията на Databricks, предоставяни от приложението.
Прегледайте Разрешения на приложението, за да изберете кога ChatGPT да пита членовете, преди да използва приложението.
Помолете разрешен тестов потребител да отвори „Приложения“ в ChatGPT и да потвърди, че приложението се показва.
Тези разрешения за приложението важат за разговорите в ChatGPT. Агентите в работното пространство използват контроли за всеки Агент, зададени от създателя на Агента, за да определят кои действия на приложението са налични и кога крайните потребители трябва да ги одобрят. За поведението на Агентите вижте: Агенти на ChatGPT в работното пространство за Enterprise и Business.
Стартиране на настройката на шаблона в ChatGPT
В ChatGPT превключете към работното пространство, където приложението трябва да е достъпно.
Отворете Настройки на работното пространство > Приложения.
Изберете Директория.
Потърсете Databricks.
Изберете шаблона за приложението Databricks и започнете настройката.
Въведете ясно име и описание на приложението, например Databricks или Databricks - Data Platform.
В секцията OAuth client копирайте URL адреса за обратно извикване от ChatGPT. Оставете този раздел отворен.
Примерен URL адрес за обратно извикване: https://chatgpt.com/connector/oauth/<callback_id>
Не премахвайте ID за обратно извикване, не добавяйте наклонена черта в края и не го заменяйте с общ URL адрес на ChatGPT.
Създаване на връзката за OAuth приложение в Databricks
Отворете Databricks Account Console за вашия акаунт в Databricks.
В лявата странична лента отворете Настройки.
Отворете раздела Връзки на приложения.
Изберете Добавяне на връзка.
Въведете име на приложение, например ChatGPT Databricks Connector.
В Redirect URLs поставете точния URL адрес за обратно извикване, копиран от ChatGPT.
Под Обхвати за достъп изберете обхватите, от които приложението се нуждае.
Използвайте ALL APIs за общо приложение Databricks, което се нуждае от API на Databricks извън SQL.
Използвайте само SQL за приложение, ограничено до API на Databricks SQL.
Оставете TTL за токените със стойностите по подразбиране на Databricks, освен ако организацията ви няма конкретна политика.
Активирайте Generate a client secret. ChatGPT се нуждае от поверителен OAuth клиент за този процес.
Създайте връзката.
Копиране на идентификационни данни от Databricks
В диалоговия прозорец Connection created копирайте Client ID.
Копирайте Client secret незабавно и го съхранете сигурно.
Ако затворите диалоговия прозорец, преди да копирате тайната, създайте или завъртете идентификационните данни на OAuth приложението и използвайте новата тайна.
Databricks показва тайната само веднъж. Третирайте я като идентификационни данни и не я включвайте в екранни снимки, заявки, коментари или чатове.
Завършване на настройката в ChatGPT
Върнете се към раздела за настройка на шаблона в ChatGPT.
Поставете Client ID на Databricks в OAuth client ID.
Поставете Client secret на Databricks в OAuth client secret.
Оставете Scopes непроменени, освен ако умишлено не трябва да замените настройките по подразбиране на шаблона.
Попълнете всички полета за доставчика Databricks, изисквани от процеса на настройка, като хост на работното пространство, хост на акаунта, ID на акаунта, склад или други специфични за Databricks стойности.
Създайте черновата на приложението.
Тествайте приложението като потребител
Стартирайте процеса на свързване от ChatGPT като разрешен тестов потребител.
Потвърдете, че браузърът отваря очаквания акаунт или работно пространство в Databricks.
Одобрете поисканите обхвати.
Проверете дали браузърът се връща към ChatGPT и приложението се показва като свързано.
Първо изпълнете действие за четене с нисък риск, като извличане на информация за текущия потребител или заявка към одобрен ресурс Databricks SQL.
Ако са активирани действия за запис, тествайте с ясно нискорисков работен поток на Databricks преди по-широко внедряване.
Управление на достъпа
Databricks и ChatGPT заедно допринасят за контрола на достъпа.
В ChatGPT администраторите на работното пространство управляват дали публикуваното приложение е достъпно, кои роли в работното пространство могат да го използват, кои действия са активирани и кога ChatGPT пита потребителите, преди да използва приложението.
В Databricks администраторите управляват кои потребители могат да упълномощават OAuth приложението и до кои ресурси на Databricks имат достъп тези потребители. Разрешенията на доставчика продължават да се прилагат, след като приложението бъде активирано в ChatGPT.
Отстраняване на неизправности
Несъответствие на Redirect URI: потвърдете, че Redirect URL на Databricks съвпада точно с URL адреса за обратно извикване, показан в ChatGPT, включително пътя и ID за обратно извикване.
Липсваща тайна: тайните на Databricks се показват еднократно. Генерирайте нова клиентска тайна, ако не е била копирана.
OAuth приложението не е налично веднага: Databricks посочва, че обработката на актуализациите на OAuth приложения може да отнеме до 30 минути.
Недостатъчен обхват: ако ChatGPT може да се удостоверява, но API извикванията към Databricks са неуспешни, потвърдете, че приложението Databricks има ALL APIs, когато приложението се нуждае от API извън SQL.
SQL действията са неуспешни: потвърдете SQL обхвата, конфигурацията на склада и разрешенията в Databricks.
Грешно работно пространство: създайте и публикувайте приложението в същото работно пространство на ChatGPT, където потребителите ще го свързват.
Потребителите не могат да се свържат: потвърдете, че потребителят има достъп до Databricks и му е разрешено да упълномощава OAuth приложението.