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.

Configurer les paramètres de AgentCore cycle de vie d'Amazon Bedrock

Paramètre LifecycleConfiguration d'entrée qui vous CreateAgentRuntime permet de gérer le cycle de vie des sessions d'exécution et des ressources dans Amazon Bedrock AgentCore Runtime. Cette configuration permet d'optimiser l'utilisation des ressources en nettoyant automatiquement les sessions inactives et en empêchant les instances de longue durée de consommer des ressources indéfiniment.

Vous pouvez également configurer les paramètres de cycle de vie d'un AgentCore environnement d'exécution existant avec l'UpdateAgentRuntimeopération.

Attributs de configuration

Contraintes

Comportement par défaut

Lorsqu'il n'LifecycleConfigurationest pas fourni ou qu'il contient des valeurs nulles, la plateforme applique la logique suivante :

Valeurs par défaut

Création d'un AgentCore environnement d'exécution avec configuration du cycle de vie

Vous pouvez spécifier une configuration de cycle de vie lorsque vous créez un AgentCore Runtime.

import boto3

client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

try:
    response = client.create_agent_runtime(
        agentRuntimeName='my_agent_runtime',
        agentRuntimeArtifact={
            'containerConfiguration': {
                'containerUri': '123456789012.dkr.ecr.us-west-2.amazonaws.com/my-agent:latest'
            }
        },
        lifecycleConfiguration={
            'idleRuntimeSessionTimeout': 1800,  # 30 minutes, configurable
            'maxLifetime': 14400  # 4 hours
        },
        networkConfiguration={'networkMode': 'PUBLIC'},
        roleArn='arn:aws:iam::123456789012:role/AgentRuntimeRole'
    )

    print(f"Agent runtime created: {response['agentRuntimeArn']}")
except client.exceptions.ValidationException as e:
    print(f"Validation error: {e}")
except Exception as e:
    print(f"Error creating agent runtime: {e}")

Mettre à jour la configuration du cycle de vie pour un AgentCore environnement d'exécution

Vous pouvez mettre à jour la configuration du cycle de vie pour un AgentCore environnement d'exécution existant.

import boto3

client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

agent_runtime_id = 'my_agent_runtime'

try:
    response = client.update_agent_runtime(
        agentRuntimeId=agent_runtime_id,
        agentRuntimeArtifact={
            'containerConfiguration': {
                'containerUri': '123456789012.dkr.ecr.us-west-2.amazonaws.com/my-agent:latest'
            }
        },
        networkConfiguration={'networkMode': 'PUBLIC'},
        roleArn='arn:aws:iam::123456789012:role/AgentRuntimeRole',
        lifecycleConfiguration={
            'idleRuntimeSessionTimeout': 600,   # 10 minutes
            'maxLifetime': 7200                 # 2 hours
        }
    )

    print("Lifecycle configuration updated successfully")
except client.exceptions.ValidationException as e:
    print(f"Validation error: {e}")
except client.exceptions.ResourceNotFoundException:
    print("Agent runtime not found")
except Exception as e:
    print(f"Error updating configuration: {e}")

Obtenir la configuration du cycle de vie d'un AgentCore environnement d'exécution

Vous pouvez obtenir la configuration du cycle de vie pour un AgentCore environnement d'exécution existant.

import boto3

client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

def get_lifecycle_config():
    try:
        response = client.get_agent_runtime(agentRuntimeId="my_agent_runtime")

        lifecycle_config = response.get('lifecycleConfiguration', {})
        idle_timeout = lifecycle_config.get('idleRuntimeSessionTimeout', 900)
        max_lifetime = lifecycle_config.get('maxLifetime', 28800)

        print(f"Current configuration:")
        print(f"  Idle timeout: {idle_timeout}s ({idle_timeout//60} minutes)")
        print(f"  Max lifetime: {max_lifetime}s ({max_lifetime//3600} hours)")

        return lifecycle_config

    except Exception as e:
        print(f"Error retrieving configuration: {e}")
        return None

# Usage
config = get_lifecycle_config()
print(config)

Validation et contraintes

La configuration du cycle de vie inclut des règles de validation et des contraintes pour éviter les configurations non valides. Si votre demande enfreint l'une des règles suivantes, elle échoue avec un message ValidationException :

