Configurar Genie Search

O Genie Search cria e mantém um índice de pesquisa em todas as fontes onde sua organização mantém seu conhecimento: Google Drive, Jira, Confluence e Workday. O Databricks ingere e indexa o conteúdo junto com as permissões de cada documento e mantém ambos atualizados à medida que mudam.

Com o Genie Search, o Genie pesquisa um índice que cobre todas as suas fontes conectadas, em vez de consultar cada fonte separadamente. O Genie Search também estende a Genie Ontology além do Databricks, para que o Genie possa usar seus documentos e tickets como contexto ao responder a perguntas. Os usuários veem apenas o conteúdo que eles já podem abrir na origem.

O Workday também fornece diretórios de organização no Genie One. Consulte Conectar uma fonte de pessoas para o Genie One.

Requisitos

• Privilégios de administrador de account do Databricks
• Um administrador para cada fonte que você conecta, como um administrador do Google Workspace ou da Atlassian, para autorizar o acesso. Esta pode ser uma pessoa diferente do administrador da account do Databricks.

Fontes compatíveis

O Genie Search indexa as seguintes fontes.

Origem	O que está indexado	Como você autentica
Google Drive	Arquivos do Google Workspace, arquivos do Microsoft Office, PDFs e arquivos de texto. Consulte os tipos de arquivo suportados em Limitações.	account de serviço do Google Cloud com delegação em todo o domínio
Jira cloud	Todos os projetos que o usuário autorizador pode acessar	Seu próprio aplicativo Atlassian OAuth 2.0
Confluence Cloud	Todos os espaços que o usuário que autoriza pode view	Seu próprio aplicativo Atlassian OAuth 2.0
Workday	Perfis de worker de um relatório personalizado de Reports-as-a-Serviço (RaaS) do Workday, para diretórios de organização no Genie One	Consulte Conectar uma fonte de pessoas para o Genie One.

Origem	O que está indexado	Como você autentica
Google Drive	Arquivos do Google Workspace, arquivos do Microsoft Office, PDFs e arquivos de texto. Consulte os tipos de arquivo suportados em Limitações.	account de serviço do Google Cloud com delegação em todo o domínio
Jira cloud	Todos os projetos que o usuário autorizador pode acessar	Seu próprio aplicativo Atlassian OAuth 2.0
Confluence Cloud	Todos os espaços que o usuário que autoriza pode view	Seu próprio aplicativo Atlassian OAuth 2.0
Workday	Perfis de worker de um relatório personalizado de Reports-as-a-Serviço (RaaS) do Workday, para diretórios de organização no Genie One	Consulte Conectar uma fonte de pessoas para o Genie One.

Conectar uma fonte

começar cada conexão no console da account.

1. No console da account, clique em Genie Ontology .
2. Clique em Connect source .
3. Selecione a fonte.
4. Em Geo de residência de dados , selecione o geo onde o índice da fonte está armazenado. Você pode selecionar apenas um geo onde sua account tem um workspace. Se a account já tiver uma fonte, selecione o mesmo geo. Veja Armazenamento e localização.

Em seguida, conclua os passos para sua fonte:

Google Drive

Você precisa de um projeto do Google Cloud onde possa criar uma account de serviço e um administrador do Google Workspace que possa conceder delegação em todo o domínio no console de administração do Google.

1. Criar um serviço account e uma key JSON:

   1. No console do Google Cloud, vá para IAM & Admin > serviço accounts .
   2. Clique em Criar account de serviço .
   3. Insira um nome e uma descrição para a account de serviço e clique em Criar e continuar .
   4. Clique em Concluído . Você não precisa conceder funções de nível de projeto.
   5. Na página Accounts de serviço , clique na account de serviço que você criou.
   6. Na tab Keys , clique em Add key > Create new key .
   7. Selecione JSON e, em seguida, clique em Criar . O arquivo key JSON download na sua máquina.

2. Habilite as APIs do Google que o serviço account usa:

   1. No console do Google Cloud, vá para APIs e serviços > Biblioteca .
   2. Procure por Google Drive API , clique nela e clique em Habilitar .
   3. Procure por Admin SDK API , clique nela e clique em Enable .

