View a markdown version of this page

Conditions préalables - Base rocheuse de l'Amazonie AgentCore
ConfigurationAWS informations d'identification et autorisationsExigences relatives au SDK et à la CLI

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Conditions préalables

Avant de pouvoir exécuter des évaluations par lots, assurez-vous que les éléments suivants sont en place.

Configuration

Configurez les éléments suivants avant d'exécuter des évaluations par lots :

  • Un agent créé à l'aide d'un framework et d'une bibliothèque d'instruments pris en charge. Pour plus d'informations sur les frameworks et les bibliothèques d'instrumentation pris en charge, consultez Frameworks d'agents pris en charge.

  • Un agent déployé sur AgentCore Runtime avec l'observabilité activée, ou un agent construit avec un framework pris en charge configuré avec AgentCore Observability, y compris Transaction Search. Pour plus d'informations sur la configuration de la télémétrie, voir Configuration et livraison de la télémétrie.

  • Un agent invoqué avec des données de télémétrie dans CloudWatch Logs. Attendez 2 à 5 minutes pour CloudWatch ingérer la télémétrie avant de commencer une évaluation par lots.

AWS informations d'identification et autorisations

L'évaluation par lots s'exécute sous les informations d'identification de l'appelant. Contrairement à l'évaluation en ligne, l'évaluation par lots ne nécessite pas de rôle d'exécution de service distinct. Le service utilise votre identité IAM pour accéder aux CloudWatch journaux afin de découvrir les sessions et de rédiger les résultats des évaluations.

AWS informations d'identification configurées avec des autorisations pour les services suivants :

  • bedrock-agentcore— pour démarrer, obtenir, répertorier, arrêter et supprimer des évaluations par lots

  • logs(CloudWatch Logs) — pour lire les périodes de session et écrire les résultats des évaluations

Autorisations IAM requises

La politique IAM suivante accorde les autorisations minimales nécessaires pour exécuter des évaluations par lots :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:StartBatchEvaluation",
                "bedrock-agentcore:GetBatchEvaluation",
                "bedrock-agentcore:ListBatchEvaluations",
                "bedrock-agentcore:StopBatchEvaluation",
                "bedrock-agentcore:DeleteBatchEvaluation"
            ],
            "Resource": "arn:aws:bedrock-agentcore:*:*:batch-evaluate/*"
        },
        {
            "Sid": "ReadAgentLogs",
            "Effect": "Allow",
            "Action": [
                "logs:GetLogEvents",
                "logs:FilterLogEvents",
                "logs:StartQuery",
                "logs:GetQueryResults"
            ],
            "Resource": [
                "arn:aws:logs:*:*:log-group:/aws/bedrock-agentcore/runtimes/*",
                "arn:aws:logs:*:*:log-group:/aws/bedrock-agentcore/evaluations/*"
            ]
        },
        {
            "Sid": "DescribeLogGroups",
            "Effect": "Allow",
            "Action": "logs:DescribeLogGroups",
            "Resource": "*"
        },
        {
            "Sid": "WriteEvaluationLogs",
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup",
                "logs:CreateLogStream",
                "logs:PutLogEvents",
                "logs:PutRetentionPolicy"
            ],
            "Resource": [
                "arn:aws:logs:*:*:log-group:/aws/bedrock-agentcore/evaluations/*",
                "arn:aws:logs:*:*:log-group:/aws/bedrock-agentcore/evaluations/*:*"
            ]
        },
        {
            "Sid": "BedrockInvokeForCustomEvaluators",
            "Effect": "Allow",
            "Action": [
                "bedrock:InvokeModel",
                "bedrock:InvokeModelWithResponseStream"
            ],
            "Resource": [
                "arn:aws:bedrock:*::foundation-model/*",
                "arn:aws:bedrock:*:*:inference-profile/*"
            ]
        }
    ]
}
Note

L'BedrockInvokeForCustomEvaluatorsinstruction n'est requise que si vous utilisez un évaluateur personnalisé qui invoque les modèles Amazon Bedrock. Vous pouvez l'omettre si vous utilisez uniquement des évaluateurs intégrés.

Note

L'WriteEvaluationLogsinstruction permet au service de créer le groupe de journaux et les flux de journaux des résultats d'évaluation et d'écrire les résultats sous vos informations d'identification. Vous devez autoriserlogs:DescribeLogGroups, Resource * car cette action ne prend pas en charge les autorisations au niveau des ressources.

Exigences relatives au SDK et à la CLI

  • AWS SDK (boto3) : Python 3.10 ou version ultérieure.

  • AgentCore CLI : exécutez agentcore --version pour vérifier votre version.

Note

La surface CLI d'évaluation par lots comprend les commandes suivantes :

  • agentcore run batch-evaluation— démarrer une évaluation par lots

  • agentcore stop batch-evaluation -i <id>— arrête une évaluation par lots en cours

  • agentcore view batch-evaluation [id]et agentcore batch-evaluations history — afficher une offre d'emploi ou répertorier les offres d'emploi

  • agentcore archive batch-evaluation -i <id>— archivez un dossier d'évaluation par lots sur le service et effacez l'historique local

L'action bedrock-agentcore:DeleteBatchEvaluation IAM est soutenue par la archive batch-evaluation commande de la CLI ; il n'existe pas de verbe delete CLI littéral.