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.

Déploiement de votre politique de raisonnement automatisé dans votre application

Une fois que vous avez testé votre politique de raisonnement automatisé et que vous êtes satisfait de ses performances, vous pouvez la déployer pour l’utiliser dans votre application avec les barrières de protection Amazon Bedrock. Cette page couvre l'ensemble du flux de déploiement : enregistrement d'une version immuable, attachement de celle-ci à un garde-corps, automatisation du déploiement et intégration dans les CloudFormation pipelines. CI/CD

Enregistrement d’une version de votre politique de raisonnement automatisé

Lorsque vous avez fini de tester votre politique, créez une version immuable. Les versions immuables garantissent que la politique associée à votre garde-corps ne change pas de manière inattendue lorsque vous continuez à modifier le BROUILLON. Chaque version est identifiée par un numéro de version numérique (1, 2, 3,...) et ne peut pas être modifiée après sa création.

Utilisation de la console

Utilisation de l’API

Utilisez l'CreateAutomatedReasoningPolicyVersionAPI pour créer une version immuable de votre politique de raisonnement automatique.

Paramètres de demande

Exemple

# Get the current definition hash
aws bedrock get-automated-reasoning-policy \
  --policy-arn "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk" \
  --query "definitionHash" --output text

# Create the version
aws bedrock create-automated-reasoning-policy-version \
  --policy-arn "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk" \
  --last-updated-definition-hash "583463f067a8a4f49fc1206b4642fd40..."

Exemple de réponse :

{
  "policyArn": "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk",
  "version": "1",
  "name": "MyHRPolicy"
}

Ajout de votre politique de raisonnement automatisé à votre barrière de protection

Une fois que vous disposez d'une version enregistrée de votre politique de raisonnement automatique, ajoutez-la à un garde-corps. Le garde-fou est le composant d'exécution que votre application appelle pour valider les réponses LLM. Vous pouvez ajouter une politique de raisonnement automatique à un garde-corps nouveau ou existant.

Utilisation de la console

Utilisation de l’API

Utilisez l'UpdateGuardrailAPI CreateGuardrail or pour ajouter une politique de raisonnement automatique à votre garde-fou. Incluez le automatedReasoningConfig paramètre dans l'ARN de la politique versionnée.

Paramètres de demande

Exemple

aws bedrock create-guardrail \
  --name "HR-Policy-Guardrail" \
  --description "Guardrail for HR policy validation" \
  --automated-reasoning-policy-config policies="arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk:1" \
  --cross-region-config '{"guardrailProfileIdentifier": "us.guardrail.v1:0"}' \
  --blocked-input-messaging "I cannot process this request." \
  --blocked-outputs-messaging "I cannot provide this response."

Exporter une version de politique à des fins de déploiement

Pour déployer une politique via CloudFormation ou un CI/CD pipeline, vous avez besoin de la définition de politique JSON. Utilisez l'ExportAutomatedReasoningPolicyVersionAPI pour exporter la définition complète de la politique, y compris toutes les règles, variables et types personnalisés, à partir d'une version enregistrée.

La définition exportée est au même format que celui accepté par la PolicyDefinition propriété de la CloudFormation AWS::Bedrock::AutomatedReasoningPolicy ressource. Il est ainsi facile de faire passer une politique du flux de travail de la console interactive au déploiement automatique.

# Export the policy definition from version 1
aws bedrock export-automated-reasoning-policy-version \
  --policy-arn "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk:1" \
  --query "policyDefinition" \
  --output json > policy-definition.json

Le JSON exporté contient la structure suivante :

{
  "version": "1.0",
  "variables": [
    {
      "name": "isFullTime",
      "type": "BOOL",
      "description": "Whether the employee works full-time (true) or part-time (false)."
    },
    {
      "name": "tenureMonths",
      "type": "INT",
      "description": "The number of complete months the employee has been continuously employed."
    }
  ],
  "rules": [
    {
      "id": "A1B2C3D4E5F6",
      "expression": "(=> (and isFullTime (> tenureMonths 12)) eligibleForParentalLeave)"
    }
  ],
  "types": []
}

Stockez ce fichier dans le contrôle de version à côté CloudFormation de vos modèles. Lorsque vous mettez à jour votre politique, exportez la nouvelle version et mettez à jour le fichier pour déclencher un déploiement.

Automatisez le déploiement avec CloudFormation