Erreurs de validation courantes

import boto3

client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

try:
    client.create_agent_runtime(
        agentRuntimeName='invalid_config_agent',
        agentRuntimeArtifact={
            'containerConfiguration': {
                'containerUri': '123456789012.dkr.ecr.us-west-2.amazonaws.com/my-agent:latest'
            }
        },
        lifecycleConfiguration={
            'idleRuntimeSessionTimeout': 3600,  # 1 hour, configurable
            'maxLifetime': 1800                 # 30 minutes - INVALID!
        },
        networkConfiguration={'networkMode': 'PUBLIC'},
        roleArn='arn:aws:iam::123456789012:role/AgentRuntimeRole',
        )
except client.exceptions.ValidationException as e:
    print(f"Validation failed: {e}")
    # Output: idleRuntimeSessionTimeout must be less than or equal to maxLifetime

Fonction d'aide à la validation

MICROVM_MAX_SECONDS = 28800     # 8 hours
INSTANCES_MAX_SECONDS = 1209600  # 14 days
MIN_SECONDS = 60


def validate_lifecycle_config(idle_timeout, max_lifetime, uses_capacity_provider=False):
    """Validate lifecycle configuration before API call"""
    errors = []

    # The maximum depends on the compute type of the runtime
    maximum = INSTANCES_MAX_SECONDS if uses_capacity_provider else MICROVM_MAX_SECONDS

    # Check range constraints
    if not (MIN_SECONDS <= idle_timeout <= maximum):
        errors.append(f"idleRuntimeSessionTimeout must be between {MIN_SECONDS} and {maximum} seconds")

    if not (MIN_SECONDS <= max_lifetime <= maximum):
        errors.append(f"maxLifetime must be between {MIN_SECONDS} and {maximum} seconds")

    # Check relationship constraint
    if idle_timeout > max_lifetime:
        errors.append(f"idleRuntimeSessionTimeout ({idle_timeout}s) must be <= maxLifetime ({max_lifetime}s)")

    return errors

# Usage
errors = validate_lifecycle_config(3600, 1800)
if errors:
    for error in errors:
        print(f"Validation error: {error}")
else:
    print("Configuration is valid")

Paramètres du cycle de vie et sessions d'exécution

Les paramètres de configuration du cycle de vie que vous définissez sont appliqués à chaque session d'exécution individuelle. Lorsque vous appelez un agent avec une session spécifiqueruntimeSessionId, AgentCore Runtime met en service une microVM dédiée pour cette session. Les délais d'expiration du cycle de vie (idleRuntimeSessionTimeoutetmaxLifetime) régissent le cycle de vie de cette instance de microVM spécifique.

import boto3
import json
import uuid

client = boto3.client('bedrock-agentcore', region_name='us-west-2')

# Each unique runtimeSessionId gets its own microVM with lifecycle settings applied
session_id_user_1 = str(uuid.uuid4())  # User 1's session
session_id_user_2 = str(uuid.uuid4())  # User 2's session

# First invocation for User 1 - creates new microVM with lifecycle timers
response1 = client.invoke_agent_runtime(
    agentRuntimeArn='arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/my-agent',
    runtimeSessionId=session_id_user_1,  # Dedicated microVM for this session
    payload=json.dumps({"prompt": "Hello from User 1"}).encode()
)

# First invocation for User 2 - creates separate microVM with its own lifecycle timers
response2 = client.invoke_agent_runtime(
    agentRuntimeArn='arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/my-agent',
    runtimeSessionId=session_id_user_2,  # Different microVM for this session
    payload=json.dumps({"prompt": "Hello from User 2"}).encode()
)

# Subsequent invocations to same session reuse the existing microVM
# The idle timeout resets with each invocation to the same session
response3 = client.invoke_agent_runtime(
    agentRuntimeArn='arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/my-agent',
    runtimeSessionId=session_id_user_1,  # Reuses User 1's existing microVM
    payload=json.dumps({"prompt": "Follow-up from User 1"}).encode()
)

Points clés concernant les paramètres de cycle de vie et les sessions :

Bonnes pratiques

Suivez ces bonnes pratiques lors de la configuration des paramètres de cycle de vie afin d'optimiser l'utilisation des ressources et l'expérience utilisateur.

Recommandations

Schémas courants