Use este guia se for administrador de um espaço de trabalho do ChatGPT e estiver a configurar o modelo de aplicação do Databricks para a sua organização. Um modelo não é a aplicação final que os membros utilizam. É um fluxo de configuração que cria uma aplicação de rascunho específica do espaço de trabalho depois de fornecer a configuração necessária do Databricks.
No Databricks, a maior parte da configuração é feita na Consola de Conta do Databricks. Cria uma ligação de aplicação OAuth personalizada, regista o URL de callback do ChatGPT, copia as credenciais de cliente geradas e, em seguida, cola esses valores no fluxo de configuração do modelo do ChatGPT. Depois de o ChatGPT criar a aplicação de rascunho, pode publicá-la e geri-la como outras aplicações do espaço de trabalho.
O que está a configurar
Está a criar uma aplicação Databricks específica do espaço de trabalho no ChatGPT. A aplicação utiliza:
Uma ligação de aplicação OAuth do Databricks criada na sua Consola de Conta do Databricks.
O ID de cliente OAuth e o segredo de cliente OAuth do Databricks.
O URL de callback exato copiado do ChatGPT.
Âmbitos do Databricks que correspondem às capacidades do conector que pretende ativar.
Quaisquer detalhes do fornecedor Databricks solicitados pelo fluxo de configuração do ChatGPT, como anfitrião do espaço de trabalho, anfitrião da conta, ID da conta ou warehouse.
Antes de começar
Precisa de:
Acesso de administrador ou proprietário do espaço de trabalho do ChatGPT.
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 a partir da Consola de Conta do Databricks.
A Consola de Conta do Databricks aberta num separador separado.
O ecrã de configuração do modelo de aplicação Databricks aberto no ChatGPT para poder copiar o URL de callback exato.
Uma decisão sobre se a aplicação precisa de acesso geral à API do Databricks ou apenas acesso ao Databricks SQL.
Um local seguro para gerir o segredo de cliente do Databricks.
Não invente o URL de callback. Copie o URL de callback exato apresentado no ChatGPT.
Valores a preparar
URL de callback: copie-o a partir do fluxo de configuração do modelo do ChatGPT.
ID de cliente OAuth do Databricks.
Segredo de cliente OAuth do Databricks.
Âmbitos de acesso do Databricks, como ALL APIs ou SQL.
Campos do espaço de trabalho ou da conta Databricks solicitados pelo fluxo de configuração do ChatGPT.
Publicar e gerir a aplicação no ChatGPT
Criar a aplicação de rascunho não a disponibiliza automaticamente aos membros. Depois de rever o rascunho:
Publique a aplicação de rascunho.
Confirme que a aplicação aparece em Definições do espaço de trabalho > Aplicações > Ativadas.
Configure o Acesso de utilizador para as funções que a devem utilizar.
Reveja o Controlo de ações para as ações do Databricks expostas pela aplicação.
Reveja as Permissões da aplicação para escolher quando o ChatGPT pede aos membros antes de utilizar a aplicação.
Peça a um utilizador de teste autorizado para abrir Aplicações no ChatGPT e confirmar que a aplicação aparece.
Estas permissões da aplicação aplicam-se às conversas do ChatGPT. Os Agentes do espaço de trabalho usam controlos por agente definidos pelo criador do agente para determinar que ações da aplicação estão disponíveis e quando é pedido aos utilizadores finais que as aprovem. Para saber mais sobre o comportamento dos agentes, consulte: Agentes do espaço de trabalho do ChatGPT para Enterprise e Business.
Iniciar a configuração do modelo no ChatGPT
No ChatGPT, mude para o espaço de trabalho onde a aplicação deve estar disponível.
Abra Definições do espaço de trabalho > Aplicações.
Selecione Diretório.
Procure Databricks.
Selecione o modelo de aplicação Databricks e inicie a configuração.
Introduza um nome e uma descrição claros para a aplicação, como Databricks ou Databricks - Data Platform.
Na secção do cliente OAuth, copie o URL de callback do ChatGPT. Mantenha este separador aberto.
Exemplo de URL de callback: https://chatgpt.com/connector/oauth/<callback_id>
Não remova o ID de callback, não adicione uma barra final nem o substitua por um URL genérico do ChatGPT.
Criar a ligação da aplicação OAuth no Databricks
Abra a Consola de Conta do Databricks para a sua conta Databricks.
Na barra lateral esquerda, abra Definições.
Abra o separador Ligações de aplicações.
Selecione Adicionar ligação.
Introduza um nome de aplicação, como ChatGPT Databricks Connector.
Em URLs de redirecionamento, cole o URL de callback exato copiado do ChatGPT.
Em Âmbitos de acesso, escolha os âmbitos de que a aplicação precisa.
Use ALL APIs para uma aplicação Databricks geral que precise de APIs do Databricks além de SQL.
Use apenas SQL para uma aplicação limitada às APIs SQL do Databricks.
Deixe os TTL de token nos valores predefinidos do Databricks, a menos que a sua organização tenha uma política específica.
Ative Gerar um segredo de cliente. O ChatGPT precisa de um cliente OAuth confidencial para este fluxo.
Crie a ligação.
Copiar credenciais do Databricks
Na caixa de diálogo Ligação criada, copie o ID de cliente.
Copie o segredo de cliente imediatamente e guarde-o em segurança.
Se fechar a caixa de diálogo antes de copiar o segredo, crie ou rode as credenciais da aplicação OAuth e use o novo segredo.
O Databricks mostra o segredo apenas uma vez. Trate-o como uma credencial e não o inclua em capturas de ecrã, tickets, comentários ou chats.
Concluir a configuração no ChatGPT
Regresse ao separador de configuração do modelo do ChatGPT.
Cole o ID de cliente do Databricks em ID de cliente OAuth.
Cole o segredo de cliente do Databricks em segredo de cliente OAuth.
Deixe os Âmbitos inalterados, a menos que precise intencionalmente de substituir as predefinições do modelo.
Preencha quaisquer campos de fornecedor Databricks exigidos pelo fluxo de configuração, como anfitrião do espaço de trabalho, anfitrião da conta, ID da conta, warehouse ou outros valores específicos do Databricks.
Crie a aplicação de rascunho.
Testar a aplicação como utilizador
Inicie o fluxo de ligação a partir do ChatGPT como utilizador de teste autorizado.
Confirme que o navegador abre a conta ou o espaço de trabalho Databricks esperado.
Aprove os âmbitos solicitados.
Verifique se o navegador regressa ao ChatGPT e se a aplicação aparece como ligada.
Execute primeiro uma ação de leitura de baixo risco, como obter informações do utilizador atual ou consultar um recurso Databricks SQL aprovado.
Se as ações de escrita estiverem ativadas, teste com um fluxo de trabalho Databricks claramente de baixo risco antes de uma implementação mais ampla.
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 se a aplicação publicada está disponível, que funções do espaço de trabalho a podem utilizar, que ações estão ativadas e quando o ChatGPT pergunta aos utilizadores antes de usar a aplicação.
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.
Resolução de problemas
Incompatibilidade do URI de redirecionamento: confirme que o URL de redirecionamento do Databricks corresponde exatamente ao URL de callback apresentado no ChatGPT, incluindo caminho e ID de callback.
Segredo em falta: os segredos do Databricks são apresentados uma única vez. Gere um novo segredo de cliente se não tiver sido copiado.
Aplicação OAuth não disponível de imediato: o Databricks indica que as atualizações de aplicações OAuth podem demorar até 30 minutos a ser processadas.
Âmbito insuficiente: se o ChatGPT conseguir autenticar-se, mas as chamadas à API do Databricks falharem, confirme que a aplicação Databricks tem ALL APIs quando a aplicação precisa de APIs que não sejam SQL.
As ações SQL falham: confirme o âmbito SQL, a configuração do warehouse e as permissões do Databricks.
Espaço de trabalho errado: crie e publique a aplicação no mesmo espaço de trabalho do ChatGPT onde os utilizadores a irão ligar.
Os utilizadores não conseguem ligar: confirme que o utilizador tem acesso ao Databricks e está autorizado a autorizar a aplicação OAuth.