

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

# Configurar o agente usando o construtor de conversas
<a name="agents-create-cb"></a>

O Construtor de conversas é um assistente interativo que ajuda você a configurar um agente. Com o Construtor de conversas, você usa linguagem natural para descrever o propósito do agente, o que resulta na criação de um agente totalmente testável que atenda ao propósito. O Construtor de conversas interage com você para obter todas as informações necessárias para criar ou atualizar o agente.

**Importante**  
Esse recurso está disponível no console do Amazon Bedrock nas regiões Leste dos EUA (N. da Virgínia), Oeste dos EUA (Oregon), Europa (Frankfurt), Ásia-Pacífico (Sydney) e Europa (Paris).

O Construtor de conversas executa *somente* as seguintes ações com base nas interações:
+ Atualizar o nome e a descrição do agente
+ Gerar um resumo das instruções do agente com base nas instruções fornecidas em linguagem natural
+ Criar um grupo de ação 
+ Atualizar o nome e a descrição de um grupo de ação
+ Definir uma função de grupo de ação com base em um resumo do grupo de ação
+ Associar, listar e desassociar a base de conhecimento
+ Listar ou excluir grupos de ação

Veja abaixo um exemplo de uma interação com o Construtor de conversas:

```
Conversational builder: Hello, I can help you update your Agent's configurations.

What configurations would you like to update?
You can say something like "Associate a knowledge base"

User: Create a travel agent
Conversational builder:  What is the purpose of this travel agent? What kind of tasks or capabilities should it have?
User: Travel agent books flights and hotels for vacation
Conversational builder: The travel agent with the purpose of booking flights and hotels for vacations has been successfully created.
```

## Crie e configure um agente usando o Construtor de conversas no console do Amazon Bedrock
<a name="create-configure-cb"></a>

**Para criar um agente**

1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock)

1. No painel de navegação à esquerda, selecione **Agentes**.

1. Na sessão **Agentes**, escolha **Criar agente**.

1. (Opcional) Altere o **Nome** gerado automaticamente para o agente e forneça uma **Descrição** opcional para ele.

1. Escolha **Criar**. O agente é criado e o **Construtor de agentes** do agente recém-criado será aberto, onde você poderá configurá-lo.

1. É possível continuar com o procedimento a seguir para configurar o agente ou retornar ao Construtor de agentes posteriormente.

**Como configurar o agente**

1. Se você ainda não estiver no Construtor de agentes, faça o seguinte:

   1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock)

   1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.

1. Escolha **Editar no Construtor de agentes**.

1. No Construtor de agentes, escolha **Assistente**

1. No painel Construtor de agentes, insira a finalidade do agente. Veja o exemplo de interação para começar a interagir com o assistente Construtor de conversas.

1. Quando o Construtor de conversas tiver concluído a configuração do agente, selecione uma das seguintes opções:
   + Para permanecer no **Construtor de agentes**, escolha **Salvar**. Será possível **Preparar** o agente para testá-lo com as configurações atualizadas na janela de teste. Para saber como testar o agente, consulte [Testar e solucionar problemas de comportamento do agente](agents-test.md).
   + Para retornar à página **Detalhes do agente**, escolha **Salvar e sair**.

## Adicione as permissões abaixo para usar o Construtor de conversas no console do Amazon Bedrock
<a name="permissions-cb"></a>

Se você pretende [Configurar o agente usando o construtor de conversas](#agents-create-cb), anexe as seguintes permissões:

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

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "InvokeInlineAgent",
      "Effect": "Allow",
      "Action": "bedrock:InvokeInlineAgent",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "bedrock:InlineAgentName": "AgentName-123"
        }
      }
    },
    {
      "Sid": "InvokeFoundationModel",
      "Effect": "Allow",
      "Action": "bedrock:InvokeModel",
      "Resource": "arn:aws:bedrock:us-east-1::foundation-model/{modelId}"
    },
    {
      "Sid": "S3AccessForKBAndActions",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject"
      ],
      "Resource": "arn:aws:s3:::bucket-name/*"
    },
    {
      "Sid": "S3AccessForCodeInterpreter",
      "Effect": "Allow",
      "Action": [
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAttributes",
        "s3:GetObjectAttributes"
      ],
      "Resource": "arn:aws:s3:::bucket/path/to/file"
    },
    {
      "Sid": "KnowledgeBaseAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:Retrieve",
        "bedrock:RetrieveAndGenerate"
      ],
      "Resource": "arn:aws:bedrock:us-east-1:123456789012:knowledge-base/knowledge-base-id"
    },
    {
      "Sid": "GuardrailAccess",
      "Effect": "Allow",
      "Action": "bedrock:ApplyGuardrail",
      "Resource": "arn:aws:bedrock:us-east-1:123456789012:guardrail/guardrail-id"
    },
    {
      "Sid": "LambdaInvoke",
      "Effect": "Allow",
      "Action": "lambda:InvokeFunction",
      "Resource": "arn:aws:lambda:us-east-1:123456789012:function:function-name"
    },
    {
      "Sid": "KMSAccess",
      "Effect": "Allow",
      "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
      ],
      "Resource": "arn:aws:kms:us-east-1:123456789012:key/key-id"
    }
  ]
}
```

------