Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Implementieren der Automated-Reasoning-Richtlinie in die Anwendung

Wenn Sie die Automated-Reasoning-Richtlinie getestet haben und mit ihrer Leistung zufrieden sind, können Sie sie für die Verwendung in der Anwendung mit Integritätsschutz für Amazon Bedrock bereitstellen. Auf dieser Seite wird der gesamte Bereitstellungsablauf behandelt: das Speichern einer unveränderlichen Version, das Anhängen an eine Leitplanke, die Automatisierung der Implementierung mit und die Integration in Pipelines. CloudFormation CI/CD

Speichern einer Version der Automated-Reasoning-Richtlinie

Wenn Sie mit dem Testen Ihrer Richtlinie fertig sind, erstellen Sie eine unveränderliche Version. Unveränderliche Versionen stellen sicher, dass sich die an Ihre Leitplanke angehängte Richtlinie nicht unerwartet ändert, wenn Sie den ENTWURF weiter bearbeiten. Jede Version ist durch eine numerische Versionsnummer (1, 2, 3,...) gekennzeichnet und kann nach der Erstellung nicht mehr geändert werden.

Verwenden der Konsole

Verwenden der API

Verwenden Sie die CreateAutomatedReasoningPolicyVersion API, um eine unveränderliche Version Ihrer Automated Reasoning-Richtlinie zu erstellen.

Anforderungsparameter

Beispiel

# 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..."

Beispielantwort:

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

Hinzufügen der Automated-Reasoning-Richtlinie zum Integritätsschutz

Sobald Sie eine gespeicherte Version Ihrer Automated Reasoning-Richtlinie haben, fügen Sie sie einer Leitplanke hinzu. Das Guardrail ist die Laufzeitkomponente, die Ihre Anwendung aufruft, um LLM-Antworten zu validieren. Sie können einer neuen oder vorhandenen Leitplanke eine Richtlinie für automatisiertes Denken hinzufügen.

Verwenden der Konsole

Verwenden der API

Verwenden Sie die CreateGuardrail oder UpdateGuardrail API, um Ihrer Leitplanke eine Automated Reasoning-Richtlinie hinzuzufügen. Fügen Sie den automatedReasoningConfig Parameter dem ARN der versionierten Richtlinie hinzu.

Anforderungsparameter

Beispiel

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."

Exportieren Sie eine Richtlinienversion zur Bereitstellung

Um eine Richtlinie über CloudFormation oder eine CI/CD Pipeline bereitzustellen, benötigen Sie die Richtliniendefinition JSON. Verwenden Sie die ExportAutomatedReasoningPolicyVersion API, um die vollständige Richtliniendefinition — einschließlich aller Regeln, Variablen und benutzerdefinierten Typen — aus einer gespeicherten Version zu exportieren.

Die exportierte Definition hat dasselbe Format, das von der PolicyDefinition Eigenschaft der CloudFormation AWS::Bedrock::AutomatedReasoningPolicy Ressource akzeptiert wird. Dadurch ist es einfach, eine Richtlinie aus dem interaktiven Konsolen-Workflow in die automatische Bereitstellung zu übertragen.

# 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

Das exportierte JSON enthält die folgende Struktur:

{
  "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": []
}

Speichern Sie diese Datei zusammen mit Ihren CloudFormation Vorlagen in der Versionskontrolle. Wenn Sie Ihre Richtlinie aktualisieren, exportieren Sie die neue Version und aktualisieren Sie die Datei, um eine Bereitstellung auszulösen.

Automatisieren Sie die Bereitstellung mit CloudFormation

Verwenden Sie CloudFormation es, um Ihre Automated Reasoning-Richtlinie und die Leitplanke als Infrastruktur in Form von Code bereitzustellen. Die AWS::Bedrock::AutomatedReasoningPolicy Ressource erstellt eine Richtlinie mit einer Richtliniendefinition, die Sie aus der API oder Konsole exportieren. In Kombination mit AWS::Bedrock::Guardrail können Sie den gesamten Validierungsstapel in einer einzigen Vorlage bereitstellen.

Die vollständige Eigenschaftsreferenz der Policy-Ressource finden Sie unter AWS::Bedrock: AutomatedReasoningPolicy in der CloudFormation Vorlagenreferenz.

Beispiel: Stellen Sie eine Richtlinie und eine Leitplanke bereit

Die folgende CloudFormation Vorlage erstellt eine Automated Reasoning-Richtlinie mit einer Richtliniendefinition und einer Leitplanke, die darauf verweist. Ersetzen Sie die Richtliniendefinition durch das JSON, das aus Ihrer getesteten Richtlinie exportiert wurde.

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

Beispiel: Bereitstellung mit einem vom Kunden verwalteten KMS-Schlüssel

Um Ihre Richtlinie mit einem vom Kunden verwalteten KMS-Schlüssel zu verschlüsseln, fügen Sie die KmsKeyId Eigenschaft hinzu. Sie müssen auch die Schlüsselrichtlinie so konfigurieren, dass Amazon Bedrock den Schlüssel verwenden kann. Die erforderlichen Schlüsselrichtlinienberechtigungen finden Sie unterKMS-Berechtigungen für Automated-Reasoning-Richtlinien.

  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

Nächste Schritte

Nachdem Sie Ihre Richtlinie und Ihr Leitplanken implementiert haben, integrieren Sie Automated Reasoning-Checks in Ihre Anwendung, um LLM-Antworten zur Laufzeit zu validieren. Weitere Informationen finden Sie unter Integrieren Sie automatisierte Argumentationsprüfungen in Ihre Anwendung.