View a markdown version of this page

Atualizar avaliação on-line - Amazon Bedrock AgentCore
Controle de execuçãoExemplos de código para AgentCore CLI, AgentCore SDK e AWS SDKConsole

Atualizar avaliação on-line

A UpdateOnlineEvaluationConfig API modifica uma configuração de avaliação on-line existente, permitindo que você altere avaliadores, fontes de dados, configurações de execução e outros parâmetros. Essa operação lida com atualizações de forma inteligente, sem interromper a execução das avaliações.

As atualizações só podem ser feitas quando sua configuração de avaliação está ativa ou em ACTIVE ERROR status. UPDATE_FAILED Se a configuração estiver sendo criada, atualizada ou excluída, você receberá um erro de conflito e deverá tentar novamente após a conclusão da operação.

Controle de execução

O parâmetro de status de execução controla se sua configuração de avaliação on-line processa ativamente os rastreamentos do agente. Compreender esses estados ajuda você a gerenciar os custos e o desempenho da avaliação.

  • Habilitando a avaliação — Ao mudar de DISABLED para ENABLED, o sistema provisiona o serviço para começar a processar rastreamentos de suas fontes de dados especificadas.

  • Desabilitando a avaliação — Ao mudar de ENABLED para DISABLED, o sistema interrompe o processamento de novos rastreamentos e preserva sua configuração para uso futuro.

Exemplos de código para AgentCore CLI, AgentCore SDK e AWS SDK

Os exemplos de código a seguir demonstram como atualizar as configurações de avaliação on-line 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 uma configuração de avaliação on-line com a AgentCore CLI, edite a configuração diretamente em seu agentcore.json arquivo e reimplante:

    agentcore deploy

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

    # Pause a running online evaluation
agentcore pause online-eval "your_config_name"

# Resume a paused online evaluation
agentcore resume online-eval "your_config_name"
    nota

    A configuração deve estar emACTIVE,UPDATE_FAILED, ou o status ERROR do ciclo de vida antes que você possa atualizá-la.

    nota

    Para controlar se o trabalho de avaliação está sendo executado (ENABLED/DISABLED), use agentcore pause online-eval agentcore resume online-eval e.

    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

# Initialize the evaluation client
eval_client = Evaluation()
config_id = "config-abc123"
print(f"\nUsing config_id: {config_id}")

# update description
eval_client.update_online_config(
    config_id=config_id,
    description="Updated description for online evaluation"
)
print("✅ Description updated")
AWS SDK

  1. import boto3

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

update_config_response = client.update_online_evaluation_config(
    onlineEvaluationConfigId='your_config_id',
    description="Updated description for online evaluation"
)
AWS CLI

  1. aws bedrock-agentcore-control update-online-evaluation-config \
    --online-evaluation-config-id your_config_id \
    --description "Updated description for online evaluation"

Console

Modifique suas configurações de avaliação on-line usando a interface de edição do console, que fornece validação de formulários e opções de configuração guiada.

Para atualizar uma configuração de avaliação on-line

  1. Abra o AgentCore console Amazon Bedrock.

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

  3. No cartão Configurações de avaliação, visualize a tabela que lista as configurações de avaliação que você criou.

  4. Escolha um dos métodos a seguir para atualizar a configuração:

    • Escolha o nome da configuração da avaliação para ver seus detalhes e, em seguida, escolha Editar no canto superior direito da página de detalhes.

    • Selecione a configuração de avaliação para que ela seja destacada e escolha Editar na parte superior do cartão de configurações de avaliação.

  5. Atualize os campos conforme necessário.

  6. Escolha Atualizar configuração de avaliação para salvar as alterações.