Configure o Openflow Connector para o SharePoint¶

Pré-requisitos¶

1. Certifique-se de ter revisado Openflow Connector para SharePoint.

2. Certifique-se de ter configurado o Openflow.

Obtenha as credenciais¶

Como administrador do SharePoint, execute as seguintes ações:

1. Certifique-se de ter um aplicativo Microsoft Graph com as seguintes permissões do Microsoft Graph:

   1. Sites.Selected: limita o acesso apenas aos sites especificados.

   2. Files.SelectedOperations.Selected: limita o acesso apenas a arquivos em sites especificados.

   3. GroupMember.Read.All: usado para resolver as permissões do grupo SharePoint.

   4. User.ReadBasic.All: usado para resolver e-mails de usuário do Microsoft365.

2. Configure o SharePoint para ativar a autenticação OAuth, conforme descrito em Obtenha acesso sem um usuário. O conector usa as seguintes Microsoft Graph APIs para buscar dados no SharePoint:

   1. Baixe o conteúdo do driveItem

   2. Obtenha metadados do driveItem

   3. driveItem: delta

   4. Liste as permissões do driveItem

   5. grupo: delta

   6. Liste os membros do grupo

   7. Obtenha o usuário

3. Obtenha o URL do site de seu SharePoint do Microsoft 365 com arquivos ou pastas que deseja ingerir no Snowflake e as credenciais de seu administrador de conta Azure ou Office 365.

Configure a conta Snowflake¶

Como administrador de conta Snowflake, execute as seguintes tarefas manualmente ou usando o script incluído abaixo:

1. Crie uma nova função ou use uma função existente e conceda a Privilégios de banco de dados.

2. Crie um novo usuário de serviço Snowflake com o tipo SERVICE.

3. Conceda ao usuário do serviço Snowflake a função que você criou nas etapas anteriores.

4. Configure com a autenticação de pares de chaves para o usuário do Snowflake SERVICE da etapa 2.

5. A Snowflake recomenda enfaticamente essa etapa. Configure um gerenciador de segredos compatível com o Openflow, por exemplo, AWS, Azure e Hashicorp, e armazene as chaves públicas e privadas no armazenamento de segredos.

   Nota

   Se, por algum motivo, você não quiser usar um gerenciador de segredos, será responsável por proteger os arquivos de chave pública e chave privada usados para autenticação de pares de chaves de acordo com as políticas de segurança de sua organização.

   1. Depois que o gerenciador de segredos estiver configurado, determine como você se autenticará nele. No AWS, é recomendável que você use a função de instância EC2 associada ao Openflow, pois dessa forma nenhum outro segredo precisa ser mantido.

   2. No Openflow, configure um provedor de parâmetros associado a esse gerenciador de segredos, no menu de três traços no canto superior direito. Navegue até Controller Settings » Parameter Provider e, em seguida, busque os valores dos parâmetros.

   3. Nesse momento, todas as credenciais podem ser referenciadas com os caminhos de parâmetros associados e nenhum valor sensível precisa ser mantido no Openflow.

6. Se qualquer outro usuário Snowflake precisar de acesso aos documentos e tabelas brutos ingeridos pelo conector (por exemplo, para processamento personalizado no Snowflake), conceda a esses usuários a função criada na etapa 1.

7. Designar um warehouse para o conector usar. Comece com o menor tamanho de warehouse e, em seguida, experimente o tamanho, dependendo do número de tabelas sendo replicadas e da quantidade de dados transferidos. Os números de tabelas grandes normalmente são mais bem dimensionados com warehouses multicluster, em vez de warehouses maiores.

Caso de uso 1: use o conector apenas para ingerir arquivos¶

Use o conector para:

• Execute o processamento personalizado em arquivos ingeridos

• Realize a ingestão de arquivos e permissões do Sharepoint e mantenha-os atualizados

Caso de uso 2: use a definição do conector para ingerir arquivos e executar o processamento com o Cortex¶

Use a definição de fluxo predefinida para:

• Crie assistentes de AI para documentos públicos no site SharePoint de sua organização.

• Permita que os assistentes de AI sigam os controles de acesso especificados no site SharePoint de sua organização.

Caso de uso 3: personalize a definição do conector¶

Personalize a definição do conector para:

• Processe os arquivos ingeridos com a Document AI.

• Execute o processamento personalizado nos arquivos ingeridos.

Habilitação de grupos de sites Sharepoint¶

Consultar o Cortex Search Service¶

Você pode usar o serviço Cortex Search para criar aplicativos de bate-papo e pesquisa para conversar com seus documentos ou consultá-los no SharePoint.

