Utilitzeu aquesta guia si sou administrador d’un espai de treball de ChatGPT i esteu configurant la plantilla de l’aplicació Databricks per a la vostra organització. Una plantilla no és l’aplicació final que utilitzen els membres. És un flux de configuració que crea un esborrany d’aplicació específic de l’espai de treball després que proporcioneu la configuració de Databricks necessària.
Per a Databricks, la major part de la configuració es fa a la Databricks Account Console. Creeu una connexió d’aplicació OAuth personalitzada, registreu l’URL de callback de ChatGPT, copieu les credencials de client generades i, tot seguit, enganxeu aquests valors al flux de configuració de la plantilla de ChatGPT. Després que ChatGPT creï l’esborrany de l’aplicació, podeu publicar-la i gestionar-la com altres aplicacions de l’espai de treball.
Què esteu configurant
Esteu creant una aplicació Databricks específica de l’espai de treball a ChatGPT. L’aplicació utilitza:
Una connexió d’aplicació OAuth de Databricks creada a la vostra Databricks Account Console.
L’ID de client i el secret de client d’OAuth de Databricks.
L’URL de callback exacta copiada de ChatGPT.
Àmbits de Databricks que coincideixen amb les capacitats del connector que voleu activar.
Qualsevol detall del proveïdor de Databricks que sol·liciti el flux de configuració de ChatGPT, com ara l’amfitrió de l’espai de treball, l’amfitrió del compte, l’ID del compte o el magatzem.
Abans de començar
Necessiteu:
Accés d’administrador o propietari de l’espai de treball de ChatGPT.
Accés d’administrador del compte de Databricks. L’accés d’administrador de l’espai de treball pot ser suficient per a algunes tasques, però les connexions d’aplicacions personalitzades es configuren des de la Databricks Account Console.
La Databricks Account Console oberta en una pestanya separada.
La pantalla de configuració de la plantilla de l’aplicació Databricks oberta a ChatGPT perquè pugueu copiar l’URL de callback exacta.
Una decisió sobre si l’aplicació necessita accés general a l’API de Databricks o només accés a Databricks SQL.
Un lloc segur per gestionar el secret de client de Databricks.
No inventeu l’URL de callback. Copieu l’URL de callback exacta que es mostra a ChatGPT.
Valors que cal preparar
URL de callback: copieu-la del flux de configuració de la plantilla de ChatGPT.
ID de client d’OAuth de Databricks.
Secret de client d’OAuth de Databricks.
Àmbits d’accés de Databricks, com ara ALL APIs o SQL.
Camps de l’espai de treball o del compte de Databricks que sol·liciti el flux de configuració de ChatGPT.
Publicar i gestionar l’aplicació a ChatGPT
Crear l’esborrany de l’aplicació no la posa automàticament a disposició dels membres. Després de revisar l’esborrany:
Publiqueu l’esborrany de l’aplicació.
Confirmeu que l’aplicació apareix a Configuració de l’espai de treball > Aplicacions > Activades.
Configureu Accés d’usuari per als rols que l’han d’utilitzar.
Reviseu Control d’accions per a les accions de Databricks exposades per l’aplicació.
Reviseu Permisos de l’aplicació per triar quan ChatGPT demana als membres abans d’utilitzar l’aplicació.
Demaneu a un usuari de prova permès que obri Aplicacions a ChatGPT i confirmi que l’aplicació apareix.
Aquests permisos de l’aplicació s’apliquen a les converses de ChatGPT. Els agents de l’espai de treball utilitzen controls per agent definits pel creador de l’agent per determinar quines accions de l’aplicació estan disponibles i quan es demana als usuaris finals que les aprovin. Per al comportament de l’agent, consulteu: Agents de l’espai de treball de ChatGPT per a Enterprise i Business.
Iniciar la configuració de la plantilla a ChatGPT
A ChatGPT, canvieu a l’espai de treball on l’aplicació ha d’estar disponible.
Obriu Configuració de l’espai de treball > Aplicacions.
Seleccioneu Directori.
Cerqueu Databricks.
Seleccioneu la plantilla de l’aplicació Databricks i inicieu la configuració.
Introduïu un nom i una descripció clars per a l’aplicació, com ara Databricks o Databricks - Data Platform.
A la secció del client OAuth, copieu l’URL de callback de ChatGPT. Manteniu aquesta pestanya oberta.
Exemple d’URL de callback: https://chatgpt.com/connector/oauth/<callback_id>
No elimineu l’ID de callback, no afegiu una barra final ni la substituïu per una URL genèrica de ChatGPT.
Crear la connexió de l’aplicació OAuth a Databricks
Obriu la Databricks Account Console 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 ChatGPT Databricks Connector.
A URL de redirecció, enganxeu l’URL de callback exacta copiada de ChatGPT.
A Àmbits d’accés, trieu els àmbits que necessita l’aplicació.
Utilitzeu ALL APIs per a una aplicació Databricks general que necessita API de Databricks més enllà de SQL.
Utilitzeu només SQL per a una aplicació limitada a les API de Databricks SQL.
Deixeu els TTL dels tokens amb els valors predeterminats de Databricks tret que la vostra organització tingui una política específica.
Activeu Genera un secret de client. ChatGPT necessita un client OAuth confidencial per a aquest flux.
Creeu la connexió.
Copiar les credencials de Databricks
Al quadre de diàleg Connexió creada, copieu l’ID de client.
Copieu el secret de client immediatament i deseu-lo de manera segura.
Si tanqueu el quadre de diàleg abans de copiar el secret, creeu o roteu 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.
Finalitzar la configuració a ChatGPT
Torneu a la pestanya de configuració de la plantilla de ChatGPT.
Enganxeu l’ID de client de Databricks a ID de client d’OAuth.
Enganxeu el secret de client de Databricks a Secret de client d’OAuth.
Deixeu els Àmbits sense canvis tret que hàgiu de substituir intencionadament els valors predeterminats de la plantilla.
Empleneu qualsevol camp de proveïdor de Databricks que requereixi el flux de configuració, com ara l’amfitrió de l’espai de treball, l’amfitrió del compte, l’ID del compte, el magatzem o altres valors específics de Databricks.
Creeu l’esborrany de l’aplicació.
Provar l’aplicació com a usuari
Inicieu el flux de connexió des de ChatGPT com a usuari de prova permès.
Confirmeu que el navegador obre el compte o l’espai de treball de Databricks esperat.
Aproveu els àmbits sol·licitats.
Verifiqueu que el navegador torna a ChatGPT i que l’aplicació es mostra com a connectada.
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, proveu-les amb un flux de treball de Databricks clarament de baix risc abans d’un desplegament més ampli.
Gestionar l’accés
Tant Databricks com ChatGPT contribueixen al control d’accés.
A ChatGPT, els administradors de l’espai de treball gestionen si l’aplicació publicada està disponible, quins rols de l’espai de treball la poden utilitzar, quines accions estan activades i quan ChatGPT demana als usuaris abans d’utilitzar l’aplicació.
A Databricks, els administradors gestionen quins usuaris poden autoritzar l’aplicació OAuth i a quins recursos de Databricks poden accedir aquests usuaris. Els permisos del proveïdor continuen aplicant-se després que l’aplicació s’hagi activat a ChatGPT.
Resolució de problemes
La URI de redirecció no coincideix: confirmeu que l’URL de redirecció de Databricks coincideix exactament amb l’URL de callback que es mostra a ChatGPT, inclosos el camí i l’ID de callback.
Falta el secret: els secrets de Databricks es mostren una sola vegada. Genereu un secret de client nou si no s’ha 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: si ChatGPT es pot autenticar però les crides a l’API de Databricks fallen, confirmeu que l’aplicació Databricks té ALL APIs quan l’aplicació necessita API que no siguin SQL.
Les accions SQL fallen: confirmeu l’àmbit SQL, la configuració del magatzem i els permisos de Databricks.
Espai de treball incorrecte: creeu i publiqueu l’aplicació al mateix espai de treball de ChatGPT on els usuaris la connectaran.
Els usuaris no es poden connectar: confirmeu que l’usuari té accés a Databricks i pot autoritzar l’aplicació OAuth.