Користете го ова упатство ако сте администратор на работен простор во 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 или апликација ограничена на SQL API на Databricks. Пристапот само до 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 само за апликација ограничена на SQL API на Databricks.Полињата за работниот простор или сметката на 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“.
Во URL-адреси за пренасочување, залепете ја точната URL-адреса за повратен повик копирана од ChatGPT.
Во Опсези на пристап, изберете ги опсезите што ѝ се потребни на апликацијата.
За нова врска со Genie/контролни табли што ги прикажува
ai-gateway,dashboardsиoffline_accessво ChatGPT, дозволете ги истите опсези во 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
Во дијалогот Врската е создадена, копирајте го 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 за податоци до кои тест-корисникот има дозвола за пристап. За другите поддржани можности, преземете информации за тековниот корисник или извршете барање до одобрен 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, вклучувајќи ги патеката и ID на повратниот повик. Не отстранувајте го ID на повратниот повик, не додавајте коса црта на крајот и не заменувајте ја адресата со друга 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-адреси на конекторот.