As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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 instrui o serviço a avaliar os rastreamentos do agente à medida que são gerados durante a operação normal.
Para criar uma avaliação on-line, forneça um nome de configuração exclusivo, escolha o que monitorar, selecione até 10 avaliadores e forneça um ARN da função de serviço IAM para execução. A fonte de dados pode ser CloudWatch Logs, selecionados por nomes exatos de grupos de logs ou prefixos de nomes de grupos de logs, ou um endpoint de agente. O enableOnCreate parâmetro necessário controla a inicialexecutionStatus: true inicia a configuração em ENABLED e false a inicia emDISABLED.
Tópicos
Controle do status de execução
O executionStatus parâmetro determina se o trabalho de avaliação processa ativamente os rastreamentos:
-
ATIVADO — O trabalho de avaliação é executado continuamente, processando os rastreamentos recebidos e gerando resultados de avaliação.
-
DESATIVADO — A configuração de avaliação existe, mas o trabalho está pausado. Nenhum rastreamento é processado ou avaliado.
Você pode controlar o status de 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"
Selecionar grupos de registros de entrada
Se sua fonte de dados for CloudWatch Logs, configure dataSourceConfig.cloudWatchLogs exatamente de uma das seguintes formas:
-
logGroupNames— Forneça uma lista explícita de nomes de grupos de registros. -
logGroupNamePrefixes— Forneça de 1 a 5 prefixos de nomes de grupos de registros. O serviço avalia rastreamentos de qualquer grupo de registros cujo nome comece com um desses prefixos, incluindo grupos de registros correspondentes criados posteriormente.
Em ambos os casos, defina serviceNames para que o serviço possa identificar os rastros do seu agente nos grupos de registros selecionados.
Se você usa logGroupNamePrefixes para combinar grupos de logs do Amazon Bedrock AgentCore Runtime, certifique-se de que seu tempo de execução envie períodos para o próprio grupo de logs do agente. Para agentes que ainda usam o grupo de aws/spans log compartilhado, UNIFIED_TRACES_DESTINATION_ENABLED=true defina o tempo de execução. Para obter mais informações, consulte Destino de Span para agentes hospedados no tempo de AgentCore execução do Amazon Bedrock.
# Match input log groups by prefix instead of exact names dataSourceConfig={ "cloudWatchLogs": { "logGroupNamePrefixes": ["/aws/agentcore/my-agent-"], "serviceNames": ["my_agent.DEFAULT"] } }
Para obter mais informações sobre onde os resultados e as métricas de pontuação são gravados, incluindo grupos de registros dedicados, personalizados e de origem, consulte Resultados e saída.
Proteção do avaliador
Quando você cria uma configuração de avaliação com executionStatus set toENABLED, 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, os prompts 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).
Amostras 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 que melhor se adapta 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 de 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.
-
Selecionar um grupo de CloudWatch registros — Selecione até 5 grupos de registros. Insira o nome do serviço usado pelo seu agente para fins de observação. 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) Em 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:
nota
Se o gerente de funções estiver habilitado em sua conta, AgentCore anexará a função para você e a etapa de seleção de função descrita aqui será substituída por uma opção Personalizar. Para usar um perfil diferente, escolha Personalizar. Para saber mais informações, consulte Criação do perfil do IAM no Guia do usuário do IAM.
-
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.