

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

# Microsoft OutlookExtensão Amazon Quick (versão prévia)
<a name="outlook-extension-preview"></a>

**nota**  
No momento, essa extensão está disponível como uma prévia. Durante o período de pré-visualização, a extensão é totalmente funcional para usuários finais e cargas de trabalho de produção. Recursos administrativos, como controles centralizados de implantação e monitoramento de uso, estão sendo desenvolvidos e estarão disponíveis quando a extensão estiver disponível ao público em geral. A funcionalidade e os recursos podem mudar durante o período de pré-visualização. Recomendamos usar essa extensão em vez da Microsoft Outlook extensão legada para novas implantações.

A extensão Quick para Microsoft Outlook integra AI-powered assistência diretamente em seus fluxos de trabalho de e-mail. Os usuários podem aproveitar o Quick within Outlook para agilizar o gerenciamento da caixa de entrada e do calendário, redigir e-mails contextuais usando seus dados do Quick e realizar ações externas sem trocar de aplicativo.

A Outlook extensão permite que os usuários:
+ Priorize e organize sua caixa de entrada.
+ Pesquise conteúdo de e-mail relevante para um tópico usando linguagem natural.
+ Agende reuniões e gerencie seus calendários.
+ Resuma e-mails e elabore respostas contextuais usando dados rápidos.
+ Acesse seus dados corporativos e execute ações em aplicativos externos.