3. Conceder delegação em todo o domínio:

   1. No console do Google Cloud, copie o ID exclusivo (ID do cliente) da serviço account na tab Detalhes .

   2. No Console de administrador do Google, vá para Segurança > Controle de acesso e dados > Controles de API .

   3. Em Delegação de domínio , clique em Gerenciar delegação de domínio .

   4. Clique em Adicionar novo .

   5. Em ID do cliente , cole o ID exclusivo da serviço account.

   6. Em OAuth scopes , insira os seguintes escopos somente leitura, separados por vírgulas:

      Text

      https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.reports.audit.readonly

   7. Clique em Autorizar .

4. Na caixa de diálogo Conectar Google Drive no Databricks, cole o conteúdo completo da key JSON, incluindo as chaves de abertura e fechamento, em account de serviço JSON .

5. Em Admin email , insira o email de um administrador do Google Workspace que pode ler usuários, grupos e drives compartilhados. A serviço account age como este administrador.

6. Clique em começar ingestão .

Se você pular algum dos passos de delegação, API ou escopo, a ingestão poderá falhar ou perder conteúdo até que você conclua essa configuração.

Jira

O usuário que autoriza a conexão deve ter as permissões globais ADMINISTER JIRA e BROWSE USERS AND GROUPS. Veja Permissões globais na documentação da Atlassian.

1. Na caixa de diálogo Conectar ao Jira , copie a URL de retorno.

2. No console do desenvolvedor da Atlassian, clique em Create > OAuth 2.0 integration , insira um nome e clique em Create . Para usar um aplicativo OAuth existente, abra-o e adicione os escopos e a URL de retorno nos os passos seguintes.

3. Vá para Permissões > API do Jira (em Escopos de API ) e clique em Adicionar .

4. Clique em Escopos clássicos > Editar escopos , depois adicione read:jira-work e read:jira-user.

5. Clique em Escopos granulares > Editar escopos e adicione os seguintes escopos:

   • read:project-role:jira
   • read:project-category:jira
   • read:project:jira
   • read:user:jira
   • read:avatar:jira
   • read:group:jira
   • read:application-role:jira
   • read:workflow:jira
   • read:issue-security-level:jira
   • read:issue-security-scheme:jira
   • read:audit-log:jira
   • read:sprint:jira-software
   • read:board-scope:jira-software
   • read:board-scope.admin:jira-software

6. Vá para Autorização , clique em Adicionar e insira a URL de callback que você copiou.

7. Vá para Configurações e copie o ID do cliente e o Segredo .

8. Na caixa de diálogo Conectar Jira , insira a URL do site do Jira , incluindo https://. Por exemplo, https://yourcompany.atlassian.net. Não adicione um caminho ou barra à direita.

9. Insira o ID do cliente e o Segredo do cliente do seu aplicativo OAuth.

10. Clique em Autorizar , escolha o site do Jira e clique em Aceitar .

11. Clique em começar ingestão .

Confluence

O usuário que autoriza a conexão deve ter a permissão global CONFLUENCE ADMINISTRATOR e acesso a todos os espaços que você deseja indexar. Consulte Gerenciar permissões globais na documentação da Atlassian.

1. Na caixa de diálogo Conectar Confluence , copie a URL de callback.

2. No console do desenvolvedor da Atlassian, clique em Create > OAuth 2.0 integration , insira um nome e clique em Create . Para usar um aplicativo OAuth existente, abra-o e adicione os escopos e a URL de retorno nos os passos seguintes.

3. Vá para Permissões > API do Confluence (em Escopos de API ) e clique em Adicionar .

4. Clique em Escopos granulares > Editar escopos e adicione os seguintes escopos:

   • read:page:confluence
   • read:attachment:confluence
   • read:space:confluence
   • read:configuration:confluence
   • read:label:confluence
   • read:space.permission:confluence
   • read:content.permission:confluence
   • read:content-details:confluence
   • read:group:confluence
   • read:user:confluence
   • read:audit-log:confluence

5. Vá para Autorização , clique em Adicionar e insira a URL de callback que você copiou.

6. Vá para Configurações e copie o ID do cliente e o Segredo .

7. Na caixa de diálogo Connect Confluence , insira o Confluence site domain , sem https://. Por exemplo, yourcompany.atlassian.net.

8. Insira o ID do cliente e o Segredo do cliente do seu aplicativo OAuth.

9. Clique em Autorizar , escolha o site do Confluence e clique em Aceitar .

10. Clique em começar ingestão .

Workday

