SuperAPI AI 工具集

ar-guardrail-deployer

安全与审计

查看项目

更新于 10-15 19:58

技能介绍

用途:把 Amazon Bedrock 自动推理(AR)策略部署到运行时防护栏。部署分两步:先将测试过的 DRAFT 快照为不可变的编号版本,再将该版本挂载到 Guardrail(新建或更新),并配置所需的跨区域 Guardrail 配置文件。之后更新 DRAFT 不会影响已固定到编号版本的 Guardrail。

主要能力:create_version.py 负责快照 DRAFT 为编号版本,并处理 CreateAutomatedReasoningPolicyVersion 所需的 definitionHash(并发令牌,从 get/create/update 响应获取);deploy_guardrail.py 按名称查找 Guardrail 并创建或更新(幂等),再创建 Guardrail 版本,返回 guardrail id 与版本号,供 ar-runtime-validator 使用。脚本会依据策略 ARN 的账户与区域推导跨区域配置文件 ARN。

使用方式: uv run scripts/create_version.py --policy-arn <ARN> uv run scripts/deploy_guardrail.py --policy-arn <ARN> --policy-version 1 --guardrail-name my-ar-guardrail --confidence 1.0

要点与限制:生产环境应将 Guardrail 固定到编号版本而非 DRAFT;AR Guardrail 需要 crossRegionConfig(如 us.guardrail.v1:0);每个 Guardrail 最多挂载 2 个 AR 策略;默认 confidenceThreshold 为 1.0(最严格),仅在经过测试且有理由时降低;部署属于对外变更,覆盖前应先确认现有 Guardrail 当前指向的版本。部署完成后可交由 ar-runtime-validator,用 ApplyGuardrail/Converse 针对新的 guardrail id 与版本校验 LLM 输出。