Surveillez les événements Amazon Bedrock sur Amazon EventBridge

Vous pouvez utiliser Amazon EventBridge pour surveiller les événements de changement de statut dans Amazon Bedrock. Avec Amazon EventBridge, vous pouvez configurer Amazon SageMaker pour qu'il réponde automatiquement à un changement de statut de tâche lié à la personnalisation d'un modèle dans Amazon Bedrock. Les événements d'Amazon Bedrock sont transmis à Amazon EventBridge quasiment en temps réel. Vous pouvez écrire des règles simples pour automatiser les actions lorsqu’un événement correspond à une règle. Si vous utilisez Amazon EventBridge avec Amazon Bedrock, vous pouvez :

• Publier des notifications chaque fois qu’un événement de changement de statut survient dans la personnalisation du modèle que vous avez déclenchée, et ce que vous ajoutiez ou non de nouveaux flux de travail asynchrones à l’avenir. L’événement publié doit vous fournir suffisamment d’informations pour réagir aux événements dans les flux de travail en aval.

• Fournissez des mises à jour sur l'état des tâches sans appeler l' GetModelCustomizationJob API, ce qui peut impliquer de gérer les problèmes de limite de débit des API, de mettre à jour les API et de réduire les ressources de calcul supplémentaires.

La réception d' AWS événements d'Amazon est gratuite EventBridge. Pour plus d'informations sur Amazon EventBridge, consultez Amazon EventBridge

Note

• Amazon Bedrock émet les évènements dans la mesure du possible. Les événements sont transmis à Amazon EventBridge quasiment en temps réel. Avec Amazon EventBridge, vous pouvez créer des règles qui déclenchent des actions programmatiques en réponse à un événement. Par exemple, vous pouvez configurer une règle qui invoque une rubrique SNS pour envoyer une notification par e-mail, ou invoquer une fonction pour effectuer une action. Pour plus d'informations, consultez le guide de EventBridge l'utilisateur Amazon.

• Amazon Bedrock crée un événement chaque fois qu’un changement de statut survient dans une tâche de personnalisation de modèle que vous déclenchez et émet cet événement dans la mesure du possible.

Comment ça marche

Pour recevoir des événements d'Amazon Bedrock, vous devez créer des règles et des objectifs pour faire correspondre, recevoir et gérer les données relatives aux changements d'état via Amazon EventBridge. Amazon EventBridge est un bus d'événements sans serveur qui ingère les événements de changement d'état provenant des AWS services, des partenaires SaaS et des applications clients. Il traite les événements en fonction de règles ou de modèles que vous créez, et achemine ces événements vers une ou plusieurs « cibles » que vous choisissez AWS Lambda, telles qu'Amazon Simple Queue Service et Amazon Simple Notification Service.

Amazon Bedrock publie vos événements via Amazon EventBridge chaque fois que l'état d'une tâche de personnalisation de modèle change. Dans chaque cas, un nouvel événement est créé et envoyé à Amazon EventBridge, qui l'envoie ensuite à votre bus d'événements par défaut. L’événement indique l’état de la tâche de personnalisation qui a changé, ainsi que l’état actuel de la tâche. Lorsqu'Amazon EventBridge reçoit un événement correspondant à une règle que vous avez créée, Amazon l' EventBridge achemine vers la cible que vous avez spécifiée. Lorsque vous créez une règle, vous pouvez configurer ces cibles ainsi que les flux de travail en aval en fonction du contenu de l’événement.

EventBridge schéma

Les champs d'événement suivants du schéma EventBridge d'événement sont spécifiques à Amazon Bedrock.

• jobArn : ARN de la tâche de personnalisation du modèle.

• outputModelArn : ARN du modèle de sortie. Publié une fois la tâche d’entraînement terminée.

• jobStatus : statut actuel de la tâche.

• FailureMessage : message d’échec. Publié en cas d’échec de la tâche d’entraînement.

Exemple d’événement

Voici un exemple d’événement JSON pour une tâche de personnalisation de modèle ayant échoué.