Para conectar o Workday para diretórios de org, consulte Conectar uma fonte de pessoas para o Genie One.

A indexação inicial pode levar horas ou dias, dependendo de quanto conteúdo está na fonte. O status da fonte é provisionamento até que a indexação termine, então Searchable . Se a configuração falhar, o status é Failed .

Usar conteúdo indexado

Depois que uma fonte se torna Pesquisável , o chat do Genie One usa a Pesquisa do Genie automaticamente ao responder perguntas. Os usuários também podem encontrar conteúdos indexados no Genie One Discover, juntamente com os ativos do Databricks. Veja Usar a Pesquisa do Genie no Genie One.

Conectores do Genie Search e MCP

O Genie Search e os conectores do Model Context Protocol (MCP) funcionam em conjunto, e o Databricks recomenda habilitar ambos para as fontes das quais suas equipes dependem. O Genie Search permite ao Genie pesquisar tudo o que um administrador account indexou em um só lugar. Os conectores MCP permitem que cada usuário conecte aplicativos como Gmail e Slack com suas próprias credenciais, para que o Genie One possa pesquisar informações em tempo real e tomar medidas, como redigir um email, postar em um canal do Slack ou atualizar um problema no Jira.

Quando ambos estão habilitados, o Genie escolhe a abordagem que se adequa a cada solicitação. Por exemplo, ele pode usar o Genie Search para localizar os documentos de design, wikis e tickets sobre um lançamento e, em seguida, usar o conector do Atlassian para atualizar os problemas relacionados no Jira.

Aspecto	Genie Search	Conectores MCP
Configuração	Um administrador account conecta cada fonte uma vez para todo o account.	Cada usuário faz login em cada conector com suas próprias credenciais.
Pesquisar	Pesquisa todos os conteúdos indexados em fontes conectadas ao mesmo tempo.	Query cada fonte em tempo real. O Genie escolhe quais conectores chamar para cada solicitação.
Atualização	Mostra as alterações após o próximo refresh do índice.	Retorna o estado atual da origem.
Ações	Somente leitura.	Cria e atualiza o conteúdo no aplicativo como o usuário. Veja Ações de escrita.
Permissões	Aplica as permissões de origem de cada documento. As permissões são refresh com o conteúdo e os documentos não públicos são verificados novamente no momento da query.	Usa as próprias permissões do usuário no aplicativo.
Governança	Os administradores de account gerenciam cada fonte na página Ontologia do Genie no console da account.	Os administradores controlam conectores, ferramentas e políticas no Unity Gateway. Consulte Governar um MCP.
Origens	Google Drive, Jira, Confluence e Workday.	Conectores fornecidos pela Databricks e serviços MCP personalizados. Consulte Conectar o Genie One a aplicativos externos com MCP.

Aspecto	Genie Search	Conectores MCP
Configuração	Um administrador account conecta cada fonte uma vez para todo o account.	Cada usuário faz login em cada conector com suas próprias credenciais.
Pesquisar	Pesquisa todos os conteúdos indexados em fontes conectadas ao mesmo tempo.	Query cada fonte em tempo real. O Genie escolhe quais conectores chamar para cada solicitação.
Atualização	Mostra as alterações após o próximo refresh do índice.	Retorna o estado atual da origem.
Ações	Somente leitura.	Cria e atualiza o conteúdo no aplicativo como o usuário. Veja Ações de escrita.
Permissões	Aplica as permissões de origem de cada documento. As permissões são refresh com o conteúdo e os documentos não públicos são verificados novamente no momento da query.	Usa as próprias permissões do usuário no aplicativo.
Governança	Os administradores de account gerenciam cada fonte na página Ontologia do Genie no console da account.	Os administradores controlam conectores, ferramentas e políticas no Unity Gateway. Consulte Governar um MCP.
Origens	Google Drive, Jira, Confluence e Workday.	Conectores fornecidos pela Databricks e serviços MCP personalizados. Consulte Conectar o Genie One a aplicativos externos com MCP.

Gerenciar fontes

Administradores account gerenciar fontes conectadas na página Ontologia Genie no console da account.

Para parar de fornecer uma fonte do Google Drive, Jira ou Confluence sem excluir seu conteúdo indexado, desligue sua chave Habilitado . O Genie para de usar a fonte. Você pode ligá-lo novamente mais tarde.

