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.
Os agentes AI Databricks podem gerar respostas imprecisas. Verifique antes de agir com base na 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.
O administrador pode conceder consentimento manualmente após a instalação, se necessário:
- Acesse o portal Microsoft Entra > Aplicativos empresariais .
- Pesquisar o aplicativo Databricks Genie no Microsoft Teams.
- Clique em Permissões > Conceder consentimento de administrador na permissão
User.ReadBasic.All.
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. |
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.