Use este guia se for administrador de um espaço de trabalho do ChatGPT ou utilizador do ChatGPT Plus ou Pro e estiver a configurar a aplicação Databricks Genie com o OAuth integrado ou o cliente OAuth da sua organização.
OAuth integrado: Use a ligação pré-configurada quando esta estiver disponível no ChatGPT e ativada para o seu espaço de trabalho do Databricks. Não precisa de criar uma aplicação OAuth nem de introduzir um ID de cliente ou um segredo do cliente. Siga as instruções da secção OAuth integrado abaixo.
Cliente OAuth personalizado: Use esta opção se o OAuth integrado não estiver disponível ou se a sua organização exigir um cliente OAuth próprio. Siga as instruções da secção Cliente OAuth personalizado abaixo.
O que vai configurar
Vai criar uma ligação à aplicação Databricks para a sua conta ou espaço de trabalho do ChatGPT. Ambas as opções exigem os dados do fornecedor Databricks pedidos no ChatGPT e permissões para os recursos que pretende usar. Se usar um cliente OAuth personalizado, prepare também:
Uma ligação de aplicação OAuth do Databricks criada na consola da sua conta Databricks.
O ID de cliente e o segredo do cliente OAuth do Databricks.
O URL de retorno exato copiado do ChatGPT.
Âmbitos do Databricks que correspondam às funcionalidades da aplicação que pretende ativar.
Quaisquer dados do fornecedor Databricks pedidos durante a configuração no ChatGPT, como o anfitrião do espaço de trabalho, o anfitrião da conta, o ID da conta ou o armazém de dados.
Antes de começar
Para configurar um espaço de trabalho, abra a consola de administração, selecione o espaço de trabalho do ChatGPT pretendido e abra Plugins. Selecione Gerir aplicações antigas para abrir a página Aplicações que foi mantida. Para saber como navegar no espaço de trabalho e aceder às aplicações antigas, consulte Controlos de administração, segurança e conformidade para plugins e aplicações.
Precisa de:
Acesso de administrador ou proprietário de um espaço de trabalho do ChatGPT, ou uma conta ChatGPT Plus ou Pro.
Para um cliente OAuth personalizado, acesso de administrador da conta Databricks. O acesso de administrador do espaço de trabalho pode ser suficiente para algumas tarefas, mas as ligações de aplicações personalizadas são configuradas na consola da conta Databricks. Para o OAuth integrado, um administrador do Databricks tem de verificar se a aplicação ChatGPT está disponível e ativada para o seu espaço de trabalho.
Para um cliente OAuth personalizado, a consola da conta Databricks aberta num separador à parte.
Para um cliente OAuth personalizado, o ecrã de ligação do Databricks Genie aberto no ChatGPT, para poder copiar o URL de retorno exato.
Uma decisão sobre as funcionalidades de que a aplicação precisa: Genie e painéis de AI/BI, acesso mais abrangente às APIs do Databricks ou uma aplicação limitada às APIs do Databricks SQL. O acesso apenas a SQL não é suficiente para ações do Genie ou de painéis.
Para um cliente OAuth personalizado, um local seguro para gerir o segredo do cliente Databricks.
Se a sua conta ou espaço de trabalho do Databricks restringir o acesso através de uma lista de acesso por IP, de um controlo de tráfego de entrada baseado no contexto, de uma firewall ou de outra política de rede, ajuda de um administrador do Databricks que possa permitir os atuais intervalos de IP de saída das aplicações do ChatGPT.
Para um cliente OAuth personalizado, copie o URL de retorno exato apresentado no ChatGPT.
Valores a preparar
Para um cliente OAuth personalizado, URL de retorno: copie-o do processo de configuração da aplicação no ChatGPT.
Para um cliente OAuth personalizado, o ID de cliente OAuth do Databricks.
Para um cliente OAuth personalizado, o segredo do cliente OAuth do Databricks.
Para um cliente OAuth personalizado, âmbitos de acesso do Databricks adequados às funcionalidades da aplicação. Numa nova ligação ao Genie ou a painéis que apresente
ai-gateway,dashboardseoffline_access, prepare esses âmbitos. TODAS as APIs (all-apiscomoffline_access) continua a ser a alternativa mais antiga e mais abrangente. Use SQL apenas numa aplicação limitada às APIs do Databricks SQL.Campos do espaço de trabalho ou da conta Databricks pedidos durante a configuração no ChatGPT.
OAuth integrado
Cumpra primeiro os pré-requisitos acima. Utilize esta opção apenas quando o OAuth integrado estiver disponível no ChatGPT e ativado para o seu espaço de trabalho do Databricks.
Peça a um administrador do Databricks que verifique se a aplicação ChatGPT está disponível nas definições de integrações de aplicações da consola da conta e ativada para o seu espaço de trabalho. Se a aplicação ChatGPT não aparecer na consola da sua conta Databricks, contacte o seu representante de conta Databricks para saber se a funcionalidade está disponível para a sua conta.
No ChatGPT, mude para a conta ou o espaço de trabalho onde a aplicação deve ficar disponível. Aceda a Definições > Plugins para uma configuração pessoal ou, como administrador ou proprietário do espaço de trabalho, a Consola de administração > Plugins para configurar um espaço de trabalho.
Selecione Databricks Genie e, em seguida, Adicionar ligação de aplicação.
Introduza o Nome do anfitrião do espaço de trabalho (obrigatório) sem
https://nem um caminho de URL.O ChatGPT determina o endpoint MCP do Genie local ao espaço de trabalho,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, a partir deste nome do anfitrião. Não é necessário um endpoint MCP regional separado.Selecione Continuar, inicie sessão no Databricks e reveja o pedido de consentimento.
Prossiga com as secções Ligar e testar e Gerir o acesso abaixo, incluindo os testes com membros autorizados e as verificações de acesso ao espaço de trabalho.
Cliente OAuth personalizado
Cumpra primeiro os pré-requisitos acima. Utilize esta opção se o OAuth integrado não estiver disponível ou se a sua organização exigir um cliente OAuth próprio. Após a configuração, conclua os passos das secções Ligar e testar e Gerir o acesso abaixo.
Iniciar a configuração de OAuth personalizado no ChatGPT
No ChatGPT, mude para a conta ou o espaço de trabalho onde a aplicação deve ficar disponível.
Aceda a Definições > Plugins para uma configuração pessoal ou, como administrador ou proprietário do espaço de trabalho, a Consola de administração > Plugins para configurar um espaço de trabalho.
Selecione Databricks Genie em Diretório.
Selecione Adicionar ligação de aplicação.
Na caixa de diálogo Ligar o Databricks Genie, localize os campos ID de cliente OAuth e Segredo de cliente OAuth. Para utilizar um cliente personalizado, basta introduzir as credenciais nestes campos visíveis; não é necessário um seletor separado.
Copie o URL de callback do ChatGPT. Mantenha esta caixa de diálogo aberta.
Exemplo de URL de callback:
https://chatgpt.com/connector/oauth/<callback_id>
Não remova o ID de callback, não acrescente uma barra no final nem substitua o URL por um URL genérico do ChatGPT. O URL registado no Databricks tem de corresponder exatamente ao URL de callback apresentado no ChatGPT.
Criar uma ligação de aplicação OAuth personalizada no Databricks
Abra a consola da conta Databricks correspondente à sua conta.
Na barra lateral esquerda, abra Definições.
Abra o separador Ligações de aplicações.
Selecione Adicionar ligação.
Introduza um nome para a aplicação, como ChatGPT Databricks.
Em URLs de redirecionamento, cole o URL de retorno exato copiado do ChatGPT.
Em Âmbitos de acesso, escolha os âmbitos de que a aplicação precisa.
Numa nova ligação ao Genie ou a painéis que apresente
ai-gateway,dashboardseoffline_accessno ChatGPT, permita esses mesmos âmbitos na aplicação OAuth do Databricks.TODAS as APIs continua a ser a alternativa mais antiga e mais abrangente para o acesso geral às APIs do Databricks. Para esta configuração, use
all-apiseoffline_accessno ChatGPT e certifique-se de que a aplicação OAuth do Databricks permite ambos. Numa nova ligação ao Genie ou a painéis, dê preferência aos âmbitos granulares apresentados.Use SQL apenas numa aplicação limitada às APIs do Databricks SQL. O acesso apenas a SQL não é suficiente para ações do Genie ou de painéis.
Certifique-se de que todos os âmbitos apresentados mais adiante no ChatGPT estão ativados nesta aplicação OAuth do Databricks. O Databricks permite automaticamente openid, email, profile e offline_access nas aplicações criadas na interface.
Mantenha os tempos de vida (TTL) dos tokens nos valores predefinidos do Databricks, salvo se a sua organização tiver uma política específica: 60 minutos para o token de acesso e 10080 minutos para o token de atualização.
Ative Gerar um segredo do cliente. O ChatGPT precisa de um cliente OAuth confidencial para este processo.
Crie a ligação.
Copiar credenciais do Databricks
Na caixa de diálogo Ligação criada, copie o ID de cliente.
Copie imediatamente o Segredo do cliente e guarde-o em segurança.
Se fechar a caixa de diálogo antes de copiar o segredo, crie ou renove as credenciais da aplicação OAuth e use o novo segredo.
O Databricks apresenta o segredo apenas uma vez. Trate-o como uma credencial e não o inclua em capturas de ecrã, pedidos de assistência, comentários ou conversas.
Concluir a configuração de OAuth personalizado no ChatGPT
Volte à caixa de diálogo Ligar o Databricks Genie.
Introduza o ID de cliente do Databricks em ID de cliente OAuth.
Introduza o segredo de cliente do Databricks em Segredo de cliente OAuth.
Ao introduzir estas credenciais, é utilizado o seu cliente OAuth personalizado; não é necessário um seletor separado.
Em Âmbitos (opcional), introduza os âmbitos necessários para o endpoint do Databricks e as funcionalidades da sua aplicação. Faça-os corresponder aos âmbitos ativados na aplicação OAuth do Databricks.
Para uma nova ligação ao Genie/painéis que apresente
ai-gateway,dashboardseoffline_access, mantenha esses âmbitos. Certifique-se de que a aplicação OAuth do Databricks permite os mesmos âmbitos. O âmbitoai-gatewaypermite a ligação MCP do Genie local ao espaço de trabalho,dashboardspermite ações em painéis de IA/BI eoffline_accesspermite tokens de atualização.A alternativa mais antiga e abrangente,
all-apiseoffline_access, continua a ser suportada para um acesso mais alargado às API, mas não é a opção preferencial para esta ligação ao Genie/painéis. Se a aplicação do Databricks permitir apenasall-apis, atualize-a ou volte a criá-la para permitirai-gateway,dashboardseoffline_access. Se os âmbitos granulares não estiverem disponíveis, configure explicitamente o ChatGPT para utilizarall-apiseoffline_accesse certifique-se de que a aplicação do Databricks permite ambos. Não solicite os três âmbitos granulares no ChatGPT se a aplicação do Databricks permitir apenasall-apis.Introduza um âmbito por linha ou separe os âmbitos por vírgulas. Todos os âmbitos indicados no ChatGPT têm de estar ativados na aplicação OAuth do Databricks.
Introduza o Nome do anfitrião do espaço de trabalho (obrigatório) sem https:// nem um caminho de URL. Preencha os restantes campos obrigatórios do fornecedor Databricks apresentados no processo de configuração.
O ChatGPT determina o endpoint MCP do Genie local ao espaço de trabalho,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, a partir deste nome do anfitrião. Não é necessário um endpoint MCP regional separado.Selecione Continuar.
O ChatGPT solicita exatamente os âmbitos introduzidos em Âmbitos (opcional). Não adiciona automaticamente âmbitos mais abrangentes do modelo de configuração.
Ligar e testar
Execute os seguintes testes de ligação e verificações de acesso, independentemente da opção OAuth escolhida.
Reveja os detalhes da aplicação, as ações e as definições de autenticação.
Se for administrador de um espaço de trabalho, ative a aplicação para esse espaço de trabalho e configure quem a pode usar, de acordo com a política do espaço de trabalho.
Inicie o processo de ligação no ChatGPT com um utilizador de teste autorizado e, em seguida, inicie sessão no Databricks.
Confirme que o navegador abre a conta ou o espaço de trabalho do Databricks esperado.
Reveja os âmbitos pedidos e selecione Autorizar.
Verifique se o navegador regressa ao ChatGPT e se a aplicação aparece como ligada.
Execute uma ação de leitura de baixo risco que corresponda às funcionalidades da ligação. Numa ligação ao Genie, envie um pedido ao Genie sobre dados a que o utilizador de teste tenha permissão para aceder. Para outras funcionalidades suportadas, obtenha informações sobre o utilizador atual ou consulte um recurso aprovado do Databricks SQL. Confirme que o utilizador tem as permissões necessárias para os recursos do Databricks; os âmbitos OAuth, por si só, não concedem acesso aos dados.
Se as ações de escrita estiverem ativadas, teste um fluxo de trabalho do Databricks claramente de baixo risco antes de alargar a utilização.
Numa configuração de espaço de trabalho, peça a um membro autorizado sem privilégios de administrador que estabeleça ligação e repita o teste de baixo risco.
Gerir o acesso
Tanto o Databricks como o ChatGPT contribuem para o controlo de acesso.
No ChatGPT, os administradores do espaço de trabalho gerem a disponibilidade da aplicação e a forma como os membros a podem usar. No Business, os administradores gerem a ativação da aplicação em todo o espaço de trabalho. Reveja os controlos de administração das aplicações Databricks (Definições do espaço de trabalho > Aplicações ou Consola de administração > Plugins > Gerir aplicações antigas) nas seguintes opções:
Acesso dos utilizadores, para configurar que funções do espaço de trabalho podem usar a aplicação nos espaços de trabalho Enterprise e Edu suportados.
Controlo de ações, para configurar que ações do Databricks estão ativadas.
Permissões da aplicação, para configurar quando o ChatGPT pede autorização aos membros antes de usar a aplicação.
Estas permissões da aplicação aplicam-se às conversas do ChatGPT. Os agentes do espaço de trabalho usam controlos específicos de cada agente, definidos pelo respetivo criador, para determinar que ações das aplicações estão disponíveis e quando é pedida a aprovação dos utilizadores finais. Para saber mais sobre o comportamento dos agentes, consulte: Agentes do espaço de trabalho do ChatGPT para Enterprise e Business.
No Databricks, os administradores gerem que utilizadores podem autorizar a aplicação OAuth e a que recursos do Databricks esses utilizadores podem aceder. As permissões do fornecedor continuam a aplicar-se depois de a aplicação ser ativada no ChatGPT.
Para saber mais sobre a navegação no espaço de trabalho, o acesso às aplicações e os controlos das aplicações específicos de cada plano, consulte: Controlos de administração, segurança e conformidade nas aplicações.
Resolução de problemas na configuração da aplicação Databricks
URI de redirecionamento não correspondente: Se usar um cliente OAuth personalizado, confirme que o valor de URLs de redirecionamento no Databricks corresponde exatamente ao URL de retorno apresentado no ChatGPT, incluindo o caminho e o ID de retorno. Não remova o ID de retorno, não adicione uma barra final nem substitua o URL por outro URL de redirecionamento do ChatGPT.
Segredo em falta: Se usar um cliente OAuth personalizado, os segredos do Databricks são apresentados apenas uma vez. Gere um novo segredo do cliente se não o tiver copiado.
Aplicação OAuth não disponível de imediato: Segundo o Databricks, o processamento das atualizações de aplicações OAuth pode demorar até 30 minutos.
Âmbito insuficiente ou não correspondente: Se usar um cliente OAuth personalizado, compare os Âmbitos (opcional) no ChatGPT com os Âmbitos de acesso na aplicação OAuth do Databricks. Todos os âmbitos pedidos pelo ChatGPT têm de estar ativados nessa aplicação. Confirme que os âmbitos permitem usar o endpoint e as funcionalidades de que precisa.
Numa nova ligação ao Genie ou a painéis que apresente
ai-gateway,dashboardseoffline_access, mantenha esses âmbitos no ChatGPT e certifique-se de que a aplicação Databricks permite os três. Se a aplicação permitir apenasall-apis, atualize-a ou volte a criá-la para permitir os três âmbitos granulares.Se os âmbitos granulares não estiverem disponíveis, use a alternativa mais abrangente suportada: configure o ChatGPT com
all-apiseoffline_accesse certifique-se de que a aplicação Databricks permite ambos. Uma aplicação que permita apenasall-apisnão corresponde a um pedido do ChatGPT paraai-gateway,dashboardseoffline_access. O acesso apenas a SQL só é adequado para uma aplicação limitada às APIs do Databricks SQL; não é suficiente para ações do Genie ou de painéis.Falha nas ações SQL: Numa aplicação limitada às APIs do Databricks SQL, confirme o âmbito SQL, a configuração do armazém de dados e as permissões do Databricks.
Espaço de trabalho do ChatGPT incorreto: Crie e ative a aplicação no mesmo espaço de trabalho do ChatGPT onde os utilizadores a vão ligar.
Conta ou espaço de trabalho do Databricks incorreto: Confirme o valor de Nome do anfitrião do espaço de trabalho (obrigatório), repita o processo de início de sessão e verifique se o Databricks abre a conta ou o espaço de trabalho esperado.
Os utilizadores não conseguem estabelecer ligação: Confirme que o utilizador tem acesso ao Databricks e permissão para autorizar a aplicação OAuth. No Business, confirme que a aplicação está ativada em todo o espaço de trabalho. Nos espaços de trabalho Enterprise e Edu suportados, confirme também que o Acesso dos utilizadores no ChatGPT permite usar a aplicação.
A política de rede do Databricks bloqueia a aplicação: Se o Databricks permitir apenas IPs de origem específicos, um administrador do Databricks tem de atualizar as listas de acesso por IP da conta ou do espaço de trabalho em causa, os controlos de tráfego de entrada baseados no contexto, a firewall ou outras regras de rede controladas pelo cliente.
Permita ligações de entrada a partir dos atuais intervalos de IP de saída das aplicações do ChatGPT.
Configure esta lista de permissões no Databricks ou na camada de rede controlada pelo cliente. Esta lista é independente da lista de IPs permitidos do espaço de trabalho do ChatGPT.
Os intervalos publicados podem mudar. Sempre que possível, automatize as atualizações a partir do JSON.
Não renove o segredo do cliente nem altere os âmbitos OAuth para contornar um bloqueio de rede. Primeiro, confirme se o Databricks está a rejeitar os IPs de origem da aplicação.