Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Terapkan kebijakan Penalaran Otomatis Anda di aplikasi Anda
<a name="deploy-automated-reasoning-policy"></a>

Setelah menguji kebijakan Penalaran Otomatis dan puas dengan kinerjanya, Anda dapat menerapkannya untuk digunakan di aplikasi Anda dengan Amazon Bedrock Guardrails. Halaman ini mencakup alur kerja penerapan lengkap: menyimpan versi yang tidak dapat diubah, melampirkannya ke pagar pembatas, mengotomatiskan penerapan dengan CloudFormation, dan mengintegrasikan ke dalam pipeline. CI/CD 

## Menyimpan versi kebijakan Penalaran Otomatis
<a name="save-policy-version"></a>

Setelah selesai menguji kebijakan Anda, buat versi yang tidak dapat diubah. Versi yang tidak dapat diubah memastikan bahwa kebijakan yang dilampirkan pada pagar pembatas Anda tidak berubah secara tak terduga saat Anda terus mengedit DRAFT. Setiap versi diidentifikasi dengan nomor versi numerik (1, 2, 3,...) dan tidak dapat dimodifikasi setelah pembuatan.

### Menggunakan konsol
<a name="save-policy-version-console"></a>

1. Di navigasi kiri, pilih Penalaran ** Otomatis**.

1. Pilih kebijakan Penalaran Otomatis yang ingin Anda gunakan dengan aplikasi Anda.

1. Pilih **Simpan sebagai versi baru**. Anda dapat menggunakan versi kebijakan ini dengan pagar pembatas Anda.

### Menggunakan API
<a name="save-policy-version-api"></a>

Gunakan `CreateAutomatedReasoningPolicyVersion` API untuk membuat versi kebijakan Penalaran Otomatis yang tidak dapat diubah.

#### Permintaan parameter
<a name="save-policy-version-api-request"></a>

`policyArn`(diperlukan)  
Nama Sumber Daya Amazon (ARN) dari kebijakan Penalaran Otomatis untuk membuat versi.

`lastUpdatedDefinitionHash`(diperlukan)  
Hash dari definisi kebijakan untuk versi baru. Ambil hash ini dari `GetAutomatedReasoningPolicy` API. Ini memastikan Anda membuat versi definisi kebijakan yang tepat yang Anda uji.

#### Contoh
<a name="save-policy-version-api-example"></a>

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

Contoh respons:

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

## Tambahkan kebijakan Penalaran Otomatis Anda ke pagar pembatas
<a name="add-policy-to-guardrail"></a>

Setelah Anda memiliki versi kebijakan Penalaran Otomatis yang disimpan, tambahkan ke pagar pembatas. Guardrail adalah komponen runtime yang dipanggil aplikasi Anda untuk memvalidasi respons LLM. Anda dapat menambahkan kebijakan Penalaran Otomatis ke pagar pembatas baru atau yang sudah ada.

### Menggunakan konsol
<a name="add-policy-to-guardrail-console"></a>

1. Di navigasi kiri, pilih ** Guardrails**, lalu pilih ** Buat pagar pembatas ** (atau pilih pagar pembatas yang ada dan pilih Edit). ** **

1. Saat masuk ke ** layar Tambah pemeriksaan ** Penalaran Otomatis, pilih ** Aktifkan kebijakan Penalaran Otomatis**.

1. Untuk Nama ** Kebijakan**, pilih versi yang disimpan dari kebijakan Penalaran Otomatis, lalu pilih Ber ** ikutnya**.

1. Selesaikan pembuatan atau pembaruan pagar pembatas Anda.

### Menggunakan API
<a name="add-policy-to-guardrail-api"></a>

Gunakan `UpdateGuardrail` API `CreateGuardrail` or untuk menambahkan kebijakan Penalaran Otomatis ke pagar pembatas Anda. Sertakan `automatedReasoningConfig` parameter dengan kebijakan berversi ARN.

#### Permintaan parameter
<a name="add-policy-to-guardrail-api-request"></a>

`automatedReasoningConfig`  
Konfigurasi untuk pemeriksaan Penalaran Otomatis di Amazon Bedrock Guardrails.

`policyArn`(diperlukan)  
ARN versi kebijakan Penalaran Otomatis untuk digunakan dengan pagar pembatas Anda. Gunakan ARN berversi (diakhiri dengan`:1`,`:2`, dll.), bukan ARN tanpa versi.

#### Contoh
<a name="add-policy-to-guardrail-api-example"></a>

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

**penting**  
Gunakan kebijakan berversi ARN (misalnya,`arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk:1`). Jika Anda menggunakan ARN tanpa versi, API mengembalikan kesalahan. Buat versi terlebih dahulu menggunakan`CreateAutomatedReasoningPolicyVersion`.

**penting**  
Pagar pembatas yang menggunakan pemeriksaan Penalaran Otomatis memerlukan profil inferensi lintas wilayah. Sertakan `--cross-region-config` parameter dengan `guardrailProfileIdentifier` yang cocok dengan awalan Wilayah Anda (misalnya, `us.guardrail.v1:0` untuk Wilayah AS atau `eu.guardrail.v1:0` untuk Wilayah UE). Jika Anda menghilangkan parameter ini, API mengembalikan a`ValidationException`.

## Mengekspor versi kebijakan untuk penerapan
<a name="export-policy-version"></a>

Untuk menerapkan kebijakan melalui CloudFormation atau CI/CD pipeline, Anda memerlukan definisi kebijakan JSON. Gunakan `ExportAutomatedReasoningPolicyVersion` API untuk mengekspor definisi kebijakan lengkap — termasuk semua aturan, variabel, dan tipe kustom — dari versi yang disimpan.

Definisi yang diekspor adalah format yang sama yang diterima oleh `PolicyDefinition` properti CloudFormation `AWS::Bedrock::AutomatedReasoningPolicy` sumber daya. Hal ini memudahkan untuk memindahkan kebijakan dari alur kerja konsol interaktif ke penerapan otomatis.

```
# 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}}
```

JSON yang diekspor berisi struktur berikut:

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

Simpan file ini dalam kontrol versi bersama CloudFormation template Anda. Saat memperbarui kebijakan, ekspor versi baru dan perbarui file untuk memicu penerapan.

## Mengotomatiskan penerapan dengan CloudFormation
<a name="deploy-cfn"></a>

Gunakan CloudFormation untuk menerapkan kebijakan Penalaran Otomatis dan pagar pembatas sebagai infrastruktur sebagai kode. Sumber `AWS::Bedrock::AutomatedReasoningPolicy` daya membuat kebijakan dengan definisi kebijakan yang Anda ekspor dari API atau konsol. Dikombin `AWS::Bedrock::Guardrail` asikan dengan, Anda dapat menerapkan tumpukan validasi lengkap dalam satu template.

**catatan**  
CloudFormation membuat sumber daya kebijakan dengan definisi kebijakan yang Anda berikan. Itu tidak menjalankan alur kerja build atau mengekstrak aturan dari dokumen sumber. Anda harus terlebih dahulu membuat dan menguji kebijakan secara interaktif (menggunakan konsol, API, atau Kiro CLI), lalu ekspor definisi kebijakan yang telah diuji untuk digunakan di template Anda. Untuk informasi selengkapnya, lihat [Mengekspor versi kebijakan untuk penerapan](#export-policy-version).

Untuk referensi properti lengkap sumber daya kebijakan, lihat [AWS::Bedrock:: AutomatedReasoningPolicy ](AWSCloudFormation/latest/TemplateReference/aws-resource-bedrock-automatedreasoningpolicy.html) di Referensi *CloudFormation Template*.

### Contoh: Menyebarkan kebijakan dan pagar pembatas
<a name="deploy-cfn-template-example"></a>

 CloudFormation Template berikut membuat kebijakan Penalaran Otomatis dengan definisi kebijakan dan pagar pembatas yang mereferensikannya. Ganti definisi kebijakan dengan JSON yang diekspor dari kebijakan yang Anda uji.

```
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
```

**Tip**  
Untuk penerapan produksi, simpan definisi kebijakan dalam file JSON terpisah dan referensikan menggunakan `Fn::Include` atau dengan memuatnya sebagai parameter template. Ini menjaga template Anda tetap bersih dan memudahkan untuk memperbarui definisi kebijakan secara independen.

**penting**  
Pagar pembatas yang menggunakan pemeriksaan Penalaran Otomatis memerlukan profil inferensi lintas wilayah. Pro `CrossRegionConfig` perti menentukan profil pagar pembatas ARN untuk Wilayah Anda. Ganti awalan Wilayah (`us`) dengan awalan yang sesuai untuk Wilayah penerapan Anda (misalnya, `eu` untuk Wilayah UE). Jika Anda menghilangkan properti ini, pembuatan pagar pembatas gagal.

### Contoh: Menyebarkan dengan kunci KMS yang dikelola pelanggan
<a name="deploy-cfn-kms-example"></a>

Untuk mengenkripsi kebijakan Anda dengan kunci KMS yang dikelola pelanggan, tambahkan `KmsKeyId` properti. Anda juga harus mengonfigurasi kebijakan kunci untuk mengizinkan Amazon Bedrock menggunakan kunci tersebut. Untuk izin kebijakan utama yang diperlukan, lihat[Izin KMS untuk kebijakan Penalaran Otomatis](create-automated-reasoning-policy.md#automated-reasoning-policy-kms-permissions).

```
  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
```

**penting**  
Mengubah `KmsKeyId` properti membutuhkan penggantian sumber daya. CloudFormation akan menghapus kebijakan yang ada dan membuat yang baru dengan ARN baru. Perbarui pagar pembatas yang mereferensikan kebijakan lama ARN.

## Langkah selanjutnya
<a name="deploy-next-steps"></a>

Setelah menerapkan kebijakan dan pagar pembatas Anda, integrasikan pemeriksaan Penalaran Otomatis ke dalam aplikasi Anda untuk memvalidasi respons LLM saat runtime. Lihat informasi yang lebih lengkap di [Integrasikan pemeriksaan Penalaran Otomatis dalam aplikasi Anda](integrate-automated-reasoning-checks.md).