View a markdown version of this page

Obtenha uma avaliação on-line - Amazon Bedrock AgentCore

Obtenha uma avaliação on-line

A GetOnlineEvaluationConfig API recupera os detalhes completos e o status atual de uma configuração de avaliação on-line existente. Essa operação síncrona retorna a configuração completa, incluindo fontes de dados, avaliadores, status de execução e metadados operacionais.

Use essa API para monitorar o status do ciclo de vida da configuração (ACTIVE,,,CREATING,CREATE_FAILED, ouERROR) UPDATING UPDATE_FAILEDDELETING, verificar o status de execução atual (ENABLEDouDISABLED) e recuperar todos os parâmetros de configuração, incluindo listas de avaliadores, configurações da fonte de dados e destinos de saída.

Status do ciclo de vida

O status campo em uma configuração de avaliação on-line relata seu estado do ciclo de vida, que é separado do executionStatus campo que controla se o trabalho de avaliação está processando rastreamentos ativamente.

  • ACTIVE— A configuração está totalmente provisionada e pronta para uso.

  • CREATING— A configuração está sendo provisionada. Aguarde a transição para ACTIVE antes de atualizar ou excluir.

  • CREATE_FAILED— A criação não foi concluída com sucesso. Você não pode atualizar uma configuração nesse estado; chame DeleteOnlineEvaluationConfig para removê-la e, em seguida, crie uma nova.

  • UPDATING— Uma atualização está em andamento. Aguarde a conclusão da operação antes de fazer alterações adicionais.

  • UPDATE_FAILED— A atualização mais recente não se aplica. Você pode tentar novamente ligando UpdateOnlineEvaluationConfig novamente ou remover a configuração comDeleteOnlineEvaluationConfig.

  • DELETING— A configuração está sendo removida.

  • ERROR— Ocorreu um problema que requer sua ação. Verifique o failureReason campo para identificar o problema. As causas comuns incluem acesso insuficiente à função do IAM, falta de permissões de grupos de registros e quotas de serviço excedidas. Depois de corrigir o problema, ligue UpdateOnlineEvaluationConfig para tentar novamente ou DeleteOnlineEvaluationConfig remover a configuração.

Exemplos de código para AgentCore SDK e AWS SDK

Os exemplos de código a seguir demonstram como obter detalhes da configuração da 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 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}") config_details = eval_client.get_online_config(config_id) # Display configuration details print(f"Config Name: {config_details['onlineEvaluationConfigName']}") print(f"Config ID: {config_details['onlineEvaluationConfigId']}") print(f"Status: {config_details['status']}")
AWS SDK
  1. import boto3 client = boto3.client('bedrock-agentcore-control') response = client.get_online_evaluation_config( onlineEvaluationConfigId='your_config_id' )
AWS CLI
  1. aws bedrock-agentcore-control get-online-evaluation-config \ --online-evaluation-config-id your_config_id

Console

Você pode ver informações detalhadas sobre uma configuração específica de avaliação on-line por meio da interface do console.

Para obter detalhes da configuração da 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. Para visualizar as informações de uma configuração de avaliação específica, escolha o nome da configuração para ver seus detalhes.