View a markdown version of this page

Atualizar avaliador - Amazon Bedrock AgentCore
Exemplos de código para AgentCore SDK e AWS SDKConsole

Atualizar avaliador

A UpdateEvaluator API modifica a configuração, a descrição ou o nível de avaliação de um avaliador personalizado existente. Essa operação assíncrona só é permitida em avaliadores desbloqueados.

Proteção de bloqueio de modificação: atualizações não são permitidas se o avaliador tiver sido usado por qualquer configuração de avaliação ativada.

A API retorna imediatamente com metadados atualizados. Monitore o status do avaliador para confirmar se as alterações foram aplicadas com sucesso usando a GetEvaluator API.

Exemplos de código para AgentCore SDK e AWS SDK

Os exemplos de código a seguir demonstram como atualizar os avaliadores usando diferentes abordagens de desenvolvimento. Escolha o método que melhor se adapta ao seu ambiente de desenvolvimento e às suas preferências.

exemplo
AgentCore CLI

  1. Para atualizar um avaliador com a AgentCore CLI, edite a configuração do avaliador diretamente em agentcore.json seu arquivo e reimplante:

    agentcore deploy

    Abraagentcore.json, encontre o avaliador na evaluators matriz, modifique sua configuração e executeagentcore deploy. As alterações não entrarão em vigor até que você seja implantado.

    nota

    Se o avaliador estiver bloqueado por uma avaliação on-line em execução, você deverá primeiro pausar a avaliação on-line agentcore pause online-eval antes de fazer alterações ou, em vez disso, clonar o avaliador. Depois de implantar suas alterações, retome a avaliação on-line comagentcore resume online-eval.

    nota

    Execute isso de dentro de um diretório de AgentCore projeto (criado comagentcore create).

AgentCore SDK

  1. from bedrock_agentcore_starter_toolkit import Evaluation

eval_client = Evaluation()

eval_client.update_evaluator(
        evaluator_id=evaluator_id,
        description="Updated custom evaluator description"
    )
AWS SDK

  1. import boto3

client = boto3.client('bedrock-agentcore-control')

list_configs_response = client.update_evaluator(
    evaluatorId=evaluator_id,
    description="Updated custom evaluator description"
)
AWS CLI

  1. aws bedrock-agentcore-control update-evaluator \
    --evaluator-id 'evaluator-abc123' \
    --description "Updated custom evaluator description"

Console

Modifique as configurações personalizadas do avaliador usando a interface de edição do console, que fornece validação de formulários e opções de configuração guiada.

Para atualizar um avaliador personalizado

  1. Abra o AgentCore console Amazon Bedrock.

  2. No painel de navegação, escolha Avaliação.

  3. Escolha Avaliadores personalizados ao lado de Configurações de avaliação.

  4. No cartão de avaliadores personalizados, veja a tabela que lista os avaliadores personalizados que você criou.

  5. Escolha um dos métodos a seguir para atualizar o avaliador personalizado:

    • Escolha o nome personalizado do avaliador para ver seus detalhes e, em seguida, escolha Editar no canto superior direito da página de detalhes.

    • Selecione o avaliador personalizado para que ele seja destacado e escolha Editar na parte superior do cartão de avaliadores personalizados.

      nota

      Se o avaliador estiver em uso em alguma avaliação on-line, ela não poderá ser atualizada. Em vez disso, você pode duplicar o avaliador e atualizar a versão clonada.

  6. Atualize os campos conforme necessário.

  7. Escolha Atualizar avaliador para salvar as alterações.