Feu servir aquesta guia si administreu un espai de treball de ChatGPT o si sou usuari de ChatGPT Plus o ChatGPT Pro i esteu configurant el connector de Databricks Genie amb el client OAuth de Databricks de la vostra organització.
En el cas de Databricks, la major part de la configuració es fa a la consola del compte de Databricks. Creeu una connexió d'aplicació OAuth personalitzada, registreu l'URL de retorn de ChatGPT, copieu les credencials de client generades i introduïu aquests valors al procés de configuració del connector de ChatGPT.
Què configurareu
Creareu una connexió d'aplicació de Databricks per al vostre compte o espai de treball de ChatGPT. La connexió utilitza:
Una connexió d'aplicació OAuth de Databricks creada a la consola del compte de Databricks.
L'identificador i el secret de client OAuth de Databricks.
L'URL de retorn exacta copiada de ChatGPT.
Àmbits de Databricks que coincideixin amb les funcions del connector que vulgueu activar.
Totes les dades del proveïdor de Databricks que demani el procés de configuració de ChatGPT, com ara el servidor de l'espai de treball, el servidor del compte, l'identificador del compte o el magatzem.
Abans de començar
Necessiteu:
Accés com a administrador o propietari d'un espai de treball de ChatGPT, o bé un compte de ChatGPT Plus o ChatGPT Pro.
Accés com a administrador del compte de Databricks. L'accés com a administrador de l'espai de treball pot ser suficient per a algunes tasques, però les connexions d'aplicacions personalitzades es configuren des de la consola del compte de Databricks.
La consola del compte de Databricks oberta en una pestanya independent.
La pantalla de connexió de Databricks Genie oberta a ChatGPT per poder copiar l'URL de retorn exacta.
Haver decidit si l'aplicació necessita accés general a l'API de Databricks o només accés a Databricks SQL.
Un lloc segur on gestionar el secret de client de Databricks.
Si el vostre compte o espai de treball de Databricks restringeix l'accés mitjançant una llista d'accés IP, controls d'entrada basats en el context, un tallafoc o una altra política de xarxa, necessitareu l'ajuda d'un administrador de Databricks que pugui permetre els intervals actuals d'IP de sortida dels connectors de ChatGPT.
Nota: heu de copiar l'URL de retorn exacta que es mostra a ChatGPT.
Valors que cal preparar
URL de retorn: copieu-la del procés de configuració del connector de ChatGPT.
Identificador de client OAuth de Databricks.
Secret de client OAuth de Databricks.
Àmbits d'accés de Databricks, com ara TOTES LES API o SQL.
Camps de l'espai de treball o del compte de Databricks que demani el procés de configuració de ChatGPT.
Inicieu la configuració de l'aplicació a ChatGPT
A ChatGPT, canvieu al compte o espai de treball on vulgueu que estigui disponible l'aplicació.
Com a administrador o propietari de l'espai de treball, aneu a Configuració de l'espai de treball > Connectors.
Trieu Databricks Genie al Directori.
Seleccioneu Afegeix una connexió d'aplicació.
Al quadre de diàleg Connecta Databricks Genie, cerqueu la secció del client OAuth.
URL de retorn de ChatGPT. Manteniu obert aquest quadre de diàleg.
Exemple d'URL de retorn:
https://chatgpt.com/connector/oauth/<callback_id>
No elimineu l'identificador de retorn, no afegiu una barra final ni el substituïu per una URL genèrica de ChatGPT. L'URL registrada a Databricks ha de coincidir exactament amb l'URL de retorn que es mostra a ChatGPT.
Creeu la connexió de l'aplicació OAuth a Databricks
Obriu la consola del vostre compte de Databricks.
A la barra lateral esquerra, obriu Configuració.
Obriu la pestanya Connexions d'aplicacions.
Seleccioneu Afegeix una connexió.
Introduïu un nom d'aplicació, com ara Connector de Databricks per a ChatGPT.
A URL de redirecció, enganxeu l'URL de retorn exacta que heu copiat de ChatGPT.
A Àmbits d'accés, trieu els àmbits que necessita l'aplicació.
Utilitzeu TOTES LES API per a una aplicació general de Databricks que necessiti API de Databricks, a més d'SQL.
Utilitzeu només SQL per a una aplicació limitada a les API de Databricks SQL.
Assegureu-vos que tots els àmbits que s'indiquin més endavant a ChatGPT estiguin activats en aquesta aplicació OAuth de Databricks. Databricks permet automàticament openid, email, profile i offline_access per a les aplicacions creades des de la interfície.
Manteniu els valors TTL dels segments predeterminats de Databricks, tret que la vostra organització tingui una política específica: 60 minuts per al segment d'accés i 10.080 minuts per al segment d'actualització.
Activeu Genera un secret de client. ChatGPT necessita un client OAuth confidencial per a aquest procés.
Creeu la connexió.
Copieu les credencials de Databricks
Al quadre de diàleg Connexió creada, copieu l'Identificador de client.
Copieu immediatament el Secret de client i deseu-lo de manera segura.
Si tanqueu el quadre de diàleg abans de copiar el secret, creeu o renoveu les credencials de l'aplicació OAuth i utilitzeu el secret nou.
Databricks només mostra el secret una vegada. Tracteu-lo com una credencial i no l'inclogueu en captures de pantalla, tiquets, comentaris ni xats.
Completeu la configuració a ChatGPT
Torneu al quadre de diàleg Connecta Databricks Genie.
Introduïu l'identificador de client de Databricks a Identificador de client OAuth.
Introduïu el secret de client de Databricks a Secret de client OAuth.
A Àmbits (opcional), manteniu all-apis i offline_access per a l'accés general a l'API.
Introduïu un àmbit per línia o separeu-los amb comes. Tots els àmbits indicats a ChatGPT han d'estar activats a l'aplicació OAuth de Databricks.
Introduïu el Nom del servidor de l'espai de treball (obligatori) sense https:// ni cap camí d'URL. Empleneu tots els altres camps obligatoris del proveïdor de Databricks que es mostrin durant la configuració.
Seleccioneu Continua.
ChatGPT sol·licita exactament els àmbits introduïts a Àmbits (opcional). No hi afegeix automàticament àmbits més amplis de la plantilla.
Connecteu i proveu
Reviseu les dades, les accions i la configuració d'autenticació del connector.
Si administreu un espai de treball, activeu-hi el connector i configureu qui el pot utilitzar d'acord amb la política de l'espai de treball.
Com a usuari de prova autoritzat, inicieu el procés de connexió des de ChatGPT i, després, inicieu la sessió a Databricks.
Confirmeu que el navegador obre el compte o l'espai de treball de Databricks previst.
Reviseu els àmbits sol·licitats i seleccioneu Autoritza.
Comproveu que el navegador torna a ChatGPT i que el connector apareix com a connectat.
Executeu primer una acció de lectura de baix risc, com ara obtenir informació de l'usuari actual o consultar un recurs aprovat de Databricks SQL.
Si les accions d'escriptura estan activades, feu una prova amb un flux de treball de Databricks que tingui un risc clarament baix abans d'ampliar-ne el desplegament.
Si configureu un espai de treball, demaneu a un membre autoritzat que no sigui administrador que s'hi connecti i repeteixi la prova de baix risc.
Gestioneu l'accés
Tant Databricks com ChatGPT intervenen en el control d'accés.
A ChatGPT, els administradors de l'espai de treball gestionen la disponibilitat de l'aplicació i la manera com els membres la poden utilitzar. Reviseu els controls d'administració de les aplicacions de Databricks (Configuració de l'espai de treball > Aplicacions) per a:
Accés dels usuaris, per configurar quins rols de l'espai de treball poden utilitzar el connector.
Control d'accions, per configurar quines accions de Databricks estan activades.
Permisos de l'aplicació, per configurar quan ChatGPT demana permís als membres abans d'utilitzar el connector.
Aquests permisos de l'aplicació s'apliquen a les converses de ChatGPT. Els agents de l'espai de treball utilitzen els controls de cada agent definits pel seu creador per determinar quines accions de l'aplicació estan disponibles i quan es demana als usuaris finals que les aprovin. Per obtenir informació sobre el comportament dels agents, consulteu Agents de l'espai de treball de ChatGPT per a Enterprise i Business.
A Databricks, els administradors gestionen quins usuaris poden autoritzar l'aplicació OAuth i a quins recursos de Databricks poden accedir. Els permisos del proveïdor continuen vigents després d'activar l'aplicació a ChatGPT.
Resolució de problemes de configuració del connector de Databricks
L'URI de redirecció no coincideix: confirmeu que el valor d'URL de redirecció de Databricks coincideixi exactament amb l'URL de retorn que es mostra a ChatGPT, inclosos el camí i l'identificador de retorn. No elimineu l'identificador de retorn, no afegiu una barra final ni el substituïu per una altra URL de redirecció de ChatGPT.
Falta el secret: els secrets de Databricks només es mostren una vegada. Genereu un secret de client nou si no l'heu copiat.
L'aplicació OAuth no està disponible immediatament: Databricks indica que les actualitzacions d'aplicacions OAuth poden trigar fins a 30 minuts a processar-se.
Àmbit insuficient o incorrecte: compareu Àmbits (opcional) de ChatGPT amb Àmbits d'accés de l'aplicació OAuth de Databricks. Tots els àmbits que sol·liciti ChatGPT hi han d'estar activats. Per a les API que no siguin SQL, confirmeu que all-apis estigui activat a Databricks i que continuï a la llista d'àmbits de ChatGPT.
Les accions SQL fallen: confirmeu l'àmbit SQL, la configuració del magatzem i els permisos de Databricks.
Espai de treball de ChatGPT incorrecte: creeu i activeu el connector al mateix espai de treball de ChatGPT on el connectaran els usuaris.
Compte o espai de treball de Databricks incorrecte: confirmeu el valor de Nom del servidor de l'espai de treball (obligatori), repetiu el procés d'inici de sessió i comproveu que Databricks obri el compte o l'espai de treball previst.
Els usuaris no es poden connectar: confirmeu que l'usuari tingui accés a Databricks i pugui autoritzar l'aplicació OAuth. Confirmeu també que l'Accés dels usuaris de ChatGPT permeti que l'usuari utilitzi el connector.
La política de xarxa de Databricks bloqueja el connector: si Databricks només permet IP d'origen específiques, un administrador de Databricks ha d'actualitzar les llistes d'accés IP del compte o l'espai de treball corresponent, els controls d'entrada basats en el context, el tallafoc o altres regles de xarxa controlades pel client.
Permeteu connexions entrants des dels intervals actuals d'IP de sortida dels connectors de ChatGPT.
Configureu aquesta llista de permesos a Databricks o a la capa de xarxa controlada pel client. És independent de la llista d'IP permeses de l'espai de treball de ChatGPT.
Els intervals publicats poden canviar. Sempre que sigui possible, automatitzeu les actualitzacions a partir del JSON.
No renoveu el secret de client ni canvieu els àmbits OAuth per evitar un bloqueig de xarxa. Primer confirmeu si Databricks rebutja les IP d'origen del connector.