Aplicativo Databricks Genie no Microsoft Teams

O aplicativo Databricks Genie no Microsoft Teams traz o Genie para Microsoft Teams para que os usuários possam fazer perguntas de dados e obter respostas sem sair do workspace Microsoft Teams. Os usuários podem conversar com o aplicativo em uma mensagem direta ou mencionar @Databricks Genie em um Microsoft Teams canal ou chat em grupo. As perguntas são respondidas pelo Genie One ou por um Agente Genie específico que o proprietário do canal fixou para respostas consistentes e específicas para cada caso.

O aplicativo Databricks Genie no Microsoft Teams utiliza a API Genie One em ambos os casos; quando um agente Genie é fixado, o Genie One envia a pergunta apenas para esse agente. O aplicativo usa os mesmos provedores modelo e garantias de confiança e segurança do Genie. Consulte Provedor de host usado quando a configuração de recursos de IA com tecnologia de parceiros está ativada e desativada e Confiança e segurança dos recursos assistenciais de IA do Databricks.

Esta página descreve como baixar, configurar e usar o aplicativo Databricks Genie no Microsoft Teams.

Pré-requisitos

Antes de instalar o aplicativo Databricks Genie no Microsoft Teams:

• Um administrador da conta deve habilitar a versão prévia do Databricks Genie for Microsoft Teams no console da conta.
• Se o workspace usar uma lista de acesso de IPs, adicione os IPs de saída do plano de controle do Azure Databricks na região Leste dos EUA 2. Consulte os IPs de saída em a documentação Azure Databricks.

Instalar o aplicativo Databricks Genie no Microsoft Teams

Um administrador Microsoft 365 instala o aplicativo Databricks Genie em Microsoft Teams do marketplace Microsoft:

1. No Microsoft marketplace, pesquise e localize o Databricks Genie.
2. Instale o aplicativo.
3. Aprove as permissões do aplicativo quando solicitado durante a instalação.

Para uma lista de permissões necessárias, veja Permissão de aplicativos necessárias na Microsoft.

Após a instalação, os usuários podem começar a usar o aplicativo.

Usar o aplicativo Databricks Genie no Microsoft Teams

Você pode usar o aplicativo Databricks Genie no Microsoft Teams por mensagens diretas ou em conversas em canais no seu espaço de trabalho do Microsoft Teams, ou no Microsoft 365 Copilot.

Mensagem direta

Para enviar uma mensagem direta ao aplicativo Databricks Genie no Microsoft Teams:

1. Em Microsoft Teams, clique em Aplicativos na barra lateral esquerda e abra o aplicativo Databricks Genie em Microsoft Teams.

2. Insira sua pergunta.

3. Se você não estiver logado, o aplicativo Databricks Genie no Microsoft Teams solicita que você faça login:

   1. Clique em Configurar.
   2. Especifique a URL do seu Workspace. Para encontrar a URL do seu workspace, consulte Nomes de instâncias, URLs e IDs do workspace.
   3. Clique em Continuar para iniciar sessão na sua conta Azure Databricks.

4. Sua pergunta é roteada para o Agente Genie mais apropriado e retorna uma resposta com fontes e solicitações de acompanhamento sugeridas.

Para configurar o workspace e o escopo do Genie para todas as conversas de mensagens diretas subsequentes, abra o aplicativo Databricks Genie na página inicial do Microsoft Teams e ajuste as configurações.

Conversa de canal

Você pode adicionar o aplicativo Databricks Genie em Microsoft Teams a um canal. Usando config, os proprietários de canais podem definir configurações para todos os membros de um canal e usuários individuais podem definir configurações pessoais. As configurações do proprietário do canal substituem as configurações pessoais.

Para configurar o aplicativo Databricks Genie em Microsoft Teams em um canal:

1. No canal desejado, digite @Databricks Genie.

2. Se solicitado, adicione o aplicativo Databricks Genie em Microsoft Teams ao canal.

3. Digite config.

4. Selecione o espaço de trabalho conectado, a visibilidade da mensagem e o escopo do Genie (Genie One ou um agente Genie específico).

   Se nenhum Agente Genie estiver fixado, o canal utiliza o Genie One como padrão.

5. Após a configuração, todas as menções a @Databricks Genie no canal são encaminhadas para o agente e o workspace configurados.

Níveis de configuração e substituições

Execute config em um canal para abrir a janela de configuração. As seguintes configurações são configuráveis:

