Prérequis

Choisissez le modèle de base que vous souhaitez utiliser pour configurer votre agent en ligne, la région dans laquelle vous souhaitez appeler l'agent et une instruction indiquant à l'agent en ligne ce qu'il doit faire.

Créez ou préparez une ou plusieurs des propriétés d'agent Amazon Bedrock suivantes que vous souhaitez utiliser pour votre agent en ligne.

Créez un rôle AWS Identity and Access Management (IAM) et associez la politique mentionnée dans cette étape au rôle.

Avant de pouvoir invoquer un agent en ligne, vous devez créer un rôle IAM qui fournit les autorisations nécessaires pour utiliser l'InvokeInlineAgentAPI et accéder à des ressources telles que les fonctions Lambda, les bases de connaissances et les modèles de base.

Créez un rôle de service personnalisé pour votre agent en ligne en suivant les étapes de la section Création d'un rôle pour déléguer des autorisations à un utilisateur IAM. Après avoir créé le rôle IAM, associez la politique suivante au rôle.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "InvokeInlineAgent",
            "Effect": "Allow",
            "Action": "bedrock:InvokeInlineAgent"            
        }
        {
            "Sid": "InvokeFoundationModel",
            "Effect": "Allow",
            "Action": "bedrock:InvokeModel",
            "Resource": "arn:aws:bedrock:${region}::foundation-model/{modelId}"
        },
        {
            "Sid": "S3AccessForKBAndActions",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:GetObjectMetadata"
            ],
            "Resource": "arn:aws:s3:::"
        },
        {
            "Sid": "S3AccessForCodeInterpreter",
            "Effect": "Allow",
            "Action": [
                "s3:GetObjectVersion",
                "s3:GetObjectVersionAttributes",
                "s3:GetObjectAttributes"
            ],
            "Resource": "arn:aws:s3:::bucket/path/to/file"
        },
        {
            "Sid": "KnowledgeBaseAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock:Retrieve",
                "bedrock:RetrieveAndGenerate"
            ],
            "Resource": "arn:aws:bedrock:${region}:${account-id}:knowledge-base/knowledge-base-id"
        },
        {
            "Sid": "GuardrailAccess",
            "Effect": "Allow",
            "Action": "bedrock:ApplyGuardrail",
            "Resource": "arn:aws:bedrock:${region}:${account-id}:guardrail/${guardrail-id}"
        },
        {
            "Sid": "LambdaInvoke",
            "Effect": "Allow",
            "Action": "lambda:InvokeFunction",
            "Resource": "arn:aws:lambda:${region}:${account-id}:function:function-name"
        },
        {
            "Sid": "KMSAccess",
            "Effect": "Allow",
            "Action": [
                "kms:GenerateDataKey*",
                "kms:Decrypt"
            ],
            "Resource": "arn:aws:kms:${region}:${account-id}:key/${key-id}"
        }
    ]
}