As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# SharePoint Integração com a Microsoft
Use a SharePoint integração com a Microsoft para realizar ações em SharePoint listas, itens e arquivos, ou para criar bases de conhecimento a partir de SharePoint conteúdo para pesquisas e perguntas e respostas com inteligência artificial.
## O que é possível fazer
**Conector de ação**
Gerencie SharePoint listas, itens, arquivos e pastas de trabalho do Excel por meio de chamadas da API do Microsoft Graph.
**Base de conhecimento**
Indexe bibliotecas de SharePoint documentos, sites e páginas. Os agentes do Amazon Quick podem então pesquisar e responder perguntas sobre o conteúdo.
# SharePoint Integração de ações da Microsoft
Use o conector de SharePoint ação da Microsoft para gerenciar listas, itens, arquivos e pastas de trabalho do Excel diretamente no Amazon Quick por meio de linguagem natural.
A configuração dessa integração envolve duas etapas. Primeiro, você registra um aplicativo no Microsoft Entra e configura suas permissões. Em seguida, você cria a integração no Amazon Quick e a conecta ao seu aplicativo Entra. Para obter informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulte[Métodos de autenticação](quick-action-auth.md).
## Antes de começar
Certifique-se de ter o seguinte antes de configurar a integração.
+ Uma conta Microsoft 365 com SharePoint acesso.
+ Acesso ao [centro de administração do Microsoft Entra](https://entra.microsoft.com/) com pelo menos permissões de desenvolvedor de aplicativos.
+ Para obter os requisitos de assinatura, consulte[Configurar integrações no console](integration-console-setup-process.md).
## Configurar o Microsoft Entra
Antes de configurar o Amazon Quick, crie um registro de aplicativo no Microsoft Entra. Conclua todas as etapas a seguir no Entra antes de migrar para o console do Amazon Quick.
Para obter mais informações sobre registros de aplicativos, consulte [Registrar um aplicativo na plataforma de identidade da Microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app) na documentação da Microsoft.
### Registre o aplicativo
1. Abra o [centro de administração do Microsoft Entra](https://entra.microsoft.com/).
1. No painel de navegação à esquerda, escolha **Inserir ID** e, em seguida, escolha **Registros de aplicativos.**
1. Escolha **Novo registro**.
1. Em **Nome**, insira um nome descritivo para sua integração.
1. Para **Tipos de conta compatíveis**, escolha **Contas somente neste diretório organizacional**.
1. Em **URI de redirecionamento**, selecione **Web** e insira`https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`. *\$1region\$1*Substitua pela AWS região em que sua instância Amazon Quick está implantada.
1. Escolha **Registrar**.
1. Na página de visão geral, copie o ID do **aplicativo (cliente) e o ID** **do diretório (locatário)**. Você precisa desses valores para a configuração do Amazon Quick.
### Crie um segredo de cliente
O Amazon Quick precisa de um segredo de cliente para se autenticar com o Microsoft Entra. Esse segredo funciona como uma senha para o registro do aplicativo.
1. No registro do seu aplicativo, escolha **Certificados e segredos**.
1. Escolha **Novo segredo do cliente**.
1. Insira uma descrição e escolha um período de expiração.
1. Escolha **Adicionar**.
1. Copie o **valor** imediatamente. Esse valor só é exibido uma vez.
**Importante**
Copie o **valor** secreto, não o ID secreto. O valor é a string mais longa usada para autenticação.
### Configurar permissões de API
O Microsoft Graph oferece suporte a dois tipos de permissão para essa integração. As permissões delegadas permitem que o aplicativo atue em nome de um usuário conectado. As permissões do aplicativo permitem que o aplicativo atue sem um usuário conectado. Para obter mais informações, consulte [Visão geral das permissões do Microsoft Graph](https://learn.microsoft.com/en-us/graph/permissions-overview) na documentação da Microsoft.
1. No registro do seu aplicativo, escolha **as permissões da API**.
1. Escolha **Adicionar uma permissão** e escolha **Microsoft Graph**.
1. Escolha **Permissões delegadas** ou **Permissões de aplicativos** com base no seu método de autenticação e adicione as permissões da tabela apropriada abaixo.
1. Escolha **Conceder consentimento do administrador para [nome do seu inquilino]** para aprovar as permissões.
**Para autenticação do usuário (permissões delegadas):**
Adicione o seguinte como permissões delegadas no registro do aplicativo Entra. Para obter a referência completa de permissões, consulte a [referência de permissões do Microsoft Graph](https://learn.microsoft.com/en-us/graph/permissions-reference) na documentação da Microsoft.
**SharePoint integração de ações — permissões delegadas**
| Permissão | Description |
| --- | --- |
| Files.ReadWrite | Permite que o aplicativo leia, crie, atualize e exclua os arquivos do usuário conectado. |
| Sites.ReadWrite.All | Permite que o aplicativo edite ou exclua documentos e itens de lista em todos os conjuntos de sites em nome do usuário conectado. |
| offline\$1access | Permite que o aplicativo atualize os tokens de acesso sem exigir que o usuário faça login novamente. Isso reduz a frequência com que os usuários precisam se autenticar novamente. |
**Para autenticação de serviços (permissões do aplicativo):**
Adicione o seguinte como permissões do aplicativo no registro do aplicativo Entra.
**SharePoint integração de ações — permissões do aplicativo**
| Permissão | Description |
| --- | --- |
| Sites.ReadWrite.All | Permite que o aplicativo crie, leia, atualize e exclua documentos e itens de lista em todos os conjuntos de sites sem um usuário conectado. |
**Importante**
Com a autenticação de serviço, todas as ações são executadas como a conta de serviço. Qualquer usuário com acesso a essa integração pode realizar ações em todos os conjuntos de sites que a conta de serviço pode acessar. Defina o escopo das permissões do aplicativo de acordo com os requisitos de segurança da sua organização.
### Registre suas credenciais
Antes de sair do centro de administração do Microsoft Entra, confirme se você tem os seguintes valores. Você precisa deles para a configuração do Amazon Quick.
**Credenciais exigidas da Microsoft Entra**
| Valor | Onde encontrá-lo |
| --- | --- |
| ID da aplicação (cliente) | Página de visão geral do registro do aplicativo |
| ID do diretório (locatário) | Página de visão geral do registro do aplicativo |
| Valor do segredo do cliente | Página de certificados e segredos |
## Configure a integração no Amazon Quick
Depois de concluir a configuração do Entra, crie a integração no Amazon Quick.
1. No console do Amazon Quick, escolha **Integrações.**
1. Escolha **Microsoft SharePoint** e escolha o botão Adicionar (mais “\$1”).
1. Escolha a guia **Ações**.
1. Escolha **Executar ações na Microsoft SharePoint**.
1. Preencha os detalhes da integração:
+ **Nome — Nome** descritivo da sua SharePoint integração.
+ **Descrição** (opcional) — Objetivo da integração.
1. Escolha seu tipo de conexão e preencha as configurações de conexão:
1. Para **autenticação do usuário (OAuth)**, configure os seguintes campos:
+ **URL base** — `https://graph.microsoft.com/v1.0`
+ **ID do cliente — ID** do aplicativo (cliente) do registro do aplicativo Entra.
+ **Segredo do** cliente — Valor secreto do cliente do registro do seu aplicativo Entra.
+ **URL do token** — `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token`
+ **URL de autenticação** — `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize`
+ **URL de redirecionamento** — `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Para **autenticação de serviço**, configure os seguintes campos:
+ **ID do cliente — ID** do aplicativo (cliente) do registro do aplicativo Entra.
+ **Segredo do** cliente — Valor secreto do cliente do registro do seu aplicativo Entra.
+ **URL do token** — `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token`
+ **Escopo**: `.default`
1. Escolha **Criar e continuar**.
1. Escolha usuários com os quais compartilhar a integração.
1. Escolha **Próximo**.
## Ações disponíveis
Depois de configurar a integração, as ações a seguir estarão disponíveis.
**Ações SharePoint disponíveis da Microsoft**
| Categoria | Ação | Description |
| --- | --- | --- |
| Listas e itens | Exibir itens | Obtenha a coleção de itens em uma lista. |
| Listas e itens | Obter item | Retorna os metadados de um item em uma lista. |
| Listas e itens | Obter lista | Retorna os metadados de uma lista. |
| Listas e itens | Atualizar item | Atualize as propriedades em um item da lista. |
| Listas e itens | Excluir item | Remove um item de uma lista. |
| Arquivos | Carregar arquivo | Carregue um novo arquivo ou atualize um arquivo existente. Suporta arquivos de até 250 MB. |
| Arquivos | Pesquisar itens do Site Drive | Pesquise a hierarquia dos itens que correspondem a uma consulta. |
| Pastas de trabalho do Excel | Listar planilhas | Recupere uma lista de objetos da planilha. |
| Pastas de trabalho do Excel | Adicionar planilha | Adicione uma nova planilha à pasta de trabalho. |
| Pastas de trabalho do Excel | Leia a planilha | Recupere as propriedades de um objeto de planilha. |
| Pastas de trabalho do Excel | Folha de atualização | Atualize as propriedades de um objeto de planilha. |
| Pastas de trabalho do Excel | Excluir planilha | Exclua a planilha da pasta de trabalho. |
| Pastas de trabalho do Excel | Célula de leitura | Obtenha o valor de uma única célula por número de linha e coluna. |
| Pastas de trabalho do Excel | Célula de gravação | Defina o valor de uma única célula por número de linha e coluna. |
| Pastas de trabalho do Excel | Alcance de leitura | Obtenha os valores de um intervalo. |
| Pastas de trabalho do Excel | Intervalo de gravação | Atualize os valores de um intervalo. |
| Pastas de trabalho do Excel | Alcance claro | Limpe valores de intervalo, formato, preenchimento e borda. |
| Pastas de trabalho do Excel | Excluir intervalo | Exclua as células associadas ao intervalo. |
| Pastas de trabalho do Excel | Get Used Range | Obtenha o menor intervalo que engloba células com um valor ou formatação. |
## Gerenciar e solucionar problemas
Para editar, compartilhar ou excluir sua integração, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).
### Problemas de autenticação
+ **Registro de aplicativo incorreto** — Verifique se o registro do aplicativo no Microsoft Entra inclui as permissões de API necessárias e se o consentimento do administrador foi concedido.
+ **Segredo do cliente expirado** — Verifique se o segredo do cliente expirou em **Certificados e segredos** e gere um novo, se necessário.
+ **URI de redirecionamento incorreto** — Verifique se o URI de redirecionamento no Microsoft Entra corresponde. `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
### Mensagens de erro comuns
+ **`Access denied. You do not have permission to perform this action`**— O usuário autenticado não tem as permissões necessárias. Entre em contato com seu administrador para verificar e conceder as permissões apropriadas.
+ **`AADSTS50020: User account from identity provider does not exist in tenant`**— A conta do usuário não está configurada no inquilino correto do Microsoft Entra. Verifique se a conta de usuário existe no inquilino que corresponde à ID do diretório (inquilino) no registro do seu aplicativo.
# Integração da base de SharePoint conhecimento da Microsoft
Use a integração da base de SharePoint conhecimento da Microsoft para indexar SharePoint conteúdo para que os agentes do Amazon Quick possam pesquisar e responder perguntas sobre ele.
O Amazon Quick usa um aplicativo multilocatário pré-registrado para se conectar a quatro bases de conhecimento SharePoint. Você não precisa criar um registro de aplicativo. Quando um usuário se conecta pela primeira vez, a Microsoft apresenta uma caixa de diálogo de consentimento. Um administrador pode conceder consentimento em nome de toda a organização, ou usuários individuais podem consentir por si mesmos.
## Antes de começar
Verifique se você tem o seguinte antes de configurar a integração.
+ Uma conta Microsoft 365 com SharePoint acesso.
+ Para obter os requisitos de assinatura, consulte[Configurar integrações no console](integration-console-setup-process.md).
+ Talvez seu administrador da Microsoft precise conceder consentimento organizacional antes que os usuários possam criar uma base de SharePoint conhecimento. Os administradores podem conceder o consentimento de toda a organização fazendo login e escolhendo **Consentimento em nome da sua organização durante o fluxo de** criação da integração.
**nota**
Quando um administrador concede o consentimento organizacional, o Microsoft Entra cria automaticamente um Aplicativo Corporativo (responsável pelo serviço) em seu locatário. Você pode desativar ou excluir esse serviço principal a qualquer momento a partir dos **aplicativos corporativos** no centro de administração do Microsoft Entra, que revoga imediatamente todo o acesso.
## Permissões concedidas durante o consentimento
**SharePoint base de conhecimento — permissões**
| Permissão | solicitações de | Description |
| --- | --- | --- |
| Files.Read.All | Microsoft Graph | Permite que o aplicativo leia todos os arquivos que o usuário pode acessar. |
| Notes.Read.All | Microsoft Graph | Permite que o aplicativo leia todos os OneNote cadernos que o usuário pode acessar. |
| User.Read | Microsoft Graph | Permite que os usuários façam login e permite que o aplicativo leia o perfil do usuário conectado. |
| Sites.Read.All | Microsoft Graph | Permite que o aplicativo leia documentos e liste itens em todos os conjuntos de sites. |
| offline\$1access | Microsoft Graph | Permite que o aplicativo mantenha o acesso quando o usuário não está conectado ativamente. |
| AllSites.Read | Office 365 SharePoint Online | Permite que o aplicativo leia itens em todos os conjuntos de sites. |
## Configurar a integração da base de conhecimento
1. No console do Amazon Quick, escolha **Integrações.**
1. Escolha **Microsoft SharePoint** e escolha o botão Adicionar (mais “\$1”).
1. Na caixa de diálogo **Criar base de SharePoint conhecimento**, **em **Conta conectada**, escolha Entrar SharePoint** e concluir o fluxo de login e consentimento da Microsoft.
1. Em **Criar base de conhecimento**, insira um nome e uma descrição opcional para sua base de conhecimento.
1. Na seção **Conteúdo**, escolha **Adicionar conteúdo** e selecione as SharePoint páginas, arquivos ou pastas que você deseja indexar.
1. Escolha **Criar**.
## Tipos de conteúdo compatíveis
+ **Bibliotecas de documentos:** Word, Excel PowerPoint, PDF, OneNote (.one)
+ **Arquivos de mídia:** MP3, MP4, MOV, WMV
+ **Páginas do site e páginas wiki**
## Controles de acesso
**Importante**
Quando o Amazon Quick indexa SharePoint conteúdo, ele não sincroniza listas de controle de acesso (ACLs) de SharePoint. Todo o conteúdo indexado pode ser acessado por qualquer usuário que tenha acesso à base de conhecimento no Amazon Quick, independentemente de suas permissões no SharePoint Amazon Quick. Analise qual conteúdo você inclui ao criar uma base de conhecimento.
## Gerenciar e solucionar problemas
Para editar, compartilhar ou excluir sua integração, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).
Para solução de problemas gerais da base de conhecimento, incluindo problemas de sincronização e documentos ausentes, consulte[Bases de conhecimento sobre solução de](troubleshooting-knowledge-bases.md).
### SharePoint-questões específicas
+ **É necessário consentimento do administrador** — Algumas organizações exigem que um administrador conceda o consentimento antes que usuários individuais possam se conectar. Um administrador deve entrar e escolher **Consentimento em nome da sua organização** durante o fluxo de consentimento.
+ **Aplicativo corporativo desativado** — Se o principal de serviço foi desativado anteriormente em **aplicativos corporativos** no centro de administração do Microsoft Entra, reative-o para restaurar o acesso.
+ **SharePoint limitação** — SharePoint pode limitar as solicitações durante períodos de alto uso. Tente sincronizar novamente fora do horário de pico.