Aplicativo Databricks Genie no Microsoft Teams
Visualização
Este recurso está em Prévia Pública. Os administradores de conta podem gerenciar o acesso a esse recurso na página Pré-visualizações do console da conta. Consulte Gerenciar prévias no nível da conta.
O aplicativo Databricks Genie no Microsoft Teams traz o Genie para o Microsoft Teams para que os usuários possam fazer perguntas sobre dados e obter respostas sem sair do workspace do Microsoft Teams. Os usuários podem conversar com o aplicativo em uma mensagem direta ou mencionar @Databricks Genie em um canal do Microsoft Teams ou chat em grupo. Os proprietários do canal podem pin um Genie Agent específico a um canal para respostas consistentes e específicas para o caso de uso. Caso contrário, as perguntas são roteadas pelo Genie.
O aplicativo Databricks Genie no Microsoft Teams depende da API Genie One e usa os mesmos provedores de modelo e garantias de confiança e segurança que o Genie. Consulte Provedor de hospedagem usado quando a configuração de recursos de AI assistenciais oferecidos por parceiros está ativada e desativada e Confiança e segurança dos recursos de Databricks AI assistenciais.
Esta página descreve como baixar, configurar e usar o aplicativo Databricks Genie no Microsoft Teams.
Agentes Databricks podem gerar respostas imprecisas. Verifique antes de agir sobre a saída do agente.
Pré-requisitos
Antes de instalar o aplicativo Databricks Genie no Microsoft Teams:
- Um administrador da conta deve habilitar a prévia do **Databricks Genie for Microsoft Teams** no console da conta.
- Se o seu workspace utiliza uma lista de acesso IP, adicione os IPs de saída do plano de controle Databricks na região Leste dos EUA 2. Consulte os IPs de saída na documentação do Azure do Databricks.
Instale o aplicativo Databricks Genie no Microsoft Teams
Um administrador do Microsoft 365 instala o aplicativo Databricks Genie no Microsoft Teams do marketplace da Microsoft:
- No marketplace da Microsoft, pesquise e encontre Databricks Genie .
- Instalar o aplicativo.
- Aprovar as permissões do aplicativo quando solicitado durante a instalação.
Para obter uma lista das permissões necessárias, consulte Permissões de aplicativo necessárias na Microsoft.
Após a instalação, os usuários podem começar a usar o aplicativo.
Use o aplicativo Genie do Databricks no Microsoft Teams
É possível usar o aplicativo Databricks Genie no Microsoft Teams por meio de mensagens diretas ou em conversas de canal em seu workspace do Microsoft Teams, ou a partir do Microsoft 365 Copilot.
Mensagem direta
Para enviar uma mensagem direta ao aplicativo Databricks Genie no Microsoft Teams:
- Em Microsoft Teams, clique em **Apps** na barra lateral esquerda e abra o aplicativo Databricks Genie no Microsoft Teams.
- Insira sua pergunta. Se você não estiver conectado, o aplicativo Databricks Genie no Microsoft Teams solicitará que você faça login.
- Sua pergunta é roteada para o Genie Agent mais apropriado e retorna uma resposta com fontes e prompts de acompanhamento sugeridos.
Para configurar o escopo do workspace e do Genie Agent para todas as conversas subsequentes de mensagens diretas, abra o aplicativo Databricks Genie na página inicial do Microsoft Teams e ajuste as configurações.
Conversa no canal
É possível adicionar o aplicativo Databricks Genie no Microsoft Teams a um canal. Usando config, os proprietários do canal podem configurar as configurações para todos os membros de um canal e os usuários individuais podem configurar as configurações pessoais. As configurações do proprietário do canal substituem as configurações pessoais.
Para configurar o aplicativo Databricks Genie no Microsoft Teams em um canal:
-
No canal desejado, digite
@Databricks Genie. -
Se solicitado, adicione o aplicativo Databricks Genie no Microsoft Teams ao canal.
-
Digite
config. -
Selecione o workspace conectado, a visibilidade da mensagem e o escopo do Genie Agent (um espaço específico ou Bate-papo no Genie).
Se nenhum Genie Agent estiver configurado, o canal usa como default o Chat no Genie.
-
Após a configuração, todas as menções
@Databricks Geniena rota do canal apontam para o agente e workspace configurados.
Níveis de configuração e substituições
execução config em um canal para abrir a janela de configuração. As seguintes configurações são configuráveis:
- Seleção de Workspace : O workspace do Databricks ao qual o aplicativo Databricks Genie no Microsoft Teams se conecta para responder a perguntas.
- Visibilidade da mensagem: Se
@Databricks Genieas respostas em canais são visíveis para todos os membros do canal ou apenas para o usuário que perguntou. Por padrão, as respostas são públicas. Se um administrador de workspace configurar a visibilidade da mensagem como privada, o workspace suporta apenas mensagens diretas, não canais ou chats em grupo. - **Escopo do Genie Agent**: Um Genie Agent específico ou todos os Genie Agents. Pin um único espaço para respostas consistentes e específicas para o caso de uso.
As configurações de visibilidade das mensagens podem ser definidas em três níveis. Níveis mais altos sobrepõem-se aos níveis mais baixos:
Nível | Como configurar | Aplica-se a | Precedência |
|---|---|---|---|
Workspace | O administrador do workspace do Databricks configura nas configurações de segurança do workspace usando os campos **Permitir conexão a plataformas de colaboração** e **Permitir mensagens públicas em plataformas de colaboração**. Se Permitir mensagens públicas em plataformas de colaboração estiver desativado, mensagens de canal e de grupo não funcionam, e somente mensagens diretas são compatíveis. | Todos os canais no workspace do Microsoft Teams | Prioridade Máxima — substitui as configurações de canal e pessoais. |
Canal | O proprietário do canal envia | Todos os membros desse canal | Substitui configurações pessoais |
Pessoal | O usuário individual envia | As próprias | Utilizado quando nenhuma configuração para todo o canal está definida. |
Permissões de aplicativo necessárias na Microsoft
Ao instalar o aplicativo Databricks Genie no Microsoft Teams, ele solicita as seguintes permissões. As permissões do Entra ID são permissões do Microsoft gráfico em todo o tenant, às quais um administrador do Microsoft 365 consente para sua organização. As permissões específicas de recurso são permissões de consentimento específico de recurso (RSC) do Teams que se aplicam apenas ao chat, canal ou equipe onde o aplicativo está instalado.
Para obter mais informações sobre essas permissões, consulte Consentimento específico de recurso e Permissões de gráfico na documentação da Microsoft.
A permissão User.ReadBasic.All não é mais utilizada. O aplicativo agora usa permissões delegadas em vez disso. Até que o Databricks termine de removê-la como uma permissão necessária, você ainda poderá vê-la sendo solicitada durante a instalação. Aprove a solicitação se for solicitado.
Permissão | Descrição | Tipo |
|---|---|---|
| Mantenha o acesso aos dados aos quais você concedeu acesso. | Entra ID |
| Inicie sessão e leia o perfil do usuário. | Entra ID |
| Ler os perfis básicos de todos os usuários. | Entra ID |
| Ler as mensagens neste bate-papo. | Específico do recurso |
| Enviar mensagens para este chat. | Específico do recurso |
| Crie novas notificações nos feeds de atividade de trabalho em equipe dos usuários neste chat. | Específico do recurso |
| Enviar notificações do feed de atividades para este usuário. | Específico do recurso |
| Ler os membros dos canais de uma equipe. | Específico do recurso |
| Ler as mensagens do canal desta equipe. | Específico do recurso |
| Ler os nomes, descrições e configurações do canal desta equipe. | Específico do recurso |
Solução de problemas
Mensagem de "Precisa de aprovação do administrador" no log in
A seguinte mensagem "É necessária a aprovação do administrador" é exibida ao fazer log in no seu workspace Databricks porque o tenant do Microsoft Entra está bloqueando o consentimento do usuário para o aplicativo Databricks. Se o consentimento do administrador não for concedido, o Microsoft Entra ID continuará a bloquear o fluxo de logon, mesmo que você tenha acesso direto ao workspace.
Para resolver isso, um usuário do Microsoft Entra com funções administrativas apropriadas deve conceder consentimento de administrador de tenant para o aplicativo empresarial Databricks.
Peça ao administrador do Microsoft Entra para visitar o seguinte link. Substitua {TENANT_ID} pelo seu ID do tenant do Microsoft Entra:
https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b
Caso o link falhe, o administrador pode conceder o consentimento manualmente:
- No centro de administração do Microsoft Entra, vá para Entra ID > Aplicativos empresariais > Todos os aplicativos e encontre o aplicativo empresarial Databricks usado para Single Sign On. Para identificar o aplicativo, procure o ID do aplicativo
aaec40b0-c0ae-4211-a98b-6fc160abb71b. - Conceder consentimento de administrador para as permissões solicitadas pelo aplicativo corporativo do Databricks:
- Em Segurança , clique em Permissões .
- Clique em **Conceder consentimento de administrador**.
Para instruções detalhadas, consulte a documentação da Microsoft.
Limitações
- Não é possível especificar qual compute (SQL warehouse) o aplicativo Databricks Genie no Microsoft Teams utiliza. Databricks seleciona automaticamente um SQL warehouse ao qual o usuário está autorizado a acessar.
- O PrivateLink não é compatível.
- Os seguintes recursos não são suportados:
- Visualizando gráficos
- Envio de notificações do Databricks para o Teams
- Acionando ações no Databricks a partir do Teams
Recursos adicionais
- Use o Genie One
- Bate-papo no Genie One
- Use o Genie One
- Para suporte, consulte a Central de ajuda do Databricks.