Após instalar e configurar o conector e ele começar a ingerir conteúdo do Sharepoint, você poderá consultar o serviço Cortex Search. Para obter mais informações sobre como usar o Cortex Search, consulte Consulta a um Cortex Search Service.

Respostas do filtro

Para restringir as respostas do Cortex Search Service aos documentos aos quais um usuário específico tem acesso no SharePoint, você pode especificar um filtro que contenha o ID de usuário ou o endereço de e-mail do usuário ao consultar o Cortex Search. Por exemplo, filter.@contains.user_ids ou filter.@contains.user_emails. O nome do Cortex Search Service criado pelo conector é search_service no esquema Cortex.

Execute o seguinte código SQL em uma planilha SQL para consultar o Cortex Search Service com arquivos ingeridos de seu site SharePoint.

Substitua o seguinte:

• application_instance_name: nome de seu banco de dados e da instância do aplicativo do conector.

• user_emailID: ID de e-mail do usuário para o qual você deseja filtrar as respostas.

• your_question: a pergunta para a qual deseja obter respostas.

• number_of_results: número máximo de resultados a serem retornados na resposta. O valor máximo é 1.000 e o valor padrão é 10.

SELECT PARSE_JSON(
  SNOWFLAKE.CORTEX.SEARCH_PREVIEW(
    '<application_instance_name>.cortex.search_service',
      '{
        "query": "<your_question>",
         "columns": ["chunk", "web_url"],
         "filter": {"@contains": {"user_emails": "<user_emailID>"} },
         "limit": <number_of_results>
       }'
   )
)['results'] AS results

Aqui está uma lista completa de valores que você pode inserir em columns:

Exemplo: consulte um assistente de AI para obter informações sobre recursos humanos (HR)

Você pode usar o Cortex Search para consultar um assistente de AI para que os funcionários conversem com as versões mais recentes das informações de HR, como integração, código de conduta, processos de equipe e políticas da organização. Usando os filtros de resposta, você também pode permitir que os membros da equipe de HR consultem os contratos dos funcionários, respeitando os controles de acesso configurados no SharePoint.

SELECT PARSE_JSON(
     SNOWFLAKE.CORTEX.SEARCH_PREVIEW(
          '<application_instance_name>.cortex.search_service',
          '{
             "query": "What is my vacation carry over policy?",
             "columns": ["chunk", "web_url"],
             "filter": {"@contains": {"user_emails": "<user_emailID>"} },
             "limit": 1
          }'
     )
 )['results'] AS results

import snowflake.snowpark as snowpark
from snowflake.snowpark import Session
from snowflake.core import Root

def main(session: snowpark.Session):

   root = Root(session)

   # fetch service
   my_service = (root
     .databases["<application_instance_name>"]
     .schemas["cortex"]
     .cortex_search_services["search_service"]
   )

   # query service
   resp = my_service.search(
     query="What is my vacation carry over policy?",
     columns = ["chunk", "web_url"],
     filter = {"@contains": {"user_emails": "<user_emailID>"} },
     limit=1
   )
   return (resp.to_json())

curl --location "https://<account_url>/api/v2/databases/<application_instance_name>/schemas/cortex/cortex-search-services/search_service" \
     --header 'Content-Type: application/json' \
     --header 'Accept: application/json' \
     --header "Authorization: Bearer <CORTEX_SEARCH_JWT>" \
     --data '{
         "query": "What is my vacation carry over policy?",
         "columns": ["chunk", "web_url"],
         "limit": 1
     }'

{
  "results" : [ {
  "web_url" : "https://<domain>.sharepoint.com/sites/<site_name>/<path_to_file>",
  "chunk" : "Answer to the question asked."
  } ]
}

Localização de arquivos na área¶

Os arquivos armazenados na área podem ter nomes ilegíveis. Para encontrar arquivos específicos, use as tabelas de metadados como sua fonte de verdade. Essas tabelas contêm o mapeamento entre os nomes dos arquivos e seus IDs de arquivo correspondentes na área.

Para configurações ativadas para Cortex, use a seguinte consulta para encontrar arquivos:

SELECT DISTINCT METADATA:id FROM DOCS_CHUNKS WHERE METADATA:fullName LIKE '%<file_name>%';

Para configurações não Cortex, use a seguinte consulta:

SELECT FILE_ID FROM DOC_METADATA WHERE FILE_NAME = '<file_name>';

Substitua <file_name> pelo nome ou parte do nome do arquivo que você está procurando.

Os arquivos na área começam com o ID retornado dessas consultas.