Gerencie um agente do Amazon Bedrock

Depois de criar um agente, você pode visualizar ou atualizar sua configuração conforme necessário. A configuração se aplica ao rascunho de trabalho. Se você não precisar mais de um agente, poderá excluí-lo.

Tópicos

• Exibir informações sobre um agente
• Editar um agente
• Excluir um agente
• Gerencie os grupos de ação de um agente
• Gerencie associações de bases de conhecimento entre agentes
• Gerenciar a memória do agente

Exibir informações sobre um agente

Para saber como visualizar informações sobre um agente, selecione a guia correspondente ao seu método de escolha e siga as etapas.

Console

Para ver informações sobre um agente

1. Faça login na função AWS Management Console usando uma função do IAM com as 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. Na página de detalhes do agente, você pode ver as configurações que se aplicam a todas as versões do agente, tags associadas e suas versões e aliases.

4. Para ver detalhes sobre o rascunho de trabalho do agente, escolha Editar no Agent Builder.

API

Para obter informações sobre um agente, envie uma GetAgentsolicitaçã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 e especifique o. agentId Veja exemplos de código.

Para listar informações sobre seus agentes, envie uma ListAgentssolicitaçã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. Você pode especificar os seguintes parâmetros opcionais:

Campo	Descrição breve
maxResults	O número máximo de resultados a serem retornados em uma resposta.
nextToken	Se houver mais resultados do que o número especificado no maxResults campo, a resposta retornará um nextToken valor. Para ver o próximo lote de resultados, envie o nextToken valor em outra solicitação.

Para listar todas as tags de um agente, envie uma ListTagsForResourcesolicitaçã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 e inclua o Amazon Resource Name (ARN) do agente.

Editar um agente

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

Console

Para editar a configuração de um agente ou seus componentes

1. Faça login na função AWS Management Console usando uma função do IAM com as 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

4. Edite as informações existentes na seção Detalhes do agente ou escolha Adicionar, Editar ou Excluir em qualquer uma das outras subseções e modifique conforme necessário. Para editar um grupo de ação ou base de conhecimento, selecione-o na seção respectiva. Para obter mais informações sobre os componentes do agente que você pode editar, consulteCrie um agente no Amazon Bedrock.

   nota

   Se você alterar o modelo base, todos os modelos de prompt que você modificou serão definidos como padrão para esse modelo.

5. Quando terminar de editar as informações, escolha Salvar para permanecer na mesma janela ou Salvar e sair para retornar à página de detalhes do agente. Um banner de sucesso aparece na parte superior. Para aplicar as novas configurações ao seu agente, selecione Preparar na janela de teste.

Para editar as tags associadas a um agente

1. Faça login na função AWS Management Console usando uma função do IAM com as 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 um agente na seção Agentes.

4. Na seção Tags, escolha Gerenciar tags.

5. Para adicionar uma tag, escolha Adicionar nova tag. Em seguida, insira uma chave e, opcionalmente, insira um valor. Para remover uma tag, selecione Remover. Para ter mais informações, consulte Marcar recursos.

6. Quando terminar de editar as tags, escolha Enviar.

API

Para editar um agente, envie uma UpdateAgentsolicitaçã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. Como todos os campos serão substituídos, inclua os campos que você deseja atualizar e os campos que deseja manter iguais. Para obter mais informações sobre campos obrigatórios e opcionais, consulteCrie um agente no Amazon Bedrock.

Para aplicar as alterações ao rascunho de trabalho, envie uma PrepareAgentsolicitaçã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. Inclua o agentId na solicitação. As alterações se aplicam à DRAFT versão para a qual o TSTALIASID alias aponta.

Para adicionar tags a um agente, envie uma TagResourcesolicitaçã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 e inclua o Amazon Resource Name (ARN) do agente. O corpo da solicitação contém um tags campo, que é um objeto contendo um par de valores-chave que você especifica para cada tag.

Para remover tags de um agente, envie uma UntagResourcesolicitaçã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 e inclua o Amazon Resource Name (ARN) do agente. O parâmetro de tagKeys solicitação é uma lista contendo as chaves das tags que você deseja remover.

Excluir um agente

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

Console

Para excluir um agente

1. Faça login na função AWS Management Console usando uma função do IAM com as 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. Para excluir um agente, escolha o botão de opção ao lado do agente que você deseja excluir.

4. Uma caixa de diálogo aparece avisando sobre as consequências da exclusão. Para confirmar que você deseja excluir o agente, insira o delete campo de entrada e selecione Excluir.

5. Quando a exclusão for concluída, um banner de sucesso será exibido.

API

Para excluir um agente, envie uma DeleteAgentsolicitaçã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 e especifique o. agentId

Por padrão, o skipResourceInUseCheck parâmetro é false e a exclusão é interrompida se o recurso estiver em uso. Se você skipResourceInUseCheck definir comotrue, o recurso será excluído mesmo que esteja em uso.

Veja exemplos de código

Selecione um tópico para aprender sobre como gerenciar os grupos de ação ou as bases de conhecimento de um agente.

Tópicos

• Gerencie os grupos de ação de um agente
• Gerencie associações de bases de conhecimento entre agentes
• Gerenciar a memória do agente