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 TeamsExtensão Amazon Quick Suite
A extensão Quick Suite Microsoft Teams integra assistência baseada em IA diretamente nos fluxos de trabalho de comunicação da sua equipe. Os usuários podem mencionar o @Amazon Quick Suite em conversas para acessar o conhecimento da empresa, usar conectores de ação configurados e obter assistência contextual sem sair do ambienteTeams.
A Teams extensão permite que os usuários:
-
Mencione o @Amazon Quick Suite nas conversas nos Teams canais para adicioná-lo como colaborador.
-
Use ações de conectores de ação configurados no Amazon Quick Suite.
-
Acesse qualquer fonte de conhecimento da empresa adicionada à sua instância do Amazon Quick Suite a partir de dentroMicrosoft Teams.
Importante
-
O cliente do Amazon Quick Suite que está integrando Microsoft Teams deve ter uma Microsoft Teams organização paga com uma M365assinatura para sua organização.
-
O Amazon Quick Suite não usa seus dados de usuário para melhoria de serviços ou para treinar seus grandes modelos de linguagem subjacentes (LLMs).
Pré-requisitos para extensão Microsoft Teams
Antes de configurar o acesso à extensão Amazon Quick SuiteMicrosoft Teams, os administradores devem concluir as seguintes etapas:
-
Tenha uma assinatura Microsoft 365 Business e seja um administrador global ou tenha permissões administrativas (especificamente
AppCatalog.ReadWrite.All). -
Tenha uma instância do Amazon Quick Suite.
-
Seu ID de Microsoft 365 inquilino. Você pode encontrar isso acessando o Azure portal > Azure Active Directory > Propriedades ou usandoPowerShell. Para obter etapas detalhadas, consulte Como encontrar sua ID de inquilino - Microsoft Entra
no Microsoft Learn portal.
Se você configurou a autenticação para se conectar ao Amazon Quick Suite com o IAM Identity Center, conclua as seguintes etapas adicionais:
-
Certifique-se de ter uma instância do IAM Identity Center ativada em sua AWS conta.
-
Use Microsoft Entra ID como seu provedor de identidade.
-
Certifique-se de que cada usuário na configuração do seu Entra ID provedor tenha um e-mail associado a eles.
-
Configure a propagação de identidade do SCIM entre a Microsoft Entra ID instância e o IAM Identity Center. Para obter etapas detalhadas, consulte Configurar SAML e SCIM com o Microsoft Entra ID e o IAM Identity Center.
nota
A Microsoft Teams extensão suporta somente a autenticação Entra ID com o IAM Identity Center.
Configurar o acesso à Microsoft Teams extensão
Como administrador, você deve permitir que o Amazon Quick Suite se conecte Microsoft Teams ao seu ambiente de aplicativos do Amazon Quick Suite. Você pode usar o console do Amazon Quick Suite para gerenciar as configurações de acesso à extensão.
Mapeamento de atributos de usuário
Quando você configura uma Microsoft Teams extensão, a identidade do usuário é mapeada por padrão usando os seguintes atributos:
-
Atributo de usuário do Amazon Quick Suite - O endereço de e-mail é usado para mapear os usuários do Amazon Quick Suite para suas Microsoft 365 contas correspondentes. O sistema usa o endereço de e-mail para estabelecer a conexão entre as identidades dos usuários.
-
M365Atributo de usuário do suplemento do Office - User Principal Name (UPN) é usado para comparar com as contas de Microsoft 365 usuário. Os usuários precisam usar o User Principal Name (UPN) para fazer login emMicrosoft 365. Endereço de e-mail que funciona em sistemas na nuvem e no local.
Esses mapeamentos padrão garantem uma identificação segura e precisa do usuário em ambas as plataformas sem exigir configuração adicional.
Tópicos
Adicione acesso à Microsoft Teams extensão para contas usando o IAM Identity Center e o Entra ID
Siga estas etapas para instalar e configurar um Azure inquilino no seu Microsoft Azure portal:
Para configurar um Azure inquilino
-
Na Azure conta, crie um novo registro de aplicativo.
-
Acesse Registros de aplicativos.
-
Na tela Registros de aplicativos, escolha Novo registro. Na opção Tipos de conta compatíveis, escolha Contas somente neste diretório organizacional (Somente para uso pessoal - Inquilino único). Quando terminar, escolha Registrar.
-
Anote o ID do cliente. Você precisará disso mais tarde.
-
Crie um segredo de cliente para o registro do aplicativo e anote-o. Você precisará disso mais tarde.
-
-
Adicione retorno de chamada URLs para cada região na qual sua Teams extensão será instalada.
-
Navegue até a guia Autenticação do registro do aplicativo.
-
Escolha Configurações da plataforma, adicione uma plataforma.
-
Escolha Web.
-
Crie uma URL de retorno de chamada usando o seguinte formato,
your-regionsubstituindo-a pela região da sua instância do Amazon Quick Suite. A Teams extensão é compatível com as seguintes regiões:ap-southeast-2eu-west-1us-west-2,,us-east-1e.qbs-cell001.dp.appintegrations.your-region.prod.plato.ai.aws.dev/auth/idc-tti/callback -
Insira o URL de retorno de chamada como o URI de redirecionamento e escolha Configurar quando terminar.
-
Siga estas etapas para configurar um emissor de token confiável em sua instância do IAM Identity Center em seu AWS console:
Para configurar um emissor de token confiável
-
Acesse sua AWS conta e navegue até sua instância do IAM Identity Center.
-
Navegue até Configurações, Autenticação.
-
Escolha Criar emissor de tokens confiáveis.
-
Adicione o URL do emissor, que deve seguir este modelo, onde
Tenant IDse refere ao seu ID de Entra inquilino:login.microsoftonline.com/Tenant ID/v2.0nota
O URL do emissor deve ser o ponto final de descoberta do OIDC de sua identidade sem o conhecido caminho do URI do documento. Se você incluir o caminho conhecido do URI do documento, isso não funcionará. Consulte as configurações do emissor de token confiável.
-
Escolha E-mail como o atributo do provedor de identidade e o atributo do IAM Identity Center.
Siga estas etapas para configurar as permissões no AWS console:
Configurar permissões
-
Navegue até Secrets Manager no AWS console.
-
Selecione Armazenar um novo segredo.
-
Escolha Outro tipo de segredo e escolha a guia Texto sem formatação.
-
Seu segredo deve estar no formato a seguir e usar o ID do cliente de registro do aplicativo e o segredo do cliente de registro do aplicativo que você salvou nas etapas anteriores:
{ "client_id":"Your app registration client ID", "client_secret":"Your app registration client secret" } -
Navegue até o segredo que você acabou de criar e salve o ARN para mais tarde.
-
Agora, navegue até IAM no AWS console.
-
Escolha Gerenciamento de acesso, Funções na barra de navegação esquerda.
-
Selecione Criar perfil.
-
Selecione Política de confiança personalizada.
-
Configure a função para confiar em nosso diretor de serviço para a região relevante que você selecionou ao configurar o registro do Azure aplicativo adicionando a seguinte declaração,
your-regionsubstituindo-a pela região que você escolheu ao criar o registro do Azure aplicativo:{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "your-region.prod.appintegrations.plato.aws.internal" }, "Action": "sts:AssumeRole", "Condition": {} } ] } -
Escolha Próximo.
-
Forneça um nome e uma descrição e escolha Criar função.
-
Navegue até a função que você acabou de criar e escolha-a.
-
Escolha Adicionar permissões, Criar política em linha.
-
Escolha JSON.
-
Configure a função com permissões para ler segredos do Secrets Manager e permissões para invocar
sso:DescribeTrustedTokenIssueradicionando a seguinte declaração:{ "Version": "2012-10-17", "Statement": [ { "Sid": "BasePermissions", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue", "sso:DescribeTrustedTokenIssuer" ], "Resource": "*" } ] } -
Forneça um nome de política e escolha Criar política.
-
Copie e salve o ARN da função do IAM que você criou para mais tarde. Você precisará dele nas próximas etapas.
Agora você pode seguir estas etapas para criar uma nova configuração de acesso à extensão que permitirá que o Amazon Quick Suite se integre ao seu Teams ambiente Microsoft:
Para criar uma configuração de acesso à extensão
-
Faça login no console do Amazon Quick Suite.
-
No canto superior direito, escolha o ícone da foto do perfil.
-
No menu suspenso, escolha Gerenciar conta.
-
Em Permissões, escolha Acesso à extensão.
-
No canto superior direito, escolha Novo acesso à extensão.
-
Selecione Microsoft Teams. Em seguida, escolha Próximo.
-
Configure os campos a seguir.
-
Nome - Um nome para sua extensão está pré-preenchido para você. Você pode editar isso e inserir um nome descritivo para a Teams extensão (máximo de 512 caracteres alfanuméricos, hífens permitidos, mas sem espaços).
-
Descrição (opcional) - Uma descrição da sua extensão está pré-preenchida para você. Você pode editar isso e inserir uma nova descrição para fornecer contexto adicional sobre essa configuração de extensão (máximo de 1000 caracteres).
-
ID do inquilino do M365 - Insira seu identificador de inquilino do Microsoft 365 (deve ter 36 caracteres).
-
Secrets Role ARN — cole o ARN da função do IAM que você criou nas etapas anteriores.
-
Secrets ARN - Cole o ARN do segredo do Secrets Manager que você criou nas etapas anteriores.
-
-
Escolha Adicionar para salvar a nova configuração de acesso.
Uma mensagem de sucesso será aberta no canto superior direito da tela.
-
Na mensagem de sucesso, escolha Exibir extensões para concluir a instalação da extensão.
nota
Você também pode navegar até a tela de instalação em Conexões > Extensões no menu Amazon Quick Suite.
Depois de criada, essa configuração de acesso à extensão permite que autores e outros administradores em sua organização implantem sua extensão Microsoft Teams Amazon Quick Suite em seu Microsoft Teams ambiente.
nota
Para que seus usuários finais comecem a usar sua Microsoft Teams extensão, um administrador ou autor deve concluir a implantação de uma extensão depois de configurar o acesso à extensão. Notifique seus autores de que eles podem visualizar, editar e concluir a instalação dessa extensão em Extensões no painel de navegação à esquerda depois que ela for compartilhada. Para saber como fazer isso, consulte Instalando sua Microsoft Teams extensão no guia do autor da Microsoft Teams extensão.
Adicione acesso à Microsoft Teams extensão para contas usando outros métodos de autenticação
Siga estas etapas para criar uma nova configuração de acesso à extensão que permitirá que o Amazon Quick Suite se integre ao seu Microsoft Teams ambiente.
-
Faça login no console do Amazon Quick Suite.
-
No canto superior direito, selecione o ícone da foto do perfil.
-
No menu suspenso, selecione Gerenciar conta.
-
Em Permissões, selecione Acesso à extensão.
-
No canto superior direito, selecione Novo acesso à extensão.
-
Selecione Microsoft Teams e, em seguida, Avançar.
-
Configure os campos a seguir.
-
Nome - Um nome para sua extensão está pré-preenchido para você. Você pode editar isso e inserir um nome descritivo para a Teams extensão (máximo de 512 caracteres alfanuméricos, hífens permitidos, mas sem espaços).
-
Descrição (opcional) - Uma descrição da sua extensão está pré-preenchida para você. Você pode editar isso e inserir uma nova descrição para fornecer contexto adicional sobre essa configuração de extensão (máximo de 1000 caracteres).
-
ID do inquilino do M365 - Insira seu identificador de Microsoft 365 inquilino (deve ter 36 caracteres).
-
-
Selecione Adicionar para salvar a nova configuração de acesso.
Uma mensagem de sucesso será aberta no canto superior direito da tela.
-
Na mensagem de sucesso, selecione Exibir extensões para concluir a instalação da extensão.
nota
Você também pode navegar até a tela de instalação em Conexões > Extensões no menu Amazon Quick Suite.
Depois de criada, essa configuração de acesso à extensão permite que autores e outros administradores em sua organização implantem sua extensão Microsoft Teams Amazon Quick Suite em seu Microsoft Teams ambiente.
nota
Para que seus usuários finais comecem a usar sua Microsoft Teams extensão, um administrador ou autor deve concluir a implantação de uma extensão depois de configurar o acesso à extensão. Notifique seus autores de que eles podem visualizar, editar e concluir a instalação dessa extensão em Extensões no painel de navegação à esquerda depois que ela for compartilhada. Para saber como fazer isso, consulte Instalando sua Microsoft Teams extensão no guia do autor da Microsoft Teams extensão.
Editar acesso à Microsoft Teams extensão
Use essas etapas para modificar as configurações de um acesso de Microsoft Teams extensão existente.
-
Faça login no console do Amazon Quick Suite.
-
No canto superior direito, selecione o ícone da foto do perfil.
-
No menu suspenso, selecione Gerenciar conta.
-
Em Permissões, selecione Acesso à extensão.
-
Selecione o ícone do menu de três pontos para a Microsoft Teams extensão que você precisa editar.
-
Selecione Editar.
-
Edite a configuração conforme necessário e selecione Salvar para confirmar as alterações.
Suas alterações na configuração de acesso à Microsoft Teams extensão são salvas e entrarão em vigor imediatamente.
Excluir acesso à Microsoft Teams extensão
Siga estas etapas para remover permanentemente uma configuração Microsoft Teams de acesso à extensão. Esta ação não pode ser desfeita.
-
Faça login no console do Amazon Quick Suite.
-
No canto superior direito, selecione o ícone da foto do perfil.
-
No menu suspenso, selecione Gerenciar conta.
-
Em Permissões, selecione Acesso à extensão.
-
Selecione o ícone do menu de três pontos para a Microsoft Teams extensão que você precisa excluir.
-
Selecione Excluir.
-
Digite a palavra “confirmar” e selecione EXCLUIR.
nota
A exclusão de um acesso à extensão remove o acesso de todos os usuários do seu M365 locatário e exclui todas as extensões criadas para. Teams Se a exclusão do acesso à extensão falhar, o administrador deverá alternar para a visualização do autor e excluir as Teams extensões que estão usando o acesso à extensão configurado antes de retornar para excluir o acesso à extensão.
Com o acesso à Microsoft Teams extensão configurado, sua equipe agora pode usar as menções do @Quick Suite em conversas para acessar a assistência de IA, o conhecimento da empresa e os conectores de ação diretamente em seu Teams ambiente.