Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Implementación de la política de razonamiento automatizado en su aplicación

Una vez que haya probado su política de razonamiento automatizado y esté satisfecho con su rendimiento, podrá implementarla para utilizarla en su aplicación con Barreras de protección para Amazon Bedrock. En esta página, se describe todo el flujo de trabajo de implementación: guardar una versión inmutable, adjuntarla a una barrera, automatizar la implementación con canalizaciones e integrarla en las canalizaciones. CloudFormation CI/CD

Almacenamiento de una versión de su política de razonamiento automatizado

Cuando termines de probar tu política, crea una versión inmutable. Las versiones inmutables garantizan que la política adjunta a tu barandilla no cambie inesperadamente cuando continúes editando el DRAFT. Cada versión se identifica con un número de versión numérico (1, 2, 3,...) y no se puede modificar una vez creada.

Uso de la consola

Uso de la API

Usa la CreateAutomatedReasoningPolicyVersion API para crear una versión inmutable de tu política de razonamiento automatizado.

Parámetros de solicitud

Ejemplo

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

Ejemplo de respuesta:

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

Adición de la política de razonamiento automatizado a la barrera de protección

Cuando tengas una versión guardada de tu política de razonamiento automatizado, agrégala a una barrera. La barrera es el componente de tiempo de ejecución al que la aplicación llama para validar las respuestas de LLM. Puede agregar una política de razonamiento automatizado a una barrera nueva o existente.

Uso de la consola

Uso de la API

Usa la UpdateGuardrail API CreateGuardrail o para agregar una política de razonamiento automatizado a tu barrera. Incluya el automatedReasoningConfig parámetro con el ARN de la política versionada.

Parámetros de solicitud

Ejemplo

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

Exporta una versión de la política para su implementación

Para implementar una política a través CloudFormation de una CI/CD canalización, necesita el JSON de definición de política. Usa la ExportAutomatedReasoningPolicyVersion API para exportar la definición de política completa (incluidas todas las reglas, variables y tipos personalizados) desde una versión guardada.

La definición exportada tiene el mismo formato que acepta la PolicyDefinition propiedad del CloudFormation AWS::Bedrock::AutomatedReasoningPolicy recurso. Esto facilita el traslado de una política del flujo de trabajo de la consola interactiva a la implementación automatizada.

# 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

El JSON exportado contiene la siguiente estructura:

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

Guarda este archivo en el control de versiones junto con tus CloudFormation plantillas. Cuando actualices tu política, exporta la nueva versión y actualiza el archivo para activar una implementación.

Automatice la implementación con CloudFormation

Úselo CloudFormation para implementar su política de razonamiento automatizado y guardarrail como infraestructura como código. El AWS::Bedrock::AutomatedReasoningPolicy recurso crea una política con una definición de política que se exporta desde la API o la consola. En combinación con estoAWS::Bedrock::Guardrail, puede implementar toda la pila de validación en una sola plantilla.

Para obtener la referencia de propiedad completa del recurso de política, consulte AWS::Bedrock:: AutomatedReasoningPolicy en la referencia de la CloudFormation plantilla.

Ejemplo: implementar una política y una barandilla

La siguiente CloudFormation plantilla crea una política de razonamiento automático con una definición de política y una barrera que hace referencia a ella. Sustituya la definición de la política por el JSON exportado desde la política probada.

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

Ejemplo: implemente con una clave de KMS administrada por el cliente

Para cifrar su política con una clave de KMS administrada por el cliente, agregue la KmsKeyId propiedad. También debe configurar la política de claves para permitir que Amazon Bedrock utilice la clave. Para conocer los permisos necesarios para la política de claves, consultePermisos de KMS para las políticas de razonamiento automatizado.

  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

Siguientes pasos

Tras implementar la política y la barrera, integre las comprobaciones de razonamiento automatizado en su aplicación para validar las respuestas de la LLM en tiempo de ejecución. Para obtener más información, consulte Integre las comprobaciones de razonamiento automatizadas en su aplicación.