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