Crie um agente para seu aplicativo

Para criar um agente com o Amazon Bedrock, você configura os seguintes componentes:

• A configuração do agente, que define a finalidade do agente e indica o modelo básico (FM) que ele usa para gerar solicitações e respostas.

• Pelo menos um dos seguintes:

  • Grupos de ações que definem quais ações o agente foi projetado para realizar.

  • Uma base de conhecimento de fontes de dados para aumentar os recursos generativos do agente, permitindo pesquisas e consultas.

Você pode criar minimamente um agente que tenha apenas um nome. Para preparar um agente para que você possa testá-lo ou implantá-lo, você deve configurar minimamente os seguintes componentes:

Configuração	Descrição
Função de recurso do agente	A ARN da função de serviço com permissões para chamar API operações no agente
Modelo de fundação (FM)	Um FM para o agente invocar para realizar a orquestração
Instruções	Linguagem natural que descreve o que o agente deve fazer e como ele deve interagir com os usuários

Você também deve configurar pelo menos um grupo de ação ou base de conhecimento para o agente. Se você preparar um agente sem grupos de ação ou bases de conhecimento, ele retornará respostas com base somente no FM, nas instruções e nos modelos básicos de solicitações.

Para saber como criar um agente, selecione a guia correspondente ao seu método de escolha e siga as etapas.

Console

Para criar um agente

1. Faça login no AWS Management Console usando uma IAMfunção com permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

2. Selecione Agentes no painel de navegação esquerdo.

3. Na seçã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. Seu agente é criado e você será levado ao criador de agentes do seu agente recém-criado, onde poderá configurá-lo.

6. Você pode continuar com o procedimento a seguir para configurar seu agente ou retornar ao Agent Builder posteriormente.

Para configurar seu agente

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

   1. Faça login no AWS Management Console usando uma IAMfunção com permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

   2. Selecione Agentes no painel de navegação esquerdo. Em seguida, escolha um agente na seção Agentes.

   3. Escolha Editar no Agent Builder.

2. Na seção Detalhes do agente, você pode definir as seguintes configurações:

   1. Edite o nome do agente ou a descrição do agente.

   2. Para a função de recurso do agente, selecione uma das seguintes opções:

      • Crie e use uma nova função de serviço — Deixe o Amazon Bedrock criar a função de serviço e configurar as permissões necessárias em seu nome.

      • Use uma função de serviço existente — Use uma função personalizada que você configurou anteriormente.

   3. Em Selecionar modelo, selecione um FM para seu agente invocar durante a orquestração.

   4. Em Instruções para o agente, insira detalhes para dizer ao agente o que ele deve fazer e como ele deve interagir com os usuários. As instruções substituem o espaço reservado $instructions$ no modelo de prompt de orquestração. Veja a seguir um exemplo de instruções:

      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.

   5. Se você expandir Configurações adicionais, poderá modificar as seguintes configurações:

      Entrada do usuário — Escolha se deseja permitir que o agente solicite mais informações do usuário se ele não tiver informações suficientes.

      • Se você escolher Ativado, o agente retornará uma observação solicitando ao usuário mais informações se ele precisar invocar uma API em um grupo de ação, mas não tiver informações suficientes para concluir a solicitação. API

      • Se você escolher Desativado, o agente não solicitará detalhes adicionais ao usuário e, em vez disso, informará ao usuário que ele não tem informações suficientes para concluir a tarefa.

      • KMSseleção de chave — (Opcional) Por padrão, AWS criptografa os recursos do agente com uma chave AWS gerenciada. Para criptografar seu agente com sua própria chave gerenciada pelo cliente, na seção de seleção de KMS chaves, selecione Personalizar configurações de criptografia (avançadas). Para criar uma nova chave, selecione Criar uma AWS KMS chave e, em seguida, atualize essa janela. Para usar uma chave existente, selecione uma chave em Escolher uma AWS KMS chave.

      • Tempo limite da sessão ociosa — Por padrão, se um usuário não responder por 30 minutos em uma sessão com um agente do Amazon Bedrock, o agente não mantém mais o histórico da conversa. O histórico de conversa é usado tanto para retomar uma interação quanto para aumentar as respostas com o contexto da conversa. Para alterar esse período de tempo padrão, insira um número no campo Tempo limite da sessão e escolha uma unidade de tempo.

   6. Para a seção de IAMpermissões, para a função de recurso do agente, escolha uma função de serviço. Para permitir que o Amazon Bedrock crie a função de serviço em seu nome, escolha Criar e use uma nova função de serviço. Para usar uma função personalizada que você criou anteriormente, escolha Usar uma função de serviço existente.

      nota

      A função de serviço que o Amazon Bedrock cria para você não inclui permissões para recursos que estão em pré-visualização. Para usar esses recursos, anexe as permissões corretas à função de serviço.

   7. (Opcional) Por padrão, AWS criptografa os recursos do agente com um Chave gerenciada pela AWS. Para criptografar seu agente com sua própria chave gerenciada pelo cliente, na seção de seleção de KMS chaves, selecione Personalizar configurações de criptografia (avançadas). Para criar uma nova chave, selecione Criar uma AWS KMS tecla e, em seguida, atualize essa janela. Para usar uma chave existente, selecione uma chave para Escolher uma AWS KMS chave.

   8. (Opcional) Para associar tags a esse agente, na seção Tags — opcional, escolha Adicionar nova tag e forneça um par de valores-chave.

   9. Quando terminar de definir a configuração do agente, selecione Avançar.

3. Na seção Grupos de ações, você pode escolher Adicionar para adicionar grupos de ação ao seu agente. Para obter mais informações sobre a configuração de grupos de ação, consulteUse grupos de ação para definir ações para seu agente realizar. Para saber como adicionar grupos de ação ao seu agente, consulteAdicione um grupo de ação ao seu agente no Amazon Bedrock.

4. Na seção Bases de conhecimento, você pode escolher Adicionar para associar grupos de conhecimento ao seu agente. Para obter mais informações sobre como configurar bases de conhecimento, consulteRecupere dados e gere respostas de IA com bases de conhecimento. Para saber como associar bases de conhecimento ao seu agente, consulteAumente a geração de respostas para seu agente com a base de conhecimento.

5. Na seção Detalhes do Guardrails, você pode escolher Editar para associar um guardrail ao seu agente para bloquear e filtrar conteúdo nocivo. Selecione uma grade de proteção que você deseja usar no menu suspenso em Selecionar grade de proteção e, em seguida, escolha a versão a ser usada em Versão da grade de proteção. Você pode selecionar Exibir para ver as configurações do Guardrail. Para obter mais informações, consulte Impeça o conteúdo nocivo em modelos usando o Amazon Bedrock Guardrails.

6. Na seção Solicitações avançadas, você pode escolher Editar para personalizar as solicitações enviadas ao FM pelo seu agente em cada etapa da orquestração. Para obter mais informações sobre os modelos de prompt que você pode usar para personalização, consulteAumente a precisão do agente usando modelos de solicitação avançados no Amazon Bedrock. Para saber como configurar prompts avançados, consulteConfigurar modelos de prompt avançados.

7. Ao terminar de configurar seu agente, selecione uma das seguintes opções:

   • Para permanecer no Agent Builder, 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 seu agente, consulteTeste e solucione problemas de comportamento do agente.

   • Para retornar à página Detalhes do agente, escolha Salvar e sair.

API

Para criar um agente, envie um CreateAgentsolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock.

Veja exemplos de código

Para preparar seu agente e testá-lo ou implantá-lo, para que você possa testá-lo ou implantá-lo, você deve incluir minimamente os seguintes campos (se preferir, você pode ignorar essas configurações e configurá-las posteriormente enviando um UpdateAgentsolicitação):

Campo	Caso de uso
agentResourceRoleArn	Para especificar uma ARN das funções de serviço com permissões para chamar API operações no agente
foundationModel	Para especificar um modelo básico (FM) para o agente orquestrar
instrução	Fornecer instruções para dizer ao agente o que fazer. Usado no espaço reservado $instructions$ do modelo de prompt de orquestração.

Os campos a seguir são opcionais:

Campo	Caso de uso
description	Descreve o que o agente faz
idleSessionTTLInSeconds	Duração após a qual o agente encerra a sessão e exclui todas as informações armazenadas.
customerEncryptionKeyArn	ARNde uma KMS chave para criptografar os recursos do agente
tags	Para associar tags ao seu agente.
promptOverrideConfiguration	Para personalizar os prompts enviados ao FM em cada etapa da orquestração.
guardrailConfiguration	Para adicionar uma grade de proteção ao agente. Especifique a ID ou a grade ARN de proteção e a versão a ser usada.
clientToken	Identificador para garantir que a API solicitação seja concluída apenas uma vez.

A resposta retorna um CreateAgentobjeto que contém detalhes sobre seu agente recém-criado. Se seu agente não for criado, o CreateAgentO objeto na resposta retorna uma lista de failureReasons e uma lista de recommendedActions para você solucionar o problema.