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.
• Para permitir que os usuários enviem arquivos por mensagens diretas, um administrador de espaço de trabalho deve ativar a prévia Genie One File Upload, e a conta Microsoft Teams de cada usuário deve ter o OneDrive for Business. Veja Fazer upload de arquivos.
• 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 iniciar uma nova conversa em uma mensagem direta, envie newchat. Isso limpa o contexto atual da conversa para que sua próxima mensagem inicie uma nova conversa com o Gênio. Suas mensagens existentes do Microsoft Teams não foram deletadas.

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.

Carregar arquivos

Em uma mensagem direta, você pode anexar até cinco arquivos PDF, Word ou CSV de 20 MiB ou menores a uma mensagem, e o Genie os usa como contexto ao responder. O upload de arquivos não está disponível em canais, grupos de chat ou no Microsoft 365 Copilot.

O Microsoft Teams armazena arquivos que você anexa em um chat no seu OneDrive for Business, então sua conta do Microsoft Teams deve ter o OneDrive for Business para enviar arquivos.

Para fazer upload de arquivos:

1. Em uma mensagem direta com o aplicativo Databricks Genie no Microsoft Teams, anexe até cinco arquivos à sua mensagem.
2. Opcionalmente, faça uma pergunta sobre os arquivos.
3. Envie a mensagem.

Se sua mensagem incluir uma pergunta, o Genie faz upload dos arquivos e depois responde à pergunta usando eles. Se você enviar arquivos sem fazer uma pergunta, o Genie faz upload deles e confirma quando estão prontos. Você pode então fazer perguntas sobre os arquivos.

Os arquivos carregados permanecem disponíveis para perguntas de acompanhamento na conversa atual. Depois de enviar newchat, anexe os arquivos novamente para usá-los na nova conversa.

Se você anexar mais de cinco arquivos, o Genie faz upload dos cinco primeiros e lista os arquivos que pulou. Se um arquivo não puder ser enviado, o Genie o lista com o motivo. Desde que pelo menos um arquivo seja enviado, o Genie ainda responde sua pergunta.

Se o Genie responder que o Azure Databricks não autorizou o upload, peça a um administrador do workspace para confirmar que a pré-visualização do Genie One File Upload está ativada para o seu workspace.

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.

Visualizations

Quando uma resposta do Gênio inclui uma visualização, o gráfico aparece como uma imagem na resposta.

Visualizações não são mostradas quando a visibilidade da mensagem está definida como privada, porque mensagens privadas são visíveis apenas para o usuário que pediu.

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.
• 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:

Monitorar 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.

Roteamento de dados

O Genie processa suas perguntas e armazena o histórico de conversas na região do seu espaço de trabalho. No entanto, o aplicativo Databricks Genie no Microsoft Teams é executado no plano de controle do Azure Databricks na região East US 2, independentemente da região do seu espaço de trabalho.

Seu prompt passa pelo aplicativo no East US 2, e a resposta retorna por ele. O aplicativo não armazena nem registra o conteúdo dos seus prompts ou das suas respostas lá. Ele armazena apenas informações de mapeamento, como a associação entre um espaço de trabalho do Microsoft Teams e um espaço de trabalho do Azure Databricks.

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.
• O upload de arquivos é suportado apenas em mensagens diretas. Em canais, chats em grupo e no Microsoft 365 Copilot, o Genie não responde a uma mensagem que inclua anexos. Em vez disso, ele responde que os uploads funcionam apenas por mensagem direta.
• O upload de arquivos suporta apenas arquivos PDF, Word (.docx) e CSV de 20 MiB ou menores, até cinco arquivos por mensagem.
• Acionar ações no Azure Databricks a partir do Teams não é suportado.

Recursos adicionais

• Usar o Genie One
• Chat no Genie One
• Destinos do app Genie no Slack e no Microsoft Teams
• Para obter suporte, consulte o centro de ajuda do Databricks.