• Seleção do espaço de trabalho: o espaço de trabalho do Azure Databricks ao qual o aplicativo Databricks Genie no Microsoft Teams se conecta para responder a perguntas.
• Visibilidade da mensagem: se @Databricks Genie as respostas nos canais são visíveis para todos os membros do canal ou apenas para o usuário que pediu. Por padrão, as respostas são públicas. Se um administrador do workspace definir a visibilidade da mensagem como privada, o workspace oferecerá suporte apenas a mensagens diretas, não a canais ou chats em grupo.
• O escopo do Genie: Genie One ou um Agente do Genie específico. Ambos usam a API do Genie One; fixar um Genie Agent específico faz com que o Genie One envie a pergunta apenas para esse agente, para obter respostas consistentes e específicas para cada caso de uso.

As configurações de visibilidade da mensagem podem ser definidas em três níveis. Níveis mais altos substituem níveis mais baixos:

Monitore o uso com logs de auditoria

Administradores de contas e de espaços de trabalho podem usar a tabela de sistema de log de auditoria (system.access.audit) para monitorar o uso do Genie proveniente do Microsoft Teams. Quando um usuário envia uma mensagem pelo aplicativo Databricks Genie no Microsoft Teams, o Genie One registra um createGenieChatResponse evento no genieChat serviço, e o request_params.source campo registra teams como a origem. Isso permite diferenciar requisições do Microsoft Teams de requisições feitas na interface web do Azure Databricks (webapp) ou por meio de outras integrações, como o Slack (slack).

A consulta de exemplo a seguir retorna as solicitações do Genie originadas pelo Microsoft Teams dos últimos 5 dias, incluindo o usuário que perguntou e o ID da conversa:

SELECT
  event_time,
  user_identity.email AS user_email,
  request_params.conversation_id AS conversation_id
FROM system.access.audit
WHERE service_name = 'genieChat'
  AND action_name = 'createGenieChatResponse'
  AND request_params.source = 'teams'
  AND event_date >= date_add(current_date(), -5)
ORDER BY event_time DESC

Para o esquema da tabela de log de auditoria e mais consultas de exemplo, consulte Referência da tabela do sistema de log de auditoria. Para a lista completa de eventos de chat do Genie One, veja Eventos de chat no Genie One.

Permissão de aplicativos necessária na Microsoft

Quando você instala 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 Graph válidas para todo o locatário, concedidas por um administrador do Microsoft 365 à sua organização. 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 mais informações sobre essas permissões, veja Consentimento específico do recurso e permissões do Graph na documentação da Microsoft.

Solução de problemas

Mensagem "Precisa de aprovação do administrador" no logon

A seguinte mensagem "Precisa de aprovação do administrador" é exibida quando você faz logon no workspace Azure Databricks porque o locatário do Microsoft Entra está bloqueando o consentimento do usuário para o aplicativo Azure Databricks. Se o consentimento do administrador não for concedido, Microsoft Entra ID continuará bloqueando o fluxo de logon mesmo se você tiver acesso direto ao workspace.

Para resolver isso, um usuário Microsoft Entra com funções de administrador apropriadas deve conceder consentimento de administrador em todo o locatário para o aplicativo empresarial Azure Databricks.

Peça ao administrador do Microsoft Entra para visitar o link a seguir. Substitua {TENANT_ID} pela sua ID de locatário do Microsoft Entra:

https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Se o link falhar, o administrador poderá conceder consentimento manualmente:

1. No centro de administração do Microsoft Entra, acesse Entra ID>Enterprise apps>All applications e localize o aplicativo empresarial Azure Databricks usado para logon único. Para identificar o aplicativo, pesquise a ID aaec40b0-c0ae-4211-a98b-6fc160abb71bdo aplicativo.
2. Conceda consentimento do administrador para as permissões solicitadas pelo Azure Databricks aplicativo empresarial:
   1. Em Segurança, clique em Permissões.
   2. Clique em Conceder consentimento do administrador.

Para obter instruções detalhadas, consulte a documentação Microsoft.

Limitações

• Não é possível especificar qual computação (SQL warehouse) o aplicativo Databricks Genie em Microsoft Teams usa. Azure Databricks seleciona automaticamente um SQL Warehouse que o usuário está autorizado a acessar.
• Quando um agente do Genie específico é fixado como o escopo do Genie, o Genie One pode reescrever a pergunta antes que ela chegue ao agente fixado.
• O feedback (com o polegar para cima ou para baixo) é sempre enviado ao Genie One, mesmo quando um agente do Genie específico está fixado.
• Não há suporte para PrivateLink.
• Não há suporte para os seguintes recursos:
  • Visualizando gráficos
  • Enviando notificações do Azure Databricks para o Microsoft Teams
  • Acionando ações no Azure Databricks a partir do Teams

Recursos adicionais

• Usar o Genie One
• Chat no Genie One
• Usar o Genie One
• Para obter suporte, consulte o centro de ajuda do Databricks.