Para substituir as credenciais de uma fonte do Google Drive, Jira ou Confluence sem excluir seu conteúdo indexado, clique no menu kebab na linha da fonte e, em seguida, clique em Re-authorize . Para revogar uma credencial, remova a fonte.

Para remover uma fonte:

1. Clique no menu kebab na linha da fonte.
2. Clique em Remover fonte .
3. Confirmar. A ingestão é interrompida, o conteúdo indexado é excluído e a reconexão requer uma ingestão completa.

Como o Genie Search trata seus dados

O Genie Search armazena uma cópia do conteúdo indexado e suas permissões no Databricks. As seções a seguir descrevem onde esses dados residem, como as credenciais e permissões de origem são tratadas e por quanto tempo os dados são retidos.

Armazenamento e localização

Cada account obtém um catálogo dedicado, e cada fonte obtém seu próprio índice de pesquisa. Dados indexados são armazenados no data plane e isolados de outros clientes.

Os dados indexados permanecem em uma única geo, que um administrador account escolhe quando conecta uma fonte. Todas as fontes na account usam a mesma geo. Os usuários podem consultar dados indexados de qualquer workspace nessa geo, e as queries de workspaces em outras geos são bloqueadas. Os chats do Genie One nível de account podem usar dados indexados quando a região estiver na mesma geo.

Credenciais

A credencial que você fornece ao conectar uma fonte é armazenada em uma conexão do Unity Catalog em um account gerenciado pelo Databricks. O Databricks usa apenas para ingerir os dados que você autorizar. Para substituir ou revogar uma credencial, consulte Gerenciar fontes.

Permissões

O Databricks ingere as permissões de cada documento junto com seu conteúdo e as aplica quando o Genie recupera resultados, para que os usuários vejam apenas o conteúdo que já podem acessar na fonte.

As permissões passam por refresh no mesmo ritmo do conteúdo, em um programar que varia conforme a fonte e depende de fatores como os limites da API de origem e o volume de dados. Para documentos não públicos, o Genie Search também verifica novamente o acesso na fonte no momento da query, usando um cache curto.

Os diretórios da organização são a exceção. Todos que usam o Genie One em sua account veem os mesmos detalhes de perfil. Veja O que é ingerido.

Retenção e exclusão

O conteúdo excluído na origem é removido do índice durante o próximo refresh. Para excluir todos os dados indexados de uma origem, remova a origem. Reconectá-la mais tarde exigirá uma ingestão completa. Para parar de usar uma origem sem excluir seus dados, desative a origem. Consulte Gerenciar origens.

Limitações

As seguintes limitações aplicam-se ao Genie Search.

• O Genie Search não está disponível nas regiões da AWS GovCloud.

• O conteúdo do Genie Search está disponível apenas no Genie One. O Genie Code não o usa.

• Você não pode excluir conteúdo de uma fonte, como pastas específicas do Google Drive, projetos do Jira ou espaços do Confluence.

• O Google Drive indexa apenas os seguintes tipos de arquivo. Outros arquivos, como imagens e vídeos, são ignorados.

  • Google Docs, Google Sheets e Google Slides
  • Microsoft Word (.doc e .docx)
  • Microsoft Excel (.xls e .xlsx)
  • Microsoft PowerPoint (.ppt e .pptx)
  • PDF (.pdf)
  • Texto simples (.txt)
  • Markdown (.md)
  • Formato de texto rico (.rtf)
  • CSV (.csv)

• Arquivos do Google Drive maiores que 100 MB são ignorados, e arquivos maiores que 10 MB mantêm apenas metadados.

• Os PDFs são indexados a partir de texto extraído, sem reconhecimento óptico de caracteres (OCR).

• Apenas Jira Cloud e Confluence Cloud são suportados. Jira e Confluence on-premises não são.

• Os resultados do Jira e Confluence seguem as permissões de cada item, mas o Genie Search não verifica se o usuário ainda possui uma licença do Jira ou Confluence.

• Não há API para gerenciar fontes. A configuração está no console da account.

• Todas as fontes em uma account usam a mesma geo. Para alterar a geo, remova todas as fontes e conecte-as novamente.

Preços

Neste momento, os clientes não incorrem em custos para o Genie Search. No entanto, o Databricks pode atualizar os preços do recurso a qualquer momento, notificando você e/ou atualizando nossa página de preços.