

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

# Configuração inicial para agentes de IA
<a name="ai-agent-initial-setup"></a>



Para começar a usar os agentes do Connect AI, primeiro você precisa criar um domínio. Como parte desse processo, você também pode, opcionalmente: 
+ Crie uma chave de criptografia para criptografar os trechos fornecidos nas recomendações ao atendente.
+ Crie uma base de conhecimento usando dados externos.
+ Criptografe o conteúdo importado dessas aplicações usando uma chave KMS.

As seções a seguir explicam como usar o console do Amazon Connect para habilitar os agentes do Connect AI. Siga-os na ordem indicada. Se você quiser usar APIs, presumimos que você tenha as habilidades de programação necessárias.

**Topics**
+ [Tipos de conteúdo compatíveis](#q-content-types)
+ [Visão geral da integração](#ai-agent-overview)
+ [Antes de começar](#ai-agent-requirements)
+ [Etapa 1: Criar um domínio](#enable-ai-agents-step1)
+ [Etapa 2: criptografe o domínio](#enable-ai-agents-step-2)
+ [Etapa 3: crie uma integração (base de conhecimento)](#enable-ai-agents-step-3)
+ [Etapa 4: configurar seu fluxo para agentes do Connect AI](#enable-ai-agents-step4)
+ [E se eu tiver várias bases de conhecimento?](#multiple-knowledge-base-tips)
+ [Quando a base de conhecimento foi atualizada pela última vez?](#enable-ai-agents-tips)
+ [Serviço de inferência entre regiões](#enable-ai-agents-cross-region-inference-service)

## Tipos de conteúdo compatíveis
<a name="q-content-types"></a>

Os agentes do Connect AI suportam a ingestão de arquivos HTML, Word, PDF e texto de até 1 MB. Observe o seguinte:
+ Arquivos de texto sem formatação devem estar em UTF-8.
+ Os documentos do Word devem estar no formato DOCX.
+ Os documentos do Word são automaticamente convertidos em um HTML simplificado e não retêm a família de fonte, o tamanho, a cor, o realce, o alinhamento ou outros aspectos de formatação do documento de origem, como cores de fundo, cabeçalhos ou rodapés.
+ Os arquivos PDF não podem ser criptografados nem protegidos por senha.
+ Não há suporte para ações e scripts incorporados em arquivos PDF.

Para conferir uma lista de cotas ajustáveis, como o número de respostas rápidas por base de conhecimento, consulte [Cotas de serviço dos agentes Connect AI](amazon-connect-service-limits.md#connect-ai-agents-quotas).

## Visão geral da integração
<a name="ai-agent-overview"></a>

Você segue estas etapas gerais para habilitar os agentes do Connect AI:

1. Crie um domínio (assistente). Um domínio consiste em uma única base de conhecimento, como o SalesForce Zendesk.

1. Crie uma chave de criptografia para criptografar os trechos fornecidos nas recomendações ao atendente.

1. Crie uma base de conhecimento usando dados externos:
   + Adicione integrações de dados do Amazon S3, SharePoint Microsoft Online[,](https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/sforce_api_objects_knowledge__kav.htm) Salesforce ZenDesk e use conectores [ ServiceNow](https://developer.servicenow.com/dev.do#!/reference/api/rome/rest/knowledge-management-api)pré-criados no console do Amazon Connect.
   + Criptografe o conteúdo importado dessas aplicações usando uma chave KMS.
   + Para certas integrações, especifique a frequência de sincronização.
   + Revise a integração.

1. Configure seu fluxo.

1. Atribua permissões.

## Antes de começar
<a name="ai-agent-requirements"></a>

Confira a seguir uma visão geral dos principais conceitos e das informações que serão solicitadas durante o processo de configuração. 

Para começar a usar os agentes do Connect AI, você deve criar um *domínio*: um assistente que consiste em uma base de conhecimento. Siga estas diretrizes ao criar domínios: 
+ Você pode criar vários domínios, mas eles não compartilham integrações de aplicações externas ou dados de clientes entre si. 
+ É possível associar cada domínio a uma ou mais instâncias do Amazon Connect, mas cada instância do Amazon Connect pode ser associada a apenas uma instância do Amazon Connect com um domínio.
**nota**  
Todas as integrações de aplicações externas que você cria estão no nível do domínio. Todas as instâncias do Amazon Connect associadas a um domínio herdam as integrações do domínio.  
Você pode associar a instância do Amazon Connect a um domínio diferente a qualquer momento escolhendo um domínio diferente.
+ Todas as integrações de aplicações externas que você cria estão no nível do domínio. Todas as instâncias do Amazon Connect associadas a um domínio herdam as integrações do domínio. 
+ Você pode associar a instância do Amazon Connect a um domínio diferente a qualquer momento escolhendo um domínio diferente. 

### Como nomear seu domínio
<a name="enable-domains-ai-agents"></a>

Ao criar um domínio, você é solicitado a fornecer um nome de domínio amigável que seja significativo para você, como o nome da sua organização. 

### (Opcional) Crie AWS KMS keys para criptografar o domínio e o conteúdo
<a name="enable-awsmanagedkey-ai-agents"></a>

Quando você ativa os agentes do Connect AI, por padrão, o domínio e a conexão são criptografados com um Chave pertencente à AWS. No entanto, se quiser gerenciar as chaves, você pode criar ou fornecer duas [AWS KMS keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys):
+ Use uma chave para o domínio de agentes do Connect AI, usada para criptografar o trecho fornecido nas recomendações. 
+ Use a segunda chave para criptografar o conteúdo importado do Amazon S3, SharePoint Microsoft Online, Salesforce ServiceNow ou. ZenDesk Observe que os índices de pesquisa dos agentes do Connect AI são sempre criptografados em repouso usando um Chave pertencente à AWS.

Para criar chaves do KMS, siga as etapas em [Etapa 1: Criar um domínio](#enable-ai-agents-step1), que serão apresentadas nesta seção.

A chave gerenciada pelo cliente é criada e gerenciada por você e pertence a você. Você tem controle total sobre a chave KMS e AWS KMS cobranças são aplicadas.

Se você optar por configurar uma chave KMS em que outra pessoa seja o administrador, a chave deverá ter uma política que permita `kms:CreateGrant``kms:DescribeKey`, `kms:Decrypt` e `kms:GenerateDataKey*` permissões para a identidade do IAM usando a chave para invocar agentes do Connect AI. Para usar agentes do Connect AI com bate-papo, tarefas e e-mails, a política principal do seu domínio de agentes do Connect AI deve permitir `kms:Decrypt``kms:GenerateDataKey*`, e `kms:DescribeKey` permissões para o responsável pelo `connect.amazonaws.com` serviço. 

**nota**  
Para usar os agentes do Connect AI com chat, tarefas e e-mails, a política de chaves do seu domínio deve conceder ao responsável pelo `connect.amazonaws.com` serviço principal as seguintes permissões:  
`kms:GenerateDataKey*`
`kms:DescribeKey`
`kms:Decrypt`
Consulte informações sobre como alterar uma política de chave em [Changing a key policy](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) no *Guia do desenvolvedor do AWS Key Management Service*.

## Etapa 1: Criar um domínio
<a name="enable-ai-agents-step1"></a>

As etapas a seguir explicam como adicionar um domínio a uma instância do Amazon Connect e como adicionar uma integração ao domínio. Para concluir essas etapas, você deve ter uma instância sem um domínio. 

1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

1. Na página **Instâncias da central de atendimento virtual do Amazon Connect**, escolha **Adicionar uma instância**. A imagem a seguir mostra um nome de instância típico.  
![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png)

1. No painel de navegação, escolha **Agentes de IA** e, em seguida, escolha **Adicionar domínio**.

1. Na página **Adicionar domínio**, escolha **Criar um domínio**.

1. Na caixa **Nome do domínio**, insira um nome fácil, como o nome da sua organização.  
![\[Página Adicionar domínio, opção Criar um novo domínio.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agent-enter-domain-name.png)

1. Mantenha a página aberta e passe para a próxima etapa.

## Etapa 2: criptografe o domínio
<a name="enable-ai-agents-step-2"></a>

Você pode usar a chave padrão do Amazon Connect para criptografar seu domínio. Você também pode usar uma chave existente ou criar chaves de sua propriedade. Os seguintes conjuntos de etapas explicam como usar cada tipo de chave. Expanda cada seção conforme necessário.

### Usar a chave padrão
<a name="q-key-use-default"></a>

1. Em **Criptografia**, desmarque a caixa de seleção **Personalizar configurações de criptografia**.

1. Escolha **Adicionar domínio**.

### Usar uma chave existente
<a name="q-key-use-existing"></a>

1. Em **Criptografia**, abra a lista **Chave do AWS KMS** e selecione a chave desejada.

1. Escolha **Adicionar domínio**.

**nota**  
Para usar uma chave existente com bate-papos, tarefas e e-mails do Amazon Connect, você deve conceder ao diretor do `connect.amazonaws.com` serviço `kms:DescribeKey` as permissões `kms:Decrypt``kms:GenerateDataKey*`, e.

O exemplo a seguir mostra uma política típica.

------
#### [ JSON ]

****  

```
{
    "Id": "key-consolepolicy-3",
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": "kms:*",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "connect.amazonaws.com"
            },
            "Action": [
                "kms:Decrypt",
                "kms:GenerateDataKey*",
                "kms:DescribeKey"
            ],
            "Resource": "*"
        }
    ]
}
```

------

### Crie uma AWS KMS chave
<a name="q-create-key"></a>

1. Na página **Adicionar domínio**, em **Criptografia**, escolha **Criar uma AWS KMS key**.  
![\[O botão Criar uma chave do AWS KMS.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/q-encryption-settings-1.png)

   Isso leva você ao console do Key Management Service (KMS). Siga estas etapas:

   1. No console do KMS, na página **Configurar chave**, escolha **Simétrica** e selecione **Próximo**.  
![\[Página Configurar chave, opção Simétrica.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)

   1. Na página **Adicionar rótulos**, insira um alias e uma descrição para a chave do KMS e escolha **Próximo**.   
![\[Página Adicionar rótulos, nome de alias e uma descrição.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-create-kms-key-add-labels.png)

   1. Na página **Definir permissões administrativas da chave**, escolha **Próximo** e, na página **Definir permissões de uso da chave**, escolha **Próximo** novamente.

   1. Na página **Revisar e editar políticas de chave**, role para baixo até **Política de chave**. 
**nota**  
Para usar os agentes do Connect AI com bate-papos, tarefas e e-mails, modifique a política de chaves para permitir as `kms:Decrypt` `kms:DescribeKey` permissões e o responsável pelo ` connect.amazonaws.com` serviço principal. ` kms:GenerateDataKey*` O código a seguir mostra um exemplo de política.   

****  

      ```
      {
          "Id": "key-consolepolicy-3",
          "Version":"2012-10-17",		 	 	 
          "Statement": [
              {
                  "Effect": "Allow",
                  "Principal": {
                      "AWS": "arn:aws:iam::111122223333:root"
                  },
                  "Action": "kms:*",
                  "Resource": "*"
              },
              {
                  "Effect": "Allow",
                  "Principal": {
                      "Service": "connect.amazonaws.com"
                  },
                  "Action": [
                      "kms:Decrypt",
                      "kms:GenerateDataKey*",
                      "kms:DescribeKey"
                  ],
                  "Resource": "*"
              }
          ]
      }
      ```

   1. Escolha **Terminar**.

      No exemplo a seguir, o nome da chave KMS começa com **82af7d87**.  
![\[A página “Chaves gerenciadas pelo cliente” mostrando uma chave típica.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-create-kms-key.png)

1. Volte para a guia do navegador dos **agentes Connect AI**, abra a **AWS KMS key**lista e selecione a chave que você criou nas etapas anteriores.  
![\[Interface de configurações de criptografia com opção de personalizar e selecionar uma chave AWS KMS.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-choose-kms-key.png)

1. Escolha **Adicionar domínio**. 

## Etapa 3: crie uma integração (base de conhecimento)
<a name="enable-ai-agents-step-3"></a>

1. Na página **Agentes** de IA, escolha **Adicionar integração**.

1. Na página **Adicionar integração**, escolha **Criar uma integração** e selecione uma origem.  
![\[A página “Adicionar integração”, a opção “Criar uma integração”, a lista suspensa “Origem”.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/wisdom-select-integration.png)

   As etapas para criar uma integração variam, dependendo da origem que você escolher. Expanda as seções a seguir conforme necessário para concluir a criação de uma integração.

### Criar uma integração com o Salesforce
<a name="salesforce-instance"></a>

Siga um processo de várias etapas para criar uma integração com o Salesforce. As seções a seguir explicam como concluir cada etapa.

#### Etapa 1: adicione a integração
<a name="q-salesforce-1"></a>

1. Marque todas as caixas de seleção exibidas. Isso confirma que você configurou sua conta do Salesforce corretamente:  
![\[Reconhecimentos da Salesforce por APIs, uso de aplicativos conectados e acesso. AppFlow\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/q-integration-salesforce-1.png)

1. Na caixa **Nome da integração**, insira um nome para a integração.
**dica**  
Caso crie várias integrações da mesma origem, recomendamos desenvolver uma convenção de nomenclatura para facilitar a distinção dos nomes.

1. Selecione **Usar uma conexão existente**, abra a lista **Selecionar uma conexão existente**, escolha uma conexão e selecione **Próximo**.

   —OU—

   Selecione **Criar uma conexão** e siga estas etapas:

   1. Escolha **Produção** ou **Sandbox.**

   1. Na caixa **Nome da conexão**, insira o nome da conexão. O nome é o URL do Salesforce sem o **https://**. 

   1. Selecione **Conectar**, faça login no Salesforce e, quando solicitado, escolha **Permitir**.

1. Em **Criptografia**, abra a lista **Chave do AWS KMS** e escolha uma chave.

   —OU—

   Escolha **Criar uma chave AWS KMS** e siga as etapas [Crie uma AWS KMS chave](#q-create-key) listadas anteriormente nesta seção.

1. (Opcional) Em **Frequência de sincronização**, abra a lista **Frequência de sincronização** e selecione um intervalo de sincronização. O padrão do sistema é de uma hora.

1. (Opcional) Em **Data de início da ingestão**, escolha **Ingerir registros criados depois de** e selecione uma data de início. O sistema usa como padrão a ingestão de todos os registros.

1. Escolha **Próximo** e siga as etapas na próxima seção deste tópico.

#### Etapa 2: selecione objetos e campos
<a name="q-salesforce-2"></a>

**dica**  
Caso crie várias integrações da mesma origem, recomendamos desenvolver uma convenção de nomenclatura para facilitar a distinção dos nomes.

1. Na página **Selecionar objetos e campos**, abra a lista **Objetos disponíveis** e selecione um objeto. Somente objetos de conhecimento aparecem na lista.

1. Em **Selecionar campos para** *nome do objeto*, escolha os campos que você deseja usar.
**nota**  
Por padrão, o sistema seleciona automaticamente todos os campos obrigatórios.

1. Escolha **Próximo**.

#### Etapa 3: revise e adicione a integração
<a name="q-salesforce-3"></a>
+ Revise as configurações da integração. Quando terminar, escolha **Adicionar integração**.

### Crie uma ServiceNow integração
<a name="servicenow-instance"></a>

1. Em **Configuração de integração**, marque a caixa de seleção ao lado de **Ler e confirme que sua ServiceNow conta atende aos requisitos de integração**. . 

1. Na caixa **Nome da integração**, insira um nome para a integração.
**dica**  
Caso crie várias integrações da mesma origem, recomendamos desenvolver uma convenção de nomenclatura para facilitar a distinção dos nomes.

1. Selecione **Usar uma conexão existente**, abra a lista **Selecionar uma conexão existente**, escolha uma conexão e selecione **Próximo**.

   —OU—

   Selecione **Criar uma conexão** e siga estas etapas:

   1. Na caixa **Nome de usuário**, insira seu nome de ServiceNow usuário. Você deve ter permissões de administrador.

   1. Na caixa **Senha**, insira sua senha. 

   1. Na caixa **URL da instância**, insira sua ServiceNow URL.

   1. Na caixa **Nome da conexão**, insira um nome para a conexão.

   1. Selecione **Conectar**.

   1. Em **Criptografia**, abra a lista **Chave do AWS KMS** e escolha uma chave.

      —OU—

      Escolha **Criar uma chave AWS KMS** e siga as etapas [Crie uma AWS KMS chave](#q-create-key) listadas anteriormente nesta seção.

   1. (Opcional) Em **Frequência de sincronização**, abra a lista **Frequência de sincronização** e selecione um intervalo de sincronização. O padrão do sistema é de uma hora.

   1. (Opcional) Em **Data de início da ingestão**, escolha **Ingerir registros criados depois de** e selecione uma data de início. O sistema usa como padrão a ingestão de todos os registros.

   1. Escolha **Próximo**.

1. Selecione os campos para a base de conhecimento. Os seguintes campos são obrigatórios:
   + short\$1description
   + número
   + workflow\$1state
   + sys\$1mod\$1count
   + active
   + texto
   + sys\$1updated\$1on
   + mais recente
   + sys\$1id

1. Escolha **Próximo**.

1. Revise suas configurações, altere-as conforme necessário e escolha **Adicionar integração**.

### Criar uma integração com o Zendesk
<a name="zendesk-instance"></a>

**Pré-requisitos**  
É necessário ter os seguintes itens para se conectar ao Zendesk:
+ Um ID de cliente e um segredo de cliente. Você obtém a ID e o segredo registrando seu aplicativo no Zendesk e ativando um fluxo de OAuth autorização. Para obter mais informações, consulte [Uso da OAuth autenticação com seu aplicativo](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application) no site de suporte da Zendesk.
+ Na Zendesk, um URL de redirecionamento configurado com `https://[AWS REGION].console.aws.amazon.com/connect/v2/oauth`. Por exemplo, .`https://ap-southeast-2.console.aws.amazon.com/connect/v2/oauth`

Depois de ter esses itens, siga estas etapas:

1. Em **Configuração da integração**, marque as caixas de seleção e insira um nome para a integração.
**dica**  
Caso crie várias integrações da mesma origem, recomendamos desenvolver uma convenção de nomenclatura para facilitar a distinção dos nomes.

1. Selecione **Usar uma conexão existente**, abra a lista **Selecionar uma conexão existente**, escolha uma conexão e selecione **Próximo**.

   —OU—

   Selecione **Criar uma conexão** e siga estas etapas:

   1. Insira um ID de cliente válido, um segredo do cliente, um nome da conta e um nome da conexão em suas respectivas caixas e escolha **Conectar**.

   1. Insira seu endereço de e-mail e senha e selecione **Fazer login**.

   1. No pop-up exibido, selecione **Permitir**.

   1. Em **Criptografia**, abra a lista **Chave do AWS KMS** e escolha uma chave.

      —OU—

      Escolha **Criar uma chave AWS KMS** e siga as etapas [Crie uma AWS KMS chave](#q-create-key) listadas anteriormente nesta seção.

1. (Opcional) Em **Frequência de sincronização**, abra a lista **Frequência de sincronização** e selecione um intervalo de sincronização. O padrão do sistema é de uma hora.

1. (Opcional) Em **Data de início da ingestão**, escolha **Ingerir registros criados depois de** e selecione uma data de início. O sistema usa como padrão a ingestão de todos os registros.

1. Escolha **Próximo**.

1. Selecione os campos da base de conhecimento e escolha **Próximo**. 

1. Revise suas configurações, altere-as conforme necessário e escolha **Adicionar integração**.

Depois de criar a integração, você só pode editar o URL.

### Crie uma integração SharePoint on-line
<a name="sharepoint-instance"></a>

**Pré-requisitos**  
Você deve ter o seguinte item para se conectar SharePoint:
+ Em SharePoint, um URL de redirecionamento configurado com`https://[AWS REGION].console.aws.amazon.com/connect/v2/oauth`. Por exemplo, .`https://ap-southeast-2.console.aws.amazon.com/connect/v2/oauth`

**nota**  
Somente AUTHORIZATION\$1CODE é compatível com conexões on-line. SharePoint CLIENT\$1CREDENTIALS não é suportado.

Depois de ter esse item, siga estas etapas:

1. Em **Configuração da integração**, marque a caixa de seleção e insira um nome para a integração.
**dica**  
Caso crie várias integrações da mesma origem, recomendamos desenvolver uma convenção de nomenclatura para facilitar a distinção dos nomes.

1. Em **Conexão com S3**, abra a lista **Selecionar uma conexão existente**, escolha uma conexão e selecione **Próximo**.

   —OU—

   Selecione **Criar uma conexão** e siga estas etapas:

   1. Insira seu ID de locatário nas duas caixas, insira um nome de conexão e escolha **Connect**. 

   1. Digite seu endereço de e-mail e senha para fazer login SharePoint.

   1. Em **Criptografia**, abra a lista **Chave do AWS KMS** e escolha uma chave.

      —OU—

      Escolha **Criar uma chave AWS KMS** e siga as etapas [Crie uma AWS KMS chave](#q-create-key) listadas anteriormente nesta seção.

   1. Em **Frequência de sincronização**, aceite o padrão ou abra a lista **Frequência de sincronização** e escolha um intervalo de sincronização.

   1. Escolha **Próximo**.

1. Em **Selecionar site da Microsoft SharePoint Online**, abra a lista e selecione um site.

1. Em **Selecionar pastas de** *nome do site*, escolha as pastas que você deseja incluir no domínio e selecione **Próximo**.

1. Revise suas configurações, altere-as conforme necessário e escolha **Adicionar integração**.

### Criar uma integração com o Amazon Simple Storage Service
<a name="s3-instance"></a>

1. Na caixa **Nome da integração**, insira um nome para a integração.
**dica**  
Caso crie várias integrações da mesma origem, recomendamos desenvolver uma convenção de nomenclatura para facilitar a distinção dos nomes.

1. Em **Conexões com o Microsoft SharePoint Online**, abra a lista **Selecionar uma conexão existente**, escolha uma conexão e escolha **Avançar**.

   —OU—

   Em **Conexão com o S3**, insira o URI do bucket do Amazon S3 e selecione **Próximo**.

   —OU—

   Escolha **Procurar no S3**, use a caixa de pesquisa para encontrar seu bucket, selecione o botão ao lado dele e **Escolher**.

1. Em **Criptografia**, abra a lista **Chave do AWS KMS** e escolha uma chave.

   —OU—

   Escolha **Criar uma chave AWS KMS** e siga as etapas [Crie uma AWS KMS chave](#q-create-key) listadas anteriormente nesta seção.

1. Escolha **Próximo**.

1. Revise suas configurações, altere-as conforme necessário e escolha **Adicionar integração**.

### Criar uma integração com o crawler da web
<a name="web-crawler-q"></a>

 O crawler da web se conecta e rastreia páginas HTML pelo URL inicial, percorrendo todos os links secundários no mesmo caminho e domínio principal. Se alguma das páginas HTML fizer referência a documentos compatíveis, o crawler da web buscará esses documentos, independentemente de estarem no mesmo domínio principal. 

**Recursos compatíveis**
+  Selecione vários URLs para rastrear. 
+  Respeite as diretivas padrão de robots.txt, como “Permitir” e “Não permitir”. 
+  Limite o escopo do URLs para rastrear e, opcionalmente, exclua aqueles URLs que correspondam a um padrão de filtro. 
+  Limite a taxa de rastreamento URLs. 
+  Veja o status de URLs visitado durante o rastreamento na Amazon. CloudWatch 

#### Pré-requisitos
<a name="web-crawler-q-prerequisites"></a>
+  Verifique se você está autorizado a rastrear sua fonte. URLs 
+  Verifique se o caminho para robots.txt correspondente à sua fonte URLs não impede que ele seja rastreado. URLs O crawler da web segue os padrões de robots.txt: não permitir por padrão se robots.txt não for encontrado para o site. O crawler da web segue o indicado em robots.txt de acordo com a [RFC 9309](https://www.rfc-editor.org/rfc/rfc9309.html) 
+  Verifique se suas páginas de URL de origem são geradas JavaScript dinamicamente, pois o rastreamento de conteúdo gerado dinamicamente não é suportado no momento. Você pode verificar isso inserindo o seguinte em seu navegador: `view-source:https://examplesite.com/site/`. Se o elemento do corpo contiver somente um elemento`div` e poucos ou nenhum elemento `a href`, é provável que a página seja gerada dinamicamente. Você pode desativar JavaScript em seu navegador, recarregar a página da web e observar se o conteúdo é renderizado corretamente e contém links para suas páginas da web de interesse.

**nota**  
Os rastreamentos da Web têm um tempo limite padrão de uma hora e serão interrompidos automaticamente quando esse limite for atingido.

**nota**  
Ao selecionar sites para crawling, você precisa aderir à [Política de uso aceitável da Amazon](https://aws.amazon.com/aup/) e a todos os outros termos da Amazon. Você só pode usar o crawler da web para indexar seus sites ou os sites que você tenha autorização para crawling.

#### Configuração de conexão
<a name="web-crawler-q-config"></a>

 Para reutilizar uma integração existente com campos de objetos, selecione **Usar uma conexão existente**, abra a lista **Selecionar uma conexão existente**, escolha uma conexão e selecione **Próximo**.

Para criar uma integração, siga estas etapas:

1. Escolha **Criar uma conexão**.

1.  Na caixa **Nome da integração**, atribua um nome fácil à integração.  
![\[Página de configuração da integração do Web Crawler mostrando o campo Nome da integração, onde os usuários inserem um nome para a nova conexão.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/web-crawler-ai-agent-config-1.png)

1.  Na URLs seção **Conexão com o Web Crawler > Fonte**, forneça a **Fonte URLs** do URLs que você deseja rastrear. Você pode adicionar até 9 adicionais URLs selecionando **Adicionar fonte URLs**. Ao fornecer um URL de origem, você confirma que tem autorização para fazer crawling de seu domínio.    
![\[A URLs seção Fonte para configurar a conexão do Web Crawler com campos a serem URLs inseridos para rastrear.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/web-crawler-q-config-2.png)

1.  Em Configurações avançadas, se desejar, você poderá configurar para usar a chave do KMS padrão ou uma chave gerenciada pelo cliente (CMK). 

1.  Em **Escopo da sincronização** 

   1.  Selecione uma opção para o **escopo** do rastreamento de sua fonte. URLs Você pode limitar o escopo do URLs rastreamento com base na relação específica de cada URL da página com a semente. URLs Para rastreamentos mais rápidos, você pode URLs limitar aqueles com o mesmo host e caminho de URL inicial do URL inicial. Para rastreamentos mais amplos, você pode optar por rastrear URLs com o mesmo host ou em qualquer subdomínio do URL inicial.  
**nota**  
Verifique se você não está fazendo crawling de sites possivelmente excessivos. Não é recomendável fazer crawling de sites grandes, como wikipedia.org, sem filtros ou limites de escopo. O crawling de sites grandes levará muito tempo.  
Os [tipos de arquivo compatíveis](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-ds.html) passam por crawling independentemente do escopo e caso não haja um padrão de exclusão para o tipo de arquivo.

   1.  Insira **Controle de utilização máximo da velocidade de crawling**. Ingira URLs entre 1 e 300 URLs por host por minuto. Uma velocidade de crawling maior aumenta a carga, mas leva menos tempo. 

   1.  Para padrões de **URL regex** (opcional), você pode adicionar **Padrões de inclusão** ou **Padrões de exclusão** inserindo o padrão de expressão regular na caixa. Você pode adicionar até 25 padrões de filtro de inclusão e 25 de exclusão selecionando **Adicionar novo padrão**. O crawling dos padrões de inclusão e exclusão é feito de acordo com seu escopo. Se houver um conflito, o padrão de exclusão terá precedência. 

      1.  Você pode incluir ou excluir alguns URLs de acordo com seu escopo. Os [tipos de arquivo compatíveis](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-ds.html) passam por crawling independentemente do escopo e caso não haja um padrão de exclusão para o tipo de arquivo. Se você especificar um filtro de inclusão e de exclusão e ambos corresponderem a um URL, o filtro de exclusão terá precedência e não será feito crawling do conteúdo da web. 
**Importante**  
Filtros problemáticos de padrões de expressão regular, que levam a um [retrocesso catastrófico](https://docs.aws.amazon.com/codeguru/detector-library/python/catastrophic-backtracking-regex/) e olham para o futuro, são rejeitados.

      1.  Veja a seguir um exemplo de um padrão de filtro de expressão regular para excluir URLs aquela extremidade com “.pdf” ou anexos de páginas da Web em PDF: `.*\.pdf$`   
![\[A seção de padrões de regex de URL mostra um exemplo de um padrão de exclusão para arquivos PDF.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/web-crawler-q-config-3.png)

1. Escolha **Próximo**.

1.  Analise todos os detalhes da integração.   
![\[A página de revisão mostrando todos os detalhes de integração da configuração do Web Crawler antes do envio final.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/web-crawler-q-config-4.png)

1.  Selecione **Adicionar integração**. 

1.  A integração é adicionada à lista. 

### Crie uma integração da base de conhecimento Bedrock
<a name="bedrock-knowledge-base-integration-ai-agents"></a>

Agora, com o Agente de IA do Tipo de Orquestração, você pode trazer sua própria Base de Conhecimento Bedrock para trabalhar perfeitamente com os Connect AI Agents.

**nota**  
O tipo de integração da base de conhecimento Bedrock só é compatível com os tipos de agentes de orquestração.

**nota**  
A integração da base de conhecimento da Bedrock está disponível apenas para chamadas com contato e não oferece suporte à pesquisa manual sem contato.

1. Adicionar nova integração  
![\[A página Adicionar integração.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/add-integration-page-ai-agents.png)

1. Escolha a base de conhecimento Bedrock  
![\[Selecionando a base de conhecimento Bedrock na lista de fontes de dados\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-select-byobkb-data-source.png)

1. Selecione a base de conhecimento existente da Bedrock  
![\[Seleção da base de conhecimento Bedrock existente\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-selecting-bedrock-knowledge-base.png)

1. Revise e adicione a integração  
![\[Página de revisão e integração do BYOBKB\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ai-agents-byobkb-review-and-integrate.png)

Você integrou com sucesso uma base de conhecimento existente da Bedrock com os agentes de IA do Connect

**nota**  
Se você excluir objetos de aplicativos SaaS, como SalesForce e ServiceNow, as bases de conhecimento do Amazon Connect não processarão essas exclusões. Você deve arquivar objetos SalesForce e retirar artigos ServiceNow para removê-los dessas bases de conhecimento.
Para a Zendesk, as bases de conhecimento do Amazon Connect não processam exclusões forçadas nem arquivos de artigos. Você deve cancelar a publicação de artigos no Zendesk para removê-los da base de conhecimento.
Para o Microsoft SharePoint Online, você pode selecionar no máximo 10 pastas.
O Amazon Connect adiciona automaticamente uma `AmazonConnectEnabled:True` tag aos recursos do agente Connect AI associados à sua instância do Amazon Connect, como uma base de conhecimento e um assistente. Isso é feito para autorizar o acesso do Amazon Connect aos recursos do agente Connect AI. Essa ação é resultado do controle de acesso baseado em tags na política gerenciada da função vinculada ao serviço Amazon Connect. Para obter mais informações, consulte [Permissões da função vinculada ao serviço no Amazon Connect](connect-slr.md#slr-permissions).

## Etapa 4: configurar seu fluxo para agentes do Connect AI
<a name="enable-ai-agents-step4"></a>

1. Adicione um bloco [Assistente Connect](connect-assistant-block.md) ao seu fluxo. O bloco associa um domínio de agentes do Connect AI ao contato atual. Isso permite que você exiba informações de um domínio específico, com base em critérios sobre o contato.

   Se você optar por [personalizar](customize-connect-ai-agents.md) a experiência, você criará um Lambda e usará um [Função AWS Lambda ](invoke-lambda-function-block.md) bloco para adicioná-lo aos seus fluxos.

1. Para usar os agentes do Connect AI com chamadas, você deve habilitar a análise Contact Lens conversacional no fluxo adicionando um [Set recording and analytics behavior (Definir o comportamento de gravação e análise)](set-recording-behavior.md) bloco configurado para análise Contact Lens conversacional em tempo real. Não importa em que parte do fluxo você adiciona o bloco [Set recording and analytics behavior (Definir o comportamento de gravação e análise)](set-recording-behavior.md). 

## E se eu tiver várias bases de conhecimento?
<a name="multiple-knowledge-base-tips"></a>

Você pode configurar seu agente de orquestração para utilizar várias bases de conhecimento [configurando várias](https://docs.aws.amazon.com/connect/latest/adminguide/multiple-knowledge-base-setup-and-content-segmentation.html) ferramentas de recuperação.

## Quando a base de conhecimento foi atualizada pela última vez?
<a name="enable-ai-agents-tips"></a>

Para confirmar a última data e hora em que sua base de conhecimento foi atualizada (o que significa uma alteração no conteúdo disponível), use a [GetKnowledgeBase](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_GetKnowledgeBase.html)API como referência`lastContentModificationTime`.

## Serviço de inferência entre regiões
<a name="enable-ai-agents-cross-region-inference-service"></a>

Os agentes do Connect AI usam [inferência entre regiões](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html) para selecionar automaticamente a AWS região ideal para processar seus dados, melhorando a experiência do cliente ao maximizar os recursos disponíveis e a disponibilidade do modelo. Se você não quiser que seus dados sejam processados em uma região diferente da selecionada, entre em contato com o AWS Support.

**nota**  
Embora os prompts personalizados existentes continuem usando a inferência na região, recomendamos a atualização para os modelos compatíveis mais recentes para se beneficiar dos recursos de inferência entre regiões. Você pode entrar em contato com o AWS Support para obter assistência na migração dos prompts existentes.