Crie uma avaliação on-line
A CreateOnlineEvaluationConfig API cria uma nova configuração de avaliação on-line que monitora continuamente o desempenho do seu agente usando tráfego ao vivo. Essa operação assíncrona configura o serviço para avaliar os rastreamentos do agente à medida que eles são gerados durante a operação normal.
Ao criar uma avaliação on-line, você especifica um nome de configuração exclusivo, a fonte de dados a ser monitorada (uma lista de grupos de CloudWatch registros ou um endpoint do agente) e uma lista de avaliadores a serem aplicados (até 10, combinando avaliadores integrados e personalizados). Você também fornece um ARN da função de serviço do IAM para execução. O enableOnCreate parâmetro é obrigatório e determina se a avaliação começa a ser executada imediatamente após a criação (executionStatus= true) ou permanece desativada até ser explicitamente ativada (executionStatus= false).
Tópicos
Controle do status de execução
O executionStatus parâmetro determina se o trabalho de avaliação processa ativamente os rastreamentos:
-
HABILITADO — O trabalho de avaliação é executado continuamente, processando rastreamentos recebidos e gerando resultados de avaliação.
-
DESATIVADO — A configuração de avaliação existe, mas o trabalho está pausado. Nenhum traço é processado ou avaliado.
Você pode controlar o status da execução usando a CLI:
# Pause a running online evaluation agentcore pause online-eval "your_config_name" # Resume a paused online evaluation agentcore resume online-eval "your_config_name"
Proteção do avaliador
Quando você cria uma configuração de avaliação com executionStatus definido comoENABLED, o sistema bloqueia automaticamente todos os avaliadores personalizados que você selecionou. Uma vez bloqueado:
-
Nenhuma modificação permitida — Você não pode atualizar a configuração, as solicitações ou as configurações do avaliador. Clone um novo avaliador se precisar fazer alterações.
-
Nenhuma exclusão permitida — Você não pode excluir o avaliador enquanto qualquer trabalho de avaliação o estiver usando (em execução).
Exemplos de código para AgentCore CLI, AgentCore SDK e AWS SDK
Os exemplos de código a seguir demonstram como criar configurações de avaliação on-line usando diferentes abordagens de desenvolvimento. Escolha o método mais adequado ao seu ambiente de desenvolvimento e às suas preferências.
exemplo
Console
Você pode criar configurações de avaliação on-line usando a interface visual do AgentCore console Amazon Bedrock. Esse método fornece formulários guiados e validação para ajudá-lo a definir suas configurações de avaliação.
Para criar uma avaliação AgentCore on-line
-
Abra o AgentCore console Amazon Bedrock.
-
No painel de navegação esquerdo, escolha Avaliação.
-
Escolha Criar configuração de avaliação.
-
(Opcional) Em Nome da avaliação, insira um nome para a configuração da avaliação on-line.
-
(Opcional) Para ativar a configuração da avaliação após sua criação, marque a caixa de seleção abaixo do nome da avaliação.
-
(Opcional) Em Descrição da configuração de avaliação, insira uma descrição para a configuração de AgentCore avaliação.
-
(Opcional) Em Tempo limite de inatividade da sessão, insira uma duração entre 1 e 60 minutos. O padrão é 15 minutos.
-
-
Em Fonte de dados, escolha uma das seguintes opções:
-
Defina com um endpoint de agente — Escolha um agente que você criou anteriormente no AgentCore Runtime ou crie um novo agente escolhendo Agentes. Em seguida, escolha um endpoint do agente.
-
Selecione um grupo de CloudWatch registros — Selecione até 5 grupos de registros. Insira o nome do serviço usado pelo seu agente para fins de observabilidade. Para agentes hospedados no AgentCore Runtime, o nome do serviço segue o formato<agent-runtime-name>. <agent-runtime-endpoint-name>. Para agentes executados fora do AgentCore Runtime, o nome do serviço é configurado na variável de ambiente OTEL_RESOURCE_ATTRIBUTES.
-
-
Para avaliadores, selecione até 10 avaliadores por configuração de avaliação, incluindo avaliadores integrados e personalizados.
-
(Opcional) Para Filtros, adicione até 5 filtros para identificar quais sessões avaliar.
-
(Opcional) Para Amostragem, escolha uma porcentagem entre 0,01% e 100% para controlar a porcentagem de sessões que são avaliadas. O padrão é 10%.
-
Para a função Amazon Bedrock IAM, escolha uma das seguintes opções:
-
Use uma função existente — Selecione uma função de serviço do IAM que já tenha as permissões necessárias.
-
Crie uma nova função — Crie uma nova função de serviço do IAM.
-
-
Escolha Criar configuração de avaliação para criar a configuração de avaliação AgentCore on-line.