{
    "version": "0", 
    "id": "UUID", 
    "detail-type": "Model Customization Job State Change", 
    "source": "aws.bedrock", 
    "account": "123412341234", 
    "time": "2023-08-11T12:34:56Z", 
    "region": "us-east-1", 
    "resources": [ "arn:aws:bedrock:us-east-1:123412341234:model-customization-job/abcdefghwxyz" ], 
    "detail": { 
        "version": "0.0",
        "jobName": "abcd-wxyz",
        "jobArn": "arn:aws:bedrock:us-east-1:123412341234:model-customization-job/abcdefghwxyz",
        "outputModelName": "dummy-output-model-name",
        "outputModelArn": "arn:aws:bedrock:us-east-1:123412341234:dummy-output-model-name",
        "roleArn": "arn:aws:iam::123412341234:role/JobExecutionRole",
        "jobStatus": "Failed",
        "failureMessage": "Failure Message here.",
        "creationTime": "2023-08-11T10:11:12Z",
        "lastModifiedTime": "2023-08-11T12:34:56Z",
        "endTime": "2023-08-11T12:34:56Z",
        "baseModelArn": "arn:aws:bedrock:us-east-1:123412341234:base-model-name",
        "hyperParameters": {
            "batchSize" : "batchSizeNumberUsed",
            "epochCount": "epochCountNumberUsed",
            "learningRate": "learningRateUsed",
            "learningRateWarmupSteps": "learningRateWarmupStepsUsed"
            },
        "trainingDataConfig": {
            "s3Uri": "s3://bucket/key",
            },
        "validationDataConfig": {
            "s3Uri": "s3://bucket/key",
            },
        "outputDataConfig": {
            "s3Uri": "s3://bucket/key",
            }
    }
}

Règles et cibles

Lorsqu’un événement entrant correspond à une règle que vous avez créée, l’événement est acheminé vers la cible que vous avez spécifiée pour cette règle, et cette cible traite cet événement. Les cibles prennent en charge le format JSON et peuvent inclure AWS des services tels que les instances Amazon EC2, les fonctions Lambda, les flux Kinesis, les tâches Amazon ECS, les Step Functions, les rubriques Amazon SNS et Amazon SQS. Pour recevoir et traiter correctement les événements, vous devez créer des règles et des cibles permettant d’identifier, de recevoir et de gérer correctement les données relatives aux événements. Vous pouvez créer ces règles et cibles via la EventBridge console Amazon ou via le AWS CLI.

Exemple de règle

Cette règle correspond à un modèle d’événement émis par : source [“aws.bedrock”]. La règle capture tous les événements envoyés par Amazon EventBridge dont la source « aws.bedrock » est associée à votre bus d'événements par défaut.

{
    "source": ["aws.bedrock"]
}

Cible

Lorsque vous créez une règle dans Amazon EventBridge, vous devez spécifier une cible à laquelle EventBridge envoie l'événement correspondant à votre modèle de règle. Ces cibles peuvent être un SageMaker pipeline, une fonction Lambda, une rubrique SNS, une file d'attente SQS ou toute autre cible actuellement prise en charge. EventBridge Vous pouvez consulter la EventBridge documentation Amazon pour savoir comment définir des cibles pour les événements. Pour une procédure expliquant comment utiliser Amazon Simple Notification Service comme cible, consultez Création d’une règle pour gérer les événements Amazon Bedrock.

Création d’une règle pour gérer les événements Amazon Bedrock

Suivez les procédures ci-dessous afin de recevoir des notifications par e-mail concernant les événements Amazon Bedrock.

Création d’une rubrique Amazon Simple Notification Service

1. Ouvrez la console Amazon SNS à partir de l’adresse https://console.aws.amazon.com/sns/v3/home.

2. Dans le volet de navigation, choisissez Rubriques.

3. Choisissez Créer une rubrique.

4. Pour Type, choisissez Standard.

5. Pour Nom, saisissez un nom pour votre rubrique.

6. Choisissez Créer une rubrique.

7. Choisissez Créer un abonnement.

8. Pour Protocole, choisissez E-mail.

9. Pour Point de terminaison, saisissez l’adresse e-mail qui reçoit les notifications.

10. Choisissez Créer un abonnement.

11. Vous recevrez un e-mail avec l’objet suivant : AWS Notification - Subscription Confirmation. Suivez les instructions pour confirmer votre abonnement.

Utilisez la procédure suivante pour créer une règle afin de gérer les événements Amazon Bedrock.

Pour créer une règle permettant de gérer les événements Amazon Bedrock

1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

2. Choisissez Créer une règle.

3. Pour Nom, saisissez un nom pour votre règle.

4. Pour Type de règle, choisissez Règle avec un modèle d’événement.

5. Choisissez Suivant.

6. Pour Modèle d’événement, procédez comme suit :

   1. Pour Source de l’événement, choisissez Services AWS.

   2. Pour Service AWS, choisissez Amazon Bedrock.

   3. Pour Type d’événement, choisissez Modification de l’état de la tâche de personnalisation du modèle.

   4. Par défaut, nous envoyons des notifications pour chaque événement. Si vous préférez, vous pouvez créer un modèle d’événements qui filtre les événements pour un état de tâche spécifique.

   5. Choisissez Suivant.

7. Spécifiez une cible comme suit :

   1. Pour Types de cibles, choisissez Service AWS.

   2. Pour Sélectionner une cible, choisissez Rubrique SNS.

   3. Pour Rubrique, choisissez la rubriques SNS que vous avez créée pour les notifications.

   4. Choisissez Suivant.

8. (Facultatif) Ajoutez des identifications à votre règle.

9. Choisissez Suivant.

10. Choisissez Créer une règle.