A Outlook extensão Amazon Quick está disponível no Amazon Quick para todos os usuários qualificados por padrão e não requer configuração administrativa para acesso do usuário se os usuários puderem acessar a loja de Microsoft Outlook aplicativos. Os usuários podem pesquisar o Amazon Quick na loja de Microsoft Outlook aplicativos ou visitar a [página da Microsoft Store do Quick for Outlook para](https://marketplace.microsoft.com/en-us/product/WA200010695) adicionar a extensão.

**Importante**  
A Outlook extensão Amazon Quick usa IA generativa para criar e executar código na sandbox do seu Outlook aplicativo para ajudá-lo a realizar suas Outlook tarefas. A IA pode cometer erros e realizar ações imprecisas em sua Outlook caixa de correio.
O Amazon Quick não usa seus dados de usuário para melhoria de serviços ou para treinar seus modelos de linguagem grande (LLMs) subjacentes.

Os procedimentos a seguir são para administradores de TI que desejam implantar automaticamente a Outlook extensão Amazon Quick em toda a organização em nome de seus usuários.

**Topics**
+ [Pré-requisitos para implantar a extensão em sua organização Microsoft Outlook](#outlook-preview-prerequisites)
+ [Microsoft Outlookpermissões de extensão](#outlook-preview-permissions)
+ [Implantando a Microsoft Outlook extensão em sua organização](#outlook-preview-deployment)

## Pré-requisitos para implantar a extensão em sua organização Microsoft Outlook
<a name="outlook-preview-prerequisites"></a>

Antes de configurar o acesso à extensão Amazon Quick paraMicrosoft Outlook, os administradores devem concluir as seguintes etapas:

1. Tenha uma assinatura Microsoft 365 Business e seja um administrador global ou tenha permissões administrativas (especificamente`AppCatalog.ReadWrite.All`).

1. Tenha uma instância Amazon Quick.

1. Conceda o consentimento do administrador de todo o locatário para Microsoft as permissões do Graph. Isso permite que a extensão acesse a caixa de entrada, o calendário e os dados de contato de todos os usuários da sua organização. Sem essas permissões, a extensão só pode responder a perguntas sobre o tópico de e-mail atualmente aberto. Para instruções, consulte [Conceda o consentimento do administrador em todo o inquilino](#outlook-preview-grant-admin-consent).

## Microsoft Outlookpermissões de extensão
<a name="outlook-preview-permissions"></a>

A Outlook extensão Amazon Quick usa o nível de permissão JavaScript da API do `ReadWriteMailbox` Office. Essa é uma permissão de manifesto do suplemento do Office, não um escopo da API Microsoft Graph.

Os recursos padrão do aplicativo para o Outlook suplemento são:
+ Pode ler e fazer alterações em seu documento
+ Acesse as informações do seu perfil, como seu nome, endereço de e-mail, nome da empresa e idioma preferido
+ Pode enviar dados pela Internet

### Permissões delegadas da API Graph
<a name="outlook-preview-graph-permissions"></a>

A Outlook extensão usa a integração com o Microsoft Graph, que requer permissões delegadas adicionais.

**Importante**  
Essas permissões são necessárias para que a Outlook extensão Amazon Quick forneça sua gama completa de recursos. Sem essas permissões concedidas, a extensão só pode responder perguntas sobre o tópico de e-mail atualmente aberto e redigir uma resposta. Ele não pode resumir sua caixa de entrada, gerenciar seu calendário ou realizar operações em toda a caixa de entrada, como pesquisar, organizar ou fazer a triagem de e-mails.

**nota**  
A Outlook extensão Amazon Quick não envia e-mails nem cria compromissos na agenda automaticamente. Ele usa a confirmação Human-in-the-Loop (HITL) antes de qualquer ação de envio, para que os usuários sempre revisem e aprovem as mensagens enviadas e as alterações no calendário.

Os usuários são solicitados a fazer login na primeira vez que interagirem com a extensão. Os administradores podem pré-aprovar essas permissões concedendo o consentimento do administrador em todo o locatário (consulte). [Conceda o consentimento do administrador em todo o inquilino](#outlook-preview-grant-admin-consent)

A tabela a seguir lista as permissões delegadas da API Graph usadas pela Outlook extensão.


| Permissão | Finalidade | 
| --- | --- | 
| Calendars.Read.Shared | Leia eventos no usuário e nos shared/delegate calendários para verificar a disponibilidade | 
| Calendars.ReadWrite | Crie, atualize e exclua eventos do calendário; accept/decline convites; verifique horários free/busy  | 
| Contacts.ReadWrite | Resolva os destinatários pelo nome, procure detalhes de contato e salve novos contatos | 
| Files.Read | Leia os OneDrive SharePoint arquivos/ do usuário para resumir ou referenciar anexos | 
| Mail.Read | Leia o conteúdo completo do e-mail, anexos e tópicos para resumos e itens de ação | 
| Mail.ReadBasic | Leia os metadados do e-mail (assunto, remetente, data) para uma listagem e pesquisa eficientes de caixas de correio | 
| Mail.ReadWrite | Organize e-mails: mova, exclua, marque read/unread, crie rascunhos e gerencie anexos | 
| MailboxSettings.ReadWrite | Leia e atualize o fuso horário, o horário de trabalho, a ausência do escritório, as regras da caixa de entrada e as categorias | 
| offline\_access | Obtenha o token de atualização para sessões persistentes sem reautenticação repetida | 
| People.Read | Sugira destinatários e resolva nomes usando sinais de colaboração e organização | 
| Tasks.ReadWrite | Crie, atualize, conclua e exclua tarefas e listas de tarefas emTo Do/Planner | 
| User.Read | Identifique o perfil, o e-mail, o cargo e o fuso horário do usuário conectado | 
| User.ReadBasic.All | Leia as informações básicas do perfil (nome, e-mail, foto) de outros usuários na organização | 

### Conceda o consentimento do administrador em todo o inquilino
<a name="outlook-preview-grant-admin-consent"></a>

Para habilitar todos os recursos da Outlook extensão Amazon Quick para todos os usuários da sua organização, conceda o consentimento do administrador de todo o locatário para as permissões do Microsoft Graph listadas acima. Isso pré-aprova as permissões para que usuários individuais não sejam solicitados a aprová-las quando usarem a extensão pela primeira vez.

Você pode concluir esse processo usando o Microsoft Graph PowerShell ou o Microsoft Graph Explorer.

#### Pré-requisitos
<a name="outlook-preview-admin-consent-prerequisites"></a>

Antes de conceder o consentimento do administrador, verifique se você tem uma função que inclua as seguintes permissões:
+ `Application.ReadWrite.All`
+ `DelegatedPermissionGrant.ReadWrite.All`

#### Conceda o consentimento do administrador usando PowerShell
<a name="outlook-preview-admin-consent-powershell"></a>

Siga estas etapas para conceder o consentimento do administrador usando o Microsoft GraphPowerShell:

1. Conecte-se ao Microsoft Graph com as permissões necessárias:

   ```
   Connect-MgGraph -Scopes "Application.ReadWrite.All","DelegatedPermissionGrant.ReadWrite.All"
   ```

1. Procure o ID principal do serviço Microsoft Graph para seu inquilino e salve o ID:

   ```
   Get-MgServicePrincipal -Filter "displayName eq 'Microsoft Graph'"
   ```

1. Crie um principal de serviço para a Outlook extensão Amazon Quick em seu locatário e salve o ID devolvido:

   ```
   New-MgServicePrincipal -AppId "a5342f89-ebb1-4b1d-966c-34e8df972aaf"
   ```

1. Conceda o consentimento do administrador para todas as permissões delegadas em nome de todos os usuários do seu locatário. {{ServicePrincipalId}}Substitua pela ID da etapa 3 e {{GraphServicePrincipalId}} pela ID da etapa 2:

   ```
   $params = @{
       "ClientId"    = "{{ServicePrincipalId}}"
       "ConsentType" = "AllPrincipals"
       "ResourceId"  = "{{GraphServicePrincipalId}}"
       "Scope"       = "Calendars.Read.Shared Calendars.ReadWrite Contacts.ReadWrite Files.Read Mail.Read Mail.ReadBasic Mail.ReadWrite MailboxSettings.ReadWrite offline_access People.Read Tasks.ReadWrite User.Read User.ReadBasic.All"
   }
   New-MgOauth2PermissionGrant -BodyParameter $params
   ```

#### Conceda consentimento do administrador usando o Graph Explorer
<a name="outlook-preview-admin-consent-graph-explorer"></a>

Siga estas etapas para conceder o consentimento do administrador usando o Microsoft Graph Explorer:

1. Faça login no Microsoft Graph Explorer com uma função que tenha as `DelegatedPermissionGrant.ReadWrite.All` permissões `Application.ReadWrite.All` e.

1. Procure o ID principal do serviço Microsoft Graph do seu inquilino e salve o ID da resposta:

   ```
   GET https://graph.microsoft.com/v1.0/servicePrincipals?$filter=displayName eq 'Microsoft Graph'&$select=id,displayName
   ```

1. Crie um principal de serviço para a Outlook extensão Amazon Quick em seu locatário e salve o ID devolvido:

   ```
   POST https://graph.microsoft.com/v1.0/servicePrincipals
   ```

   Corpo da solicitação:

   ```
   {
       "appId": "a5342f89-ebb1-4b1d-966c-34e8df972aaf"
   }
   ```

1. Conceda o consentimento do administrador para todas as permissões delegadas em nome de todos os usuários do seu locatário. {{ServicePrincipalId}}Substitua pela ID da etapa 3 e {{GraphServicePrincipalId}} pela ID da etapa 2:

   ```
   POST https://graph.microsoft.com/v1.0/oauth2PermissionGrants
   ```

   Corpo da solicitação:

   ```
   {
       "clientId": "{{ServicePrincipalId}}",
       "consentType": "AllPrincipals",
       "resourceId": "{{GraphServicePrincipalId}}",
       "scope": "Calendars.Read.Shared Calendars.ReadWrite Contacts.ReadWrite Files.Read Mail.Read Mail.ReadBasic Mail.ReadWrite MailboxSettings.ReadWrite offline_access People.Read Tasks.ReadWrite User.Read User.ReadBasic.All"
   }
   ```

Depois de conceder o consentimento do administrador, os usuários da sua organização não serão solicitados a aprovar as permissões individualmente quando usarem pela primeira vez a extensão Amazon Quick. Outlook A extensão terá acesso imediato a todos os seus recursos.

### Onde revisar as permissões
<a name="outlook-preview-review-permissions"></a>

Para revisar as permissões da Outlook extensão, acesse Microsoft Entra > **Aplicativos corporativos** > encontre o aplicativo chamado “Amazon Quick Outlook Agent” > **Permissões**.

## Implantando a Microsoft Outlook extensão em sua organização
<a name="outlook-preview-deployment"></a>

Depois de concluir os pré-requisitos e conceder o consentimento do administrador para as permissões do Microsoft Graph, siga estas etapas para implantar a extensão para seus usuários:

1. Faça login no centro M365 de administração.

1. Selecione **Configurações** > **Aplicativos integrados** no menu de navegação à esquerda.

1. Escolha **Obter aplicativos**.

1. Pesquise por “Amazon Quick”.

1. Localize o quadro do Amazon Quick in Outlook e escolha **Adquira agora**.

1. Confirme que você deseja adicionar o aplicativo.

1. Em **Atribuir usuários**, escolha **Organização inteira** ou **Específico**, users/groups dependendo de suas necessidades.

1. Depois de selecionar os usuários, revise as permissões e os recursos solicitados pelo aplicativo e escolha **Avançar**.

1. Escolha **Concluir implantação**.