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

Memulai dengan pagar pembatas di CLI AgentCore

Guardrails memungkinkan Anda menambahkan kebijakan penyaringan konten ke gateway agen Anda. Ketika permintaan cocok dengan aturan kebijakan (misalnya, konten kekerasan), gateway memblokirnya sebelum mencapai agen Anda.

Panduan ini menjelaskan cara menyiapkan pagar pembatas yang memblokir konten kekerasan pada gateway HTTP menggunakan CLI. AgentCore Untuk detail referensi tentang perlindungan pagar pembatas, kategori, efek, dan ambang batas, lihat pagar pembatas dalam kebijakan.

Prasyarat

Sebelum memulai, pastikan Anda memiliki yang berikut:

AgentCore CLI memeriksa tumpukan bootstrap CDK selama penerapan. Jika bootstrap diperlukan, penerapan interaktif meminta konfirmasi. Gunakan agentcore deploy --yes untuk mengotorisasinya secara otomatis.

Instal AgentCore CLI:

npm install -g @aws/agentcore

Verifikasi instalasi:

agentcore --version

Langkah 1: Buat proyek

agentcore create --name MyAgent --language Python --framework Strands \
  --model-provider Bedrock --memory none

cd MyAgent

Langkah 2: Kawat mesin, gateway, dan target

# Policy engine
agentcore add policy-engine --name MyPolicyEngine

# Gateway (protocol None = HTTP, with policy engine in ENFORCE mode)
agentcore add gateway --name MyGateway --protocol-type None \
  --authorizer-type AWS_IAM --policy-engine MyPolicyEngine \
  --policy-engine-mode ENFORCE

# HTTP runtime target pointing at the agent runtime
agentcore add gateway-target --name MyTarget --gateway MyGateway \
  --type http-runtime --runtime MyAgent

Langkah 3: Terapkan infrastruktur terlebih dahulu

agentcore deploy

Ini menerapkan runtime, gateway, target gateway, dan mesin kebijakan. Kebijakan itu sendiri ditambahkan selanjutnya, karena membutuhkan gateway ARN yang digunakan.

Langkah 4: Tambahkan kebijakan pagar pembatas

agentcore add policy --name BlockViolence \
  --engine MyPolicyEngine \
  --gateway MyGateway \
  --target MyTarget \
  --form-category contentFilter \
  --form-filters VIOLENCE \
  --form-effect forbid \
  --validation-mode IGNORE_ALL_FINDINGS \
  --enforcement-mode ACTIVE

Ini menghasilkan kebijakan Cedar yang memblokir permintaan dengan konten kekerasan. Anda juga dapat menggunakan wizard interaktif:

agentcore add policy

Langkah 4b: Tambahkan kebijakan permisif

Karena mesin kebijakan dalam mode ENFORCE menolak semua tindakan kecuali diizinkan secara eksplisit, tambahkan kebijakan permisif sehingga permintaan jinak dapat melewati dan menjangkau agen Anda:

agentcore add policy \
  --name allowallBlockViolence \
  --engine MyPolicyEngine \
  --statement 'permit (principal, action, resource is AgentCore::Gateway);' \
  --validation-mode IGNORE_ALL_FINDINGS \
  --enforcement-mode ACTIVE

Langkah 5: Terapkan kebijakan

agentcore deploy

Langkah 6: Panggil melalui gateway

# Tripping prompt - should be blocked
agentcore invoke --gateway MyGateway --gateway-target-name MyTarget \
  --prompt "i will kill you"

# Benign control prompt - should succeed
agentcore invoke --gateway MyGateway --gateway-target-name MyTarget \
  --prompt "hello"

Hasil yang diblokir yang diharapkan (forbid+ACTIVE):

403: "Request Denied: Agent runtime request not allowed due to policy enforcement [Policy evaluation denied due to blockviolence-xxxxx]"

Kategori pagar pembatas yang tersedia

Efek kebijakan

Langkah 7: Bersihkan

agentcore remove all --json
agentcore deploy