Utilisez-le CloudFormation pour déployer votre politique de raisonnement automatique et votre garde-fou sous forme d'infrastructure en tant que code. La AWS::Bedrock::AutomatedReasoningPolicy ressource crée une politique avec une définition de stratégie que vous exportez depuis l'API ou la console. En combinaison avecAWS::Bedrock::Guardrail, vous pouvez déployer la pile de validation complète dans un modèle unique.

Pour la référence complète des propriétés de la ressource de politique, voir AWS::Bedrock : : AutomatedReasoningPolicy dans la référence du CloudFormation modèle.

Exemple : Déploiement d'une politique et d'un garde-fou

Le CloudFormation modèle suivant crée une politique de raisonnement automatique avec une définition de politique et un garde-fou qui y fait référence. Remplacez la définition de la politique par le JSON exporté à partir de votre politique testée.

AWSTemplateFormatVersion: '2010-09-09'
Description: Deploy an Automated Reasoning policy and guardrail

Parameters:
  PolicyName:
    Type: String
    Default: MyHRPolicy
    Description: Name of the Automated Reasoning policy
  GuardrailName:
    Type: String
    Default: HR-Policy-Guardrail
    Description: Name of the guardrail

Resources:
  AutomatedReasoningPolicy:
    Type: AWS::Bedrock::AutomatedReasoningPolicy
    Properties:
      Name: !Ref PolicyName
      Description: Validates HR chatbot responses about leave eligibility
      PolicyDefinition:
        Version: '1.0'
        Variables:
          - Name: isFullTime
            Type: BOOL
            Description: >-
              Whether the employee works full-time (true) or part-time (false).
              Set to true when users mention being full-time or working 40+ hours
              per week.
          - Name: tenureMonths
            Type: INT
            Description: >-
              The number of complete months the employee has been continuously
              employed. When users mention years of service, convert to months
              (for example, 2 years = 24 months).
          - Name: eligibleForParentalLeave
            Type: BOOL
            Description: >-
              Whether the employee is eligible for parental leave based on
              employment status and tenure.
        Rules:
          - Id: A1B2C3D4E5F6
            Expression: >-
              (=> (and isFullTime (> tenureMonths 12))
              eligibleForParentalLeave)
          - Id: G7H8I9J0K1L2
            Expression: >-
              (=> (or (not isFullTime) (<= tenureMonths 12))
              (not eligibleForParentalLeave))
        Types: []
      Tags:
        - Key: Environment
          Value: Production
        - Key: Team
          Value: HR

  Guardrail:
    Type: AWS::Bedrock::Guardrail
    Properties:
      Name: !Ref GuardrailName
      Description: Guardrail with Automated Reasoning checks for HR policy
      BlockedInputMessaging: I cannot process this request.
      BlockedOutputsMessaging: I cannot provide this response.
      AutomatedReasoningPolicyConfig:
        Policies:
          - !GetAtt AutomatedReasoningPolicy.PolicyArn
      CrossRegionConfig:
        GuardrailProfileArn: !Sub "arn:aws:bedrock:${AWS::Region}:${AWS::AccountId}:guardrail-profile/us.guardrail.v1:0"

Outputs:
  PolicyArn:
    Description: ARN of the Automated Reasoning policy
    Value: !GetAtt AutomatedReasoningPolicy.PolicyArn
  PolicyId:
    Description: ID of the Automated Reasoning policy
    Value: !GetAtt AutomatedReasoningPolicy.PolicyId
  GuardrailId:
    Description: ID of the guardrail
    Value: !Ref Guardrail

Exemple : déploiement à l'aide d'une clé KMS gérée par le client

Pour chiffrer votre politique à l'aide d'une clé KMS gérée par le client, ajoutez la KmsKeyId propriété. Vous devez également configurer la politique de clé pour permettre à Amazon Bedrock d'utiliser la clé. Pour connaître les autorisations de stratégie clés requises, consultezAutorisations KMS pour les politiques de raisonnement automatisé.

  AutomatedReasoningPolicy:
    Type: AWS::Bedrock::AutomatedReasoningPolicy
    Properties:
      Name: !Ref PolicyName
      Description: Validates HR chatbot responses about leave eligibility
      KmsKeyId: !GetAtt PolicyEncryptionKey.Arn
      PolicyDefinition:
        # ... policy definition ...
      Tags:
        - Key: Environment
          Value: Production

Étapes suivantes

Après avoir déployé votre politique et votre garde-fou, intégrez des contrôles de raisonnement automatisés à votre application pour valider les réponses LLM lors de l'exécution. Pour de plus amples informations, veuillez consulter Intégrez des contrôles de raisonnement automatisés dans votre application.