Користете го ова упатство ако сте администратор на работен простор на ChatGPT или корисник на ChatGPT Plus или Pro и го поставувате конекторот Databricks Genie со OAuth-клиентот на Databricks на вашата организација.
Кај Databricks, најголемиот дел од поставувањето се врши во конзолата за сметки на Databricks. Создајте приспособена врска со OAuth-апликација, регистрирајте го повратниот URL на ChatGPT, копирајте ги создадените акредитиви на клиентот, а потоа внесете ги тие вредности во постапката за поставување на конекторот во ChatGPT.
Што поставувате
Создавате врска со апликација на Databricks за вашата сметка или работен простор на ChatGPT. Врската ги користи:
Врска со OAuth-апликација на Databricks, создадена во вашата конзола за сметки на Databricks.
ID на OAuth-клиентот на Databricks и тајната на клиентот.
Точниот повратен URL копиран од ChatGPT.
Опсези на Databricks што одговараат на можностите на конекторот што сакате да ги овозможите.
Сите податоци за давателот Databricks што ги бара постапката за поставување во ChatGPT, како што се домаќинот на работниот простор, домаќинот на сметката, ID на сметката или складиштето.
Пред да започнете
Потребни ви се:
Администраторски или сопственички пристап до работен простор на 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.
ID на 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>
Не отстранувајте го ID на повратниот повик, не додавајте коса црта на крајот и не заменувајте го со општ URL на ChatGPT. URL-адресата регистрирана во Databricks мора точно да се совпаѓа со Повратниот URL прикажан во ChatGPT.
Создајте ја врската со OAuth-апликацијата во Databricks
Отворете ја конзолата за сметки на Databricks за вашата сметка на Databricks.
Во левата странична лента, отворете Поставки.
Отворете го јазичето Врски со апликации.
Изберете Додај врска.
Внесете име на апликацијата, како што е ChatGPT Databricks Connector.
Во URL-адреси за пренасочување, залепете го точниот повратен URL копиран од ChatGPT.
Во Опсези за пристап, изберете ги опсезите што ѝ се потребни на апликацијата.
Користете ALL APIs за општа апликација на Databricks на која ѝ требаат API-ја на Databricks надвор од SQL.
Користете SQL само за апликација ограничена на API-јата на Databricks SQL.
Погрижете се секој опсег што подоцна ќе биде наведен во ChatGPT да е овозможен во оваа OAuth-апликација на Databricks. Databricks автоматски ги дозволува openid, email, profile и offline_access за апликациите создадени преку корисничкиот интерфејс.
Оставете го времето на важност на токените на стандардните вредности на Databricks, освен ако вашата организација нема посебно правило: 60 минути за токенот за пристап и 10080 минути за токенот за освежување.
Вклучете Создај тајна на клиентот. За оваа постапка, на ChatGPT му е потребен доверлив OAuth-клиент.
Создајте ја врската.
Копирајте ги акредитивите од Databricks
Во дијалогот Врската е создадена, копирајте го ID на клиентот.
Веднаш копирајте ја Тајната на клиентот и зачувајте ја безбедно.
Ако го затворите дијалогот пред да ја копирате тајната, создајте или ротирајте ги акредитивите на OAuth-апликацијата и употребете ја новата тајна.
Databricks ја прикажува тајната само еднаш. Постапувајте со неа како со акредитив и не вклучувајте ја во снимки од екранот, тикети, коментари или разговори.
Завршете го поставувањето во ChatGPT
Вратете се во дијалогот Поврзување со Databricks Genie.
Внесете го ID на клиентот на Databricks во ID на OAuth-клиентот.
Внесете ја тајната на клиентот на Databricks во Тајна на OAuth-клиентот.
Во Опсези (незадолжително), задржете ги all-apis и offline_access за општ пристап до API.
Внесете по еден опсег во секој ред или одделете ги опсезите со запирки. Секој опсег наведен во ChatGPT мора да биде овозможен во OAuth-апликацијата на Databricks.
Внесете го Името на домаќинот на работниот простор (задолжително) без https:// или патека на URL. Пополнете ги сите други задолжителни полиња за давателот Databricks прикажани во постапката за поставување.
Изберете Продолжи.
ChatGPT ги бара само опсезите внесени во Опсези (незадолжително). Не додава автоматски пошироки опсези од шаблонот.
Поврзување и тестирање
Прегледајте ги деталите, дејствата и поставките за автентикација на конекторот.
Ако сте администратор на работниот простор, овозможете го конекторот за него и конфигурирајте кој може да го користи согласно правилата на работниот простор.
Како дозволен тест-корисник, започнете ја постапката за поврзување од ChatGPT, а потоа најавете се на Databricks.
Потврдете дека прелистувачот ја отвора очекуваната сметка или работен простор на Databricks.
Прегледајте ги бараните опсези, па изберете Овласти.
Проверете дали прелистувачот се враќа во ChatGPT и дали конекторот е прикажан како поврзан.
Прво извршете дејство за читање со низок ризик, како преземање информации за тековниот корисник или пребарување одобрен SQL-ресурс на Databricks.
Ако се овозможени дејства за запишување, тестирајте со постапка на Databricks што е очигледно нискоризична пред поширокото воведување.
При поставување работен простор, побарајте од дозволен член што не е администратор да се поврзе и да го повтори нискоризичниот тест.
Управување со пристапот
И Databricks и ChatGPT учествуваат во контролата на пристапот.
Во ChatGPT, администраторите на работниот простор одредуваат дали апликацијата е достапна и како членовите можат да ја користат. Прегледајте ги администраторските контроли за апликациите на Databricks (Поставки на работниот простор > Апликации) за:
Кориснички пристап, за да одредите кои улоги во работниот простор може да го користат конекторот.
Контрола на дејствата, за да одредите кои дејства на Databricks се овозможени.
Дозволи за апликацијата, за да одредите кога ChatGPT ќе бара согласност од членовите пред да го употреби конекторот.
Овие дозволи за апликацијата важат за разговорите во ChatGPT. Агентите во работниот простор користат контроли за секој агент, поставени од неговиот создавач, за да одредат кои дејства на апликацијата се достапни и кога од крајните корисници се бара да ги одобрат. За однесувањето на агентите, видете: Агенти во работен простор на ChatGPT за Enterprise и Business.
Во Databricks, администраторите одредуваат кои корисници може да ја овластат OAuth-апликацијата и до кои ресурси на Databricks може да пристапат. Дозволите на давателот продолжуваат да важат и откако апликацијата ќе се овозможи во ChatGPT.
Решавање проблеми при поставувањето на конекторот Databricks
URI-адресите за пренасочување не се совпаѓаат: Потврдете дека вредноста URL-адреси за пренасочување во Databricks точно се совпаѓа со Повратниот URL прикажан во ChatGPT, вклучувајќи ги патеката и ID на повратниот повик. Не отстранувајте го ID на повратниот повик, не додавајте коса црта на крајот и не заменувајте го со друг 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-адреси на конекторот.