Използвайте това ръководство, ако сте администратор на работно пространство в 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 клиент — екранът за свързване с Databricks Genie, отворен в ChatGPT, за да можете да копирате точния URL адрес за обратно извикване.
Решение какви функции са необходими на приложението: Genie и AI/BI табла, по-широк достъп до API на Databricks или приложение, ограничено до SQL API на Databricks. Достъпът само до 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 само за приложение, ограничено до SQL API на Databricks.Данните за работното пространство или акаунта в Databricks, изисквани при настройката в ChatGPT.
Вграден OAuth
Първо изпълнете предварителните изисквания по-горе. Използвайте този вариант само когато вграденият OAuth е наличен в ChatGPT и е активиран за вашето работно пространство в Databricks.
Помолете администратор на Databricks да провери дали приложението ChatGPT е налично в настройките за интеграции на приложения в конзолата за акаунта и дали е активирано за вашето работно пространство. Ако приложението ChatGPT не е посочено в конзолата за вашия акаунт в Databricks, свържете се с представителя на Databricks, който отговаря за акаунта ви, за да попитате дали функцията е налична за него.
В ChatGPT превключете към акаунта или работното пространство, в което приложението трябва да е налично. За лична настройка отидете в Настройки > Приставки, а за настройка на работно пространство — в Администраторска конзола > Приставки като администратор или собственик на работното пространство.
Изберете Databricks Genie, след което изберете Добавяне на връзка с приложение.
Въведете Име на хоста на работното пространство (задължително) без
https://или URL път.От това име на хост ChatGPT извежда MCP крайната точка за Genie в рамките на работното пространство:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Не е необходима отделна регионална MCP крайна точка.Изберете Продължаване, след което влезте в Databricks и прегледайте заявката за съгласие.
Продължете с разделите „Свързване и тестване“ и „Управление на достъпа“ по-долу, включително тестовете с членове с разрешен достъп и проверките на достъпа до работното пространство.
Собствен OAuth клиент
Първо изпълнете предварителните изисквания по-горе. Използвайте този вариант, ако вграденият OAuth не е наличен или вашата организация изисква собствен OAuth клиент. След настройването изпълнете стъпките в разделите „Свързване и тестване“ и „Управление на достъпа“ по-долу.
Започнете настройката на собствен OAuth клиент в ChatGPT
В ChatGPT превключете към акаунта или работното пространство, в което приложението трябва да е налично.
За лична настройка отидете в Настройки > Приставки, а за настройка на работно пространство — в Администраторска конзола > Приставки като администратор или собственик на работното пространство.
Изберете Databricks Genie в Каталог.
Изберете Добавяне на връзка с приложение.
В диалоговия прозорец Свързване с Databricks Genie намерете полетата Идентификатор на OAuth клиента и Таен ключ на OAuth клиента. За да използвате собствен клиент, въведете идентификационните данни в тези видими полета; не е необходимо да го избирате отделно.
Копирайте URL адреса за обратно извикване от ChatGPT. Оставете този диалогов прозорец отворен.
Примерен URL адрес за обратно извикване:
https://chatgpt.com/connector/oauth/<callback_id>
Не премахвайте идентификатора за обратно извикване, не добавяйте наклонена черта в края и не заменяйте адреса с общ URL адрес на ChatGPT. URL адресът, регистриран в Databricks, трябва да съвпада точно с URL адреса за обратно извикване, показан в ChatGPT.
Създайте връзка със собствено OAuth приложение в Databricks
Отворете конзолата за вашия акаунт в Databricks.
В лявата странична лента отворете Настройки.
Отворете раздела Връзки с приложения.
Изберете Добавяне на връзка.
Въведете име на приложението, например „Конектор на ChatGPT за Databricks“.
В URL адреси за пренасочване поставете точния URL адрес за обратно извикване, копиран от ChatGPT.
Под Обхвати на достъп изберете обхватите, необходими на приложението.
За нова връзка с Genie/табла, при която в ChatGPT се показват
ai-gateway,dashboardsиoffline_access, разрешете същите обхвати за OAuth приложението в Databricks.Всички API остава по-старият вариант с по-широк достъп за общ достъп до API на Databricks. За тази конфигурация използвайте
all-apisиoffline_accessв ChatGPT и се уверете, че OAuth приложението в Databricks разрешава и двата. За нова връзка с Genie/табла предпочитайте показаните обхвати с по-прецизен контрол.Използвайте SQL само за приложение, ограничено до SQL API на Databricks. Достъпът само до SQL не е достатъчен за действия с Genie или табла.
Уверете се, че всеки обхват, който по-късно посочите в ChatGPT, е разрешен за това OAuth приложение в Databricks. Databricks автоматично разрешава openid, email, profile и offline_access за приложения, създадени през потребителския интерфейс.
Оставете сроковете на валидност (TTL) на токените със стойностите по подразбиране в Databricks, освен ако организацията ви няма конкретна политика: 60 минути за токена за достъп и 10080 минути за токена за опресняване.
Включете Генериране на таен ключ на клиента. За тази процедура ChatGPT изисква поверителен OAuth клиент.
Създайте връзката.
Копирайте идентификационните данни от Databricks
В диалоговия прозорец Връзката е създадена копирайте Идентификатор на клиента.
Копирайте Тайния ключ на клиента веднага и го съхранявайте сигурно.
Ако затворите диалоговия прозорец, преди да копирате тайния ключ, създайте или подменете идентификационните данни на OAuth приложението и използвайте новия таен ключ.
Databricks показва тайния ключ само веднъж. Третирайте го като идентификационни данни и не го включвайте в екранни снимки, заявки за поддръжка, коментари или чатове.
Завършете настройката на собствен OAuth клиент в ChatGPT
Върнете се в диалоговия прозорец Свързване с Databricks Genie.
Въведете идентификатора на клиента от Databricks в Идентификатор на OAuth клиента.
Въведете тайния ключ на клиента от Databricks в Таен ключ на OAuth клиента.
С въвеждането на тези идентификационни данни се използва вашият собствен OAuth клиент; не е необходимо да го избирате отделно.
В Обхвати (незадължително) въведете обхватите, необходими за крайната точка на Databricks и функциите, които приложението ви използва. Те трябва да съответстват на обхватите, разрешени за OAuth приложението в Databricks.
За нова връзка с Genie/табла, при която се показват
ai-gateway,dashboardsиoffline_access, запазете тези обхвати. Уверете се, че OAuth приложението в Databricks разрешава същите обхвати.ai-gatewayпозволява MCP връзката с Genie в рамките на работното пространство,dashboardsпозволява действия с AI/BI табла, аoffline_accessпозволява използването на токени за опресняване.По-старият вариант с по-широк достъп —
all-apisиoffline_access— все още се поддържа за по-широк достъп до API, но не е предпочитан за тази връзка с Genie/табла. Ако приложението в Databricks разрешава самоall-apis, актуализирайте го или го създайте отново, така че да разрешаваai-gateway,dashboardsиoffline_access. Ако обхватите с по-прецизен контрол не са налични, изрично задайтеall-apisиoffline_accessв ChatGPT и се уверете, че приложението в Databricks разрешава и двата. Не заявявайте трите обхвата с по-прецизен контрол в ChatGPT, ако приложението в Databricks разрешава самоall-apis.Въведете всеки обхват на отделен ред или разделете обхватите със запетаи. Всеки обхват, посочен в ChatGPT, трябва да е разрешен за OAuth приложението в Databricks.
Въведете Име на хоста на работното пространство (задължително) без https:// или URL път. Попълнете всички други задължителни полета за доставчика Databricks, показани при настройката.
От това име на хост ChatGPT извежда MCP крайната точка за Genie в рамките на работното пространство:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Не е необходима отделна регионална MCP крайна точка.Изберете Продължаване.
ChatGPT заявява точно обхватите, въведени в Обхвати (незадължително). Не добавя автоматично по-широки обхвати от шаблона.
Свързване и тестване
Изпълнете следните тестове на връзката и проверки на достъпа, независимо кой вариант на OAuth използвате.
Прегледайте подробностите за конектора, действията и настройките за удостоверяване.
Ако сте администратор на работно пространство, активирайте конектора за него и определете кой може да го използва според политиката на работното пространство.
Стартирайте процедурата за свързване от ChatGPT като тестов потребител с разрешен достъп, след което влезте в Databricks.
Проверете дали браузърът отваря очаквания акаунт или работно пространство в Databricks.
Прегледайте заявените обхвати, след което изберете Упълномощаване.
Проверете дали браузърът се връща в ChatGPT и конекторът се показва като свързан.
Изпълнете нискорисково действие за четене, което съответства на функциите на връзката. За връзка с Genie изпратете заявка към Genie за данни, до които тестовият потребител има разрешен достъп. За други поддържани функции извлечете информация за текущия потребител или изпълнете заявка към одобрен SQL ресурс в Databricks. Проверете дали потребителят има необходимите разрешения за ресурсите в Databricks; OAuth обхватите сами по себе си не предоставят достъп до данни.
Ако са разрешени действия за запис, тествайте с работен процес в Databricks с ясно изразен нисък риск, преди да разширите внедряването.
При настройка на работно пространство помолете член с разрешен достъп, който не е администратор, да се свърже и да повтори нискорисковия тест.
Управление на достъпа
Контролът на достъпа зависи както от 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, актуализирайте го или го създайте отново, така че да разрешава трите обхвата с по-прецизен контрол.Ако обхватите с по-прецизен контрол не са налични, използвайте поддържания вариант с по-широк достъп: задайте
all-apisиoffline_accessв ChatGPT и се уверете, че приложението в Databricks разрешава и двата. Приложение, което разрешава самоall-apis, не отговаря на заявка от ChatGPT заai-gateway,dashboardsиoffline_access. Достъпът само до SQL е подходящ единствено за приложение, ограничено до SQL API на Databricks; той не е достатъчен за действия с Genie или табла.Неуспешни SQL действия: За приложение, ограничено до SQL API на Databricks, проверете обхвата 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 адресите на източника на конектора.