Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Criar e configurar o agente manualmente

Modo de foco
Criar e configurar o agente manualmente - 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á.

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

Para criar um agente com o Amazon Bedrock, configure os seguintes componentes:

  • A configuração do agente, que define a finalidade do agente e indica o modelo de base (FM) que ele deve usar para interpretar e gerar prompts e respostas.

  • Pelo menos um dos seguintes:

    • Grupos de ação que definem a ações que o agente foi criado para executar.

    • Uma base de conhecimento de fontes de dados para aumentar as capacidades generativas do agente por meio da permissão de pesquisa e consulta.

É possível criar no mínimo um agente que tenha apenas um nome. Para Preparar um agente para que possa testá-lo ou implantá-lo, você deve configurar no mínimo 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 base (FM) Um FM para o agente invocar e executar a orquestração
Instruções Linguagem natural que descreve o que o agente deve fazer e como ele deve interagir com os usuários

Configure também 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 apresentará respostas com base somente no FM, nas instruções e nos modelos de base de prompts.

Para saber como criar um agente, escolha a guia do seu método preferido e siga as etapas:

Console
Para criar um agente
  1. Faça login no AWS Management Console usando uma IAMfunção com as permissões do Amazon Bedrock e abra o console do 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 usando uma IAMfunção com as permissões do Amazon Bedrock e abra o console do 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.

    3. Escolha Editar no Construtor de agentes.

  2. Na seção Detalhes do agente, é possível 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:

      • Criar e usar um novo perfil de serviço: permita que o Amazon Bedrock crie o perfil de serviço e configure as permissões necessárias em seu nome.

      • Usar um perfil de serviço existente: use um perfil personalizado que tenha configurado anteriormente.

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

      Por padrão, os modelos otimizados para agentes são exibidos. Para ver todos os modelos compatíveis com o Amazon Bedrock Agents, desmarque Agentes otimizados do Bedrock.

      É possível criar agentes com qualquer modelo de base. Atualmente, alguns dos modelos oferecidos são otimizados com prompts/analisadores ajustados para integração com a arquitetura dos agentes. Com o tempo, planejamos oferecer otimização para todos os modelos oferecidos.
    4. Em Instruções para o agente, forneça detalhes para informar ao agente o que deve fazer e como deve interagir com os usuários. As instruções substituem o espaço reservado $instructions$ no modelo de prompt de orquestração. Veja abaixo 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:

      • Interpretador de código: (opcional) escolha se deseja permitir que o agente execute tarefas que envolvam escrever, executar, testar e solucionar problemas de código. Para obter detalhes, consulte Gerar, executar e testar código com a interpretação de código.

      • Entrada do usuário: (opcional) escolha se deseja permitir que o agente solicite mais informações do usuário quando não tiver informações suficientes. Para obter detalhes, consulte Configurar o agente para solicitar informações do usuário.

      • 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 depois de 30 minutos em uma sessão com um agente do Amazon Bedrock, o agente não manterá 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 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 o perfil de serviço em seu nome, escolha Criar e usar um novo perfil de serviço. Para usar um perfil personalizado criado anteriormente, escolha Usar perfil de serviço existente.

      nota

      O perfil de serviço que o Amazon Bedrock cria para você não inclui permissões para recursos que estão em versão prévia. Para usar esses recursos, anexe as permissões corretas ao perfil 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 chave e, em seguida, atualize essa janela. Para usar uma chave existente, selecione uma chave em 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 chave-valor.

    9. Ao concluir a configuração do agente, selecione Próximo.

  3. Na seção Grupos de ação, é possível escolher Adicionar para adicionar grupos de ação ao agente. Para obter mais informações sobre como configurar grupos de ação, consulte Como usar grupos de ação para definir as ações para que o agente execute. Para saber como adicionar grupos de ação ao agente, consulte Adicionar um grupo de ação ao agente no Amazon Bedrock.

  4. Na seção Bases de conhecimento, é possível escolher Adicionar para associar grupos de conhecimento ao agente. Para obter mais informações sobre como configurar bases de conhecimento, consulte Recupere dados e gere respostas de IA com as bases de conhecimento Amazon Bedrock. Para saber como associar bases de conhecimento ao agente, consulteAumentar a geração de respostas do agente com a base de conhecimento.

  5. Na seção Detalhes da barreira de proteção, é possível escolher Editar para associar uma barreira de proteção ao agente e bloquear e filtrar conteúdo nocivo. Escolha uma barreira de proteção que deseja usar no menu suspenso em Selecionar a barreira de proteção e escolha a versão a ser usada em Versão da barreira de proteção. É possível selecionar Visualizar para ver as configurações da barreira de proteção. Para obter mais informações, consulte Impedir conteúdo prejudicial em modelos usando o Amazon Bedrock Guardrails.

  6. Na seção Estratégia de orquestração, você pode escolher Editar para personalizar a orquestração do seu agente. Para obter mais informações sobre a estratégia de orquestração que você pode usar para seu agente, consulte. Personalize a estratégia de orquestração de agentes

  7. Na seção Colaboração multiagente, você pode escolher Editar para criar uma equipe de colaboração multiagente. Para obter mais informações sobre colaboração entre vários agentes, consulteUse a colaboração de vários agentes com o Amazon Bedrock Agents .

  8. Ao concluir 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.

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

Consulte 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 Especificar um modelo de base (FM) com o qual o agente orquestrar.
instruction Fornecer instruções para informar ao agente o que fazer. Usada no espaço reservado $instructions$ no modelo de prompt de orquestração.

Os seguintes campos são opcionais:

Campo Caso de uso
description Descreve o que o agente faz.
idleSessionTTLInSeconds Tempo após o 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 agente.
promptOverrideConfiguration Para personalizar os prompts enviados ao FM em cada etapa da orquestração.
guardrailConfiguration Para adicionar uma barreira de proteção ao agente. Especifique a ID ou a grade ARN de proteção e a versão a ser usada.
clientToken Para garantir que a API solicitação seja concluída apenas uma vez. Para obter mais informações, consulte Ensuring idempotency.
cachingState Para habilitar o cache imediato da entrada para o agente. Para obter mais informações, consulte Cache imediato para inferência mais rápida do modelo.

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.

Para criar um agente
  1. Faça login no AWS Management Console usando uma IAMfunção com as permissões do Amazon Bedrock e abra o console do 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 usando uma IAMfunção com as permissões do Amazon Bedrock e abra o console do 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.

    3. Escolha Editar no Construtor de agentes.

  2. Na seção Detalhes do agente, é possível 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:

      • Criar e usar um novo perfil de serviço: permita que o Amazon Bedrock crie o perfil de serviço e configure as permissões necessárias em seu nome.

      • Usar um perfil de serviço existente: use um perfil personalizado que tenha configurado anteriormente.

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

      Por padrão, os modelos otimizados para agentes são exibidos. Para ver todos os modelos compatíveis com o Amazon Bedrock Agents, desmarque Agentes otimizados do Bedrock.

      É possível criar agentes com qualquer modelo de base. Atualmente, alguns dos modelos oferecidos são otimizados com prompts/analisadores ajustados para integração com a arquitetura dos agentes. Com o tempo, planejamos oferecer otimização para todos os modelos oferecidos.
    4. Em Instruções para o agente, forneça detalhes para informar ao agente o que deve fazer e como deve interagir com os usuários. As instruções substituem o espaço reservado $instructions$ no modelo de prompt de orquestração. Veja abaixo 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:

      • Interpretador de código: (opcional) escolha se deseja permitir que o agente execute tarefas que envolvam escrever, executar, testar e solucionar problemas de código. Para obter detalhes, consulte Gerar, executar e testar código com a interpretação de código.

      • Entrada do usuário: (opcional) escolha se deseja permitir que o agente solicite mais informações do usuário quando não tiver informações suficientes. Para obter detalhes, consulte Configurar o agente para solicitar informações do usuário.

      • 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 depois de 30 minutos em uma sessão com um agente do Amazon Bedrock, o agente não manterá 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 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 o perfil de serviço em seu nome, escolha Criar e usar um novo perfil de serviço. Para usar um perfil personalizado criado anteriormente, escolha Usar perfil de serviço existente.

      nota

      O perfil de serviço que o Amazon Bedrock cria para você não inclui permissões para recursos que estão em versão prévia. Para usar esses recursos, anexe as permissões corretas ao perfil 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 chave e, em seguida, atualize essa janela. Para usar uma chave existente, selecione uma chave em 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 chave-valor.

    9. Ao concluir a configuração do agente, selecione Próximo.

  3. Na seção Grupos de ação, é possível escolher Adicionar para adicionar grupos de ação ao agente. Para obter mais informações sobre como configurar grupos de ação, consulte Como usar grupos de ação para definir as ações para que o agente execute. Para saber como adicionar grupos de ação ao agente, consulte Adicionar um grupo de ação ao agente no Amazon Bedrock.

  4. Na seção Bases de conhecimento, é possível escolher Adicionar para associar grupos de conhecimento ao agente. Para obter mais informações sobre como configurar bases de conhecimento, consulte Recupere dados e gere respostas de IA com as bases de conhecimento Amazon Bedrock. Para saber como associar bases de conhecimento ao agente, consulteAumentar a geração de respostas do agente com a base de conhecimento.

  5. Na seção Detalhes da barreira de proteção, é possível escolher Editar para associar uma barreira de proteção ao agente e bloquear e filtrar conteúdo nocivo. Escolha uma barreira de proteção que deseja usar no menu suspenso em Selecionar a barreira de proteção e escolha a versão a ser usada em Versão da barreira de proteção. É possível selecionar Visualizar para ver as configurações da barreira de proteção. Para obter mais informações, consulte Impedir conteúdo prejudicial em modelos usando o Amazon Bedrock Guardrails.

  6. Na seção Estratégia de orquestração, você pode escolher Editar para personalizar a orquestração do seu agente. Para obter mais informações sobre a estratégia de orquestração que você pode usar para seu agente, consulte. Personalize a estratégia de orquestração de agentes

  7. Na seção Colaboração multiagente, você pode escolher Editar para criar uma equipe de colaboração multiagente. Para obter mais informações sobre colaboração entre vários agentes, consulteUse a colaboração de vários agentes com o Amazon Bedrock Agents .

  8. Ao concluir 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.

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

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.