View a markdown version of this page

Configurar o agente usando o construtor de conversas - Amazon Bedrock
Crie e configure um agente usando o Construtor de conversas no console do Amazon BedrockAdicione as permissões abaixo para usar o Construtor de conversas no console do Amazon Bedrock

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

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

Para criar um agente

  1. Faça login no AWS Management Console 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.

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

  3. Na sessão Agentes, escolha Criar agente.

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

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

  6. É 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 AWS Management Console 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.

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

  2. Escolha Editar no Construtor de agentes.

  3. No Construtor de agentes, escolha Assistente

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

  5. 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. Em seguida, você pode preparar o agente para testá-lo com suas configurações atualizadas na janela de teste. Para saber como testar o agente, consulte Testar e solucionar problemas de comportamento do agente.

    • 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

Se você pretende Configurar o agente usando o construtor de conversas, 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"
    }
  ]
}