基于 Agent Governance Toolkit 的非洲监管策略包:从 NDPA、POPIA 到 CBN 金融合规的 Rego 落地实战
基于 Agent Governance Toolkit 的非洲监管策略包:从 NDPA、POPIA 到 CBN 金融合规的 Rego 落地实战
导读
本文围绕 examples/policies/african-regulatory/README.md 展开,系统讲解 Agent Governance Toolkit 中面向非洲十国的监管策略包(African Regulatory Policy Pack):它如何以"通用 Agent 安全控制 + 国别监管策略"两层架构,让运行在尼日利亚、肯尼亚、南非、乌干达、坦桑尼亚、埃塞俄比亚、加纳、卢旺达、埃及和毛里求斯的 AI Agent 同时满足数据保护与金融合规要求。读完本文,你将掌握策略包的完整文件清单与 OWASP Agentic AI Top 10 映射关系、如何使用 OPA 运行 Rego 策略与管辖区域路由器(Jurisdiction Router)做多国跨境合规分流、以及如何通过 ACS(Agent Control Specification)清单把策略挂接到 Agent 的输入/输出干预点,最后通过 AgentControl.from_path() 在 Python 运行时中加载执行。
说明:该策略包由社区开源项目
agt-policies-nigeria维护(其 Rego 包名agt_policies_nigeria、agt_policies_africa、agt_policies_agent等均可在仓库源码中确认)。策略包内的监管策略是治理起点模板(governance starter packs),不是经认证的法律合规文书,生产环境部署前必须由具备资质的法律与监管顾问完成独立合规评估。
一、两层架构:通用安全控制 + 国别监管策略
非洲监管策略包采用清晰的两层架构。第一层是适用于所有司法管辖区的通用 Agent 安全控制,第二层是按国家定制的监管策略包:
┌─────────────────────────────────────────────────────────────────────┐
│ Layer 1 — Universal Agent Safety Controls (all jurisdictions) │
│ agent-prompt-injection agent-pii-leakage agent-tool-permissions │
│ agent-human-approval agent-model-routing │
├─────────────────────────────────────────────────────────────────────┤
│ Layer 2 — African Regulatory Packs (jurisdiction-specific) │
│ NG: ndpa-data-residency cbn-transaction-limits bvn-nin-protection│
│ nfiu-aml-str pos-geofencing │
│ KE: kenya-dpa │
│ ZA: popia-south-africa │
│ UG: uganda-dppa │
│ TZ: tanzania-pdpa │
│ ET: ethiopia-pdp │
│ GH: ghana-dpa │
│ RW: rwanda-dpa │
│ EG: egypt-pdpl │
│ MU: mauritius-dpa │
└─────────────────────────────────────────────────────────────────────┘
这一设计的核心价值在于分层复用:通用控制只实现一次,对所有 Agent 生效;国别监管包则按用户所在国动态附加。策略的选择由管辖区域路由器 rego/jurisdiction-router.rego(见 examples/policies/african-regulatory/rego/jurisdiction-router.rego)根据 customer_country 与 transaction_countries 决定——通用策略永远生效,监管包按管辖区域挑选。
从源码看,路由器将"管辖区域 → 策略包 → OPA 查询路径"做成三张权威映射表,并直接输出可直接执行的查询路径:
universal_policies:prompt_injection、pii_leakage、tool_permissions、human_approval、model_routing五个通用包,对所有 Agent 动作恒常生效;jurisdiction_policies:ISO 3166-1 alpha-2 国家码到策略包集合的映射(如"NG": {"cbn", "bvn_nin", "ndpa", "nfiu"}、"ZA": {"popia"}、"GH": {"ghana_dpa"}),除非洲十国外还内置了IN(印度五包)与GB(英国三包),说明路由器是跨洲复用的通用机制;policy_queries:策略包 ID 到data.agt_policies_*.xxx.decision查询路径的权威映射,集成方拿到resolved_queries即可直接执行,无需自行拼路径。
路由器还暴露了 is_supported_jurisdiction 与 unsupported_jurisdiction_warning 两个辅助查询:当 customer_country 不在映射表中时返回警告——"该辖区暂无监管包,但通用 Agent 安全控制仍然生效",保证未知辖区也至少处于基础安全水位之上。
二、策略文件总览:15 个策略包及监管依据
策略包目录下每个 .yaml 文件都是一份原生 ACS 清单,将输入(input)、工具调用(pre_tool_call)、输出(output)干预点绑定到对应的 Rego 包;每个 Rego 包又对应一份监管法规。策略包总计 15 个,分为两组。
2.1 通用 Agent 安全控制(Universal Agent Safety Controls)
| 文件 | 监管依据 | OWASP Agentic AI |
|---|---|---|
agent-prompt-injection.yaml |
OWASP LLM01; NIST AI RMF GOVERN 6.1 | LLM01 / ASI01 |
agent-pii-leakage.yaml |
OWASP LLM06; NDPA 2023 s.24; POPIA s.19 | LLM06 |
agent-tool-permissions.yaml |
OWASP LLM08; NIST AI RMF GOVERN 2.2 | LLM08 |
agent-human-approval.yaml |
OWASP LLM09; CBN Maker-Checker | LLM09 |
agent-model-routing.yaml |
OWASP LLM03/LLM05; NIST AI RMF GOVERN 1.1 | LLM03 / LLM05 |
以 agent-prompt-injection.yaml 为例,清单的骨架如下:
agent_control_specification_version: 0.4.0-alpha.1
metadata:
name: agent-prompt-injection
version: "1.0"
extends: []
policies:
agent_prompt_injection:
type: rego
bundle: rego
intervention_points:
input:
policy_target: $.input.body
policy:
id: agent_prompt_injection
query: data.agt_policies_agent.prompt_injection.acs_input_result
output:
policy_target: $.output.content
policy:
id: agent_prompt_injection
query: data.agt_policies_agent.prompt_injection.acs_output_result
其中 agent_control_specification_version: 0.4.0-alpha.1 是 ACS 规范版本,intervention_points 声明了 input(策略目标为 $.input.body,查询 acs_input_result)与 output(策略目标为 $.output.content,查询 acs_output_result)两个干预点。其余通用策略 YAML 结构一致,仅 metadata.name、policy.id 与 query 指向各自的 Rego 包。
2.2 非洲国别监管策略包(African Regulatory Packs)
| 文件 | 监管依据 | 辖区 |
|---|---|---|
ndpa-data-residency.yaml |
Nigeria Data Protection Act 2023 | 🇳🇬 NG |
cbn-transaction-limits.yaml |
CBN Tiered KYC + NIP Framework | 🇳🇬 NG |
bvn-nin-protection.yaml |
CBN BVN Framework; NIBSS Rules | 🇳🇬 NG |
nfiu-aml-str.yaml |
MLPPA 2022; NFIU Guidelines | 🇳🇬 NG |
pos-geofencing.yaml |
CBN Agent Banking Guidelines 2020 | 🇳🇬 NG |
kenya-dpa.yaml |
Kenya Data Protection Act 2019 | 🇰🇪 KE |
popia-south-africa.yaml |
POPIA Act 4 of 2013 | 🇿🇦 ZA |
uganda-dppa.yaml |
Uganda Data Protection and Privacy Act 2019 | 🇺🇬 UG |
tanzania-pdpa.yaml |
Tanzania Personal Data Protection Act 2022 | 🇹🇿 TZ |
ethiopia-pdp.yaml |
Ethiopia Proclamation 958/2016 + draft PDPP (draft) | 🇪🇹 ET |
ghana-dpa.yaml |
Ghana Data Protection Act 2012 (Act 843) | 🇬🇭 GH |
rwanda-dpa.yaml |
Rwanda Law No. 058/2021 on Personal Data Protection | 🇷🇼 RW |
egypt-pdpl.yaml |
Egypt Personal Data Protection Law No. 151/2020 | 🇪🇬 EG |
mauritius-dpa.yaml |
Mauritius Data Protection Act 2017 (Act 20/2017) | 🇲🇺 MU |
注意 ethiopia-pdp.yaml 标注为 (draft),因为它对应埃塞俄比亚 958/2016 号公告与仍在制定中的个人数据保护公告草案,属于先行占位实现。
三、原生 ACS + Rego 双重实现:为什么用 Rego
策略包目录同时维护两套产物:rego/ 子目录下是全部 15 个策略的 OPA Rego 实现,外加一个管辖区域路由器与一个共享的 ACS 结果适配器;顶层每个 YAML 则是把这些 Rego 包绑定到输入/工具调用/输出干预点的原生 ACS 清单。
Rego 相比纯 YAML 声明式策略的核心优势,在各策略文件的注释中反复强调,可归纳为三点:
- 结构化字段精确校验:可以直接检查
input.params.destination_region、input.params.amount这类字段,无需对输出文本做正则匹配。例如 NDPA 跨境传输规则直接比较目标区域是否在许可集合内,金额限制直接比较数值大小("Amount enforcement is exact, not pattern-matched"); - 输出语义防泄漏:Rego 能在
input.output上做防御性正则检测,捕获文本中流露的违规信号(如 "send outside Nigeria"、13 位南非身份证号、BVN 号码); - 决策分层与可组合:每个包都产出
deny/escalate/audit三类规则集,并通过统一的决策汇总逻辑输出decision,便于集成方统一消费。
3.1 运行 Rego 策略
官方文档给出的 OPA 运行方式如下:
# Install OPA
curl -L -o /tmp/opa https://openpolicyagent.org/downloads/latest/opa_linux_amd64_static
chmod +x /tmp/opa
# Run all tests (150 tests)
/tmp/opa test rego/ -v
# Evaluate a single policy
/tmp/opa eval \
-d rego/ \
-i your-input.json \
"data.agt_policies_nigeria.ndpa.decision"
# Query the jurisdiction router
/tmp/opa eval \
-d rego/ \
-i '{"context": {"customer_country": "NG"}}' \
"data.agt_policies.router.applicable_policies"
三个命令分别对应三条工作流:回归测试(rego/ 目录内置约 150 条测试,目录中可见 bvn_nin_test.rego、egypt_pdpl_test.rego、ghana_dpa_test.rego、rwanda_dpa_test.rego、mauritius_dpa_test.rego 等测试文件)、单包评估(如直接查询 NDPA 包的 decision)、管辖路由查询(先问路由器该查哪些包)。生产集成时建议用 data.agt_policies.router.resolved_queries 一次性拿到所有应执行的查询路径,避免逐个手写。
3.2 决策汇总:deny / escalate / audit / allow
每个策略 Rego 包都以相同的四层优先级汇总最终决策(以 ndpa-data-residency.rego 为例):
decision := "deny" if count(deny) > 0
decision := "escalate" if { count(deny) == 0; count(escalate) > 0 }
decision := "audit" if { count(deny) == 0; count(escalate) == 0; count(audit) > 0 }
decision := "allow" if { count(deny) == 0; count(escalate) == 0; count(audit) == 0 }
优先级从高到低为 deny > escalate > audit > allow:
- deny:硬性阻断,如跨合规地区传输、批量导出个人数据、Agent 自批准金融交易;
- escalate:转人工审批队列,如大额转账、退款动作、BVN/NIN 查询;
- audit:放行但强制审计留痕,如任何 PII 读取、金融类动作日志;
- allow:无规则命中时的默认放行。
四、管辖区域路由器:多国合规的动态分流
rego/jurisdiction-router.rego 是策略包"单点事实来源":集成方先查询路由器,再只评估返回的策略包,从而消除无效策略评估并让多国 Agent 安全运行。其输入输出协议如下:
// Input
{"context": {"customer_country": "NG"}}
// Output: applicable_policies
["ndpa", "cbn", "bvn_nin", "nfiu", "prompt_injection", "pii_leakage",
"tool_permissions", "human_approval", "model_routing"]
// Cross-border: NG customer + ZA transaction
{"context": {"customer_country": "NG", "transaction_countries": ["NG", "ZA"]}}
// → adds "popia" (10 policies total)
注意第一个例子的输出中同时包含 NG 的四个监管包与五个通用包(共 9 个);跨境场景下 transaction_countries 引入 ZA,路由器会把南非的 popia 包一并加入(共 10 个)。对应源码规则是三条 applicable_policies contains policy if ... 子句:通用包恒加入、customer_country 的主辖区包加入、transaction_countries 中每个国家的辖区包加入。
从源码还可以看到路由器提供了两类工程化输出:
resolved_queries:把applicable_policies翻译为可直接交给 OPA 的查询路径集合,例如"data.agt_policies_nigeria.ndpa.decision"、"data.agt_policies_africa.popia.decision";is_supported_jurisdiction/unsupported_jurisdiction_warning:辖区支持度检测与降级警告。
这意味着新增一个国家只需要在 jurisdiction_policies 和 policy_queries 两张表中各加一行,即可全链路生效。
五、源码级拆解:四个代表性策略包
策略包虽以非洲监管为主题,但每个包的 Rego 实现都展示了一套可复用的"结构化输入 + 输出正则 + 分层决策"治理模式。下面拆解四个最具代表性的包。
5.1 NDPA 数据驻留与隐私(尼日利亚)
ndpa-data-residency.rego 面向尼日利亚《数据保护法 2023》(NDPA 2023),执行机构为 NDPC。其核心规则集:
- 许可区域集合
permitted_regions:默认只允许尼日利亚托管设施(含af-south-1、nigeria、NG、ng等),组织需按 NDPA s.25 完成充分性评估后才可显式扩充; - deny 规则:NDPA s.25 阻断向非许可区域/非尼日利亚国家码的跨境传输(无书面同意时);NDPA s.24 阻断批量导出(数据最小化原则)与超过 1000 条记录的大规模导出;NDPA Schedule 1 阻断生物识别数据传输;NDPA s.22(5) 阻断违规事件隐瞒(NDPC 72 小时报告义务);
- escalate 规则:跨境传输缺少目标元数据、输出中出现跨境传输语言、健康/医疗数据(Schedule 1 敏感数据)、100–1000 条的中等规模导出需 DPO 审批;
- audit 规则:NDPA s.30 要求所有 PII 读取与修改动作留痕。
其输入 schema 注释明确写为 {"action": "send_to_external", "params": {"destination_region": "us-east-1", "destination_country": "US", "data_type": "customer_pii", "record_count": 1500}, "output": "...", "context": {"purpose": "backup", "consent_documented": false}},便于集成方对齐。
5.2 CBN 交易限额与金融控制(尼日利亚)
cbn-transaction-limits.rego 覆盖尼日利亚中央银行(CBN)的金融交易管控,引用 CBN Circular FPR/DIR/GEN/CIR/07/003(分级 KYC 交易限额)、NIP 即时支付框架(单笔 1000 万奈拉上限)、USSD 银行指引与 Agent Banking 指引。代码中定义了一组阈值常量:
nip_cap := 10000000 # CBN NIP 单笔交易上限
tier3_ceiling := 5000000 # CBN Tier 3 日限额
tier2_ceiling := 200000 # CBN Tier 2 日限额
tier1_ceiling := 50000 # CBN Tier 1 日限额
规则要点:
- deny:Agent 不得自我批准金融交易(CBN Maker-Checker 职责分离原则);单笔超过 1000 万奈拉直接阻断,且输出文本中出现超过 1000 万奈拉金额也会被正则捕获(纵深防御);
- escalate:Tier 3 客户 500 万–1000 万奈拉转账转人工;Tier 2 超 20 万、Tier 1 超 5 万奈拉需 KYC 升级;所有退款动作一律人工审批、Agent 不得自主退款;批量支付与 USSD 交易需人工复核;
- audit:以
transfer_、payment_、refund_、reversal_、settlement_、credit_、debit_等前缀识别的金融动作全部留痕,满足 CBN 检查与 NFIU 报告要求。
5.3 BVN / NIN 身份数据保护(尼日利亚)
bvn-nin-protection.rego 保护银行验证码(BVN)与国民身份证号(NIN),监管依据为 CBN BVN 政策框架(2014,2023 更新)、NIMC Act 2026 及 NDPA 2023 Schedule 1(生物识别数据属敏感个人数据)。规则集特点:
- 输出泄漏阻断:通过正则识别 BVN(10–11 位)、NIN、虚拟 NIN(vNIN,16 位字母数字)、以及聊天/电话/WhatsApp/邮件等会话渠道的社工式索要行为,一律 deny;
- 传输阻断:
transmission_actions(send_bvn、transmit_nin、share_nin、relay_kyc等)直接 deny,要求改用 NIBSS 令牌化验证流程;params.bvn_present == true配合传输动作同样阻断; - NIMC Act 2026:非法持久化 NIN/BVN 数据(
persist_actions)、persist_nin == true、批量身份导出均 deny(企业罚金 2000 万奈拉/个人最高 5 年监禁);开户、SIM 注册、护照、土地交易、养老金、保险、消费信贷等强制 NIN 服务,若context.nin_verified != true则记入 audit; - 目的限定(purpose limitation):NIN/BVN 查询必须声明
context.nin_purpose,缺失或为空即 escalate;若nin_consented_purpose与当前purpose不一致则 escalate——源码注释还专门说明了用双重object.get默认值加上in {"", null}判断,把"缺失 context、缺失 nin_purpose、显式空串、显式 null"四种绕过方式统一拦下,并强调了对context整体缺失时单层object.get会静默失败的实测结论,是值得借鉴的健壮性写法。
5.4 POPIA(南非)
popia-south-africa.rego 对应南非《个人信息保护法》2013 年第 4 号法案(2021 年 7 月 1 日生效,宽限期至 2022 年 6 月 30 日),执行机构为南非信息监管局(Information Regulator)。其亮点:
- POPIA s.72 充分性名单:内置
adequate_countries集合(ZA、GB、EU/EEA 多国、CA、NZ,以及"对齐"的 NG 与 KE),跨边界传输到名单外国家且无书面同意即 deny; - 特殊个人信息分层:生物识别(s.26(1)(f))、儿童信息(s.26(1)(h))、健康医疗(s.26(1)(e))、种族族裔(s.26(1)(b))、犯罪记录(s.26(1)(g))各有对应 deny 或 escalate 规则;
- 南非身份证号格式感知校验:用
\b[0-9]{2}(0[1-9]|1[0-2])(0[1-9]|[12][0-9]|3[01])[0-9]{7}\b这类"出生日期(YYMMDD)+ 7 位"格式正则识别 13 位 SA ID,并单独识别带标签(id number、sa id等)的写法; - 问责与留痕:POPIA s.17 要求负责任方(RESPONSIBLE PARTY)对个人信息访问留痕,
read_customer、get_profile、lookup_account等动作全部 audit。
六、ACS 结果适配器:从 Rego 决策到统一干预结果
每个策略包的尾部都引入共享适配器 data.agt_policies.acs(实现在 rego/acs-result.rego),把经典的 {action, params, output, context} 输入适配到 ACS 的 input / pre_tool_call / output 三类干预点,再归一化为统一结果:
legacy_input(policy_input, "pre_tool_call") := {
"action": object.get(object.get(policy_input, "snapshot", {}), "tool_call", {}).name,
"params": object.get(object.get(policy_input, "snapshot", {}), "tool_call", {}).args,
"output": "",
"context": ...,
}
normalize(denials, escalations, audits) 把三类规则集压缩成 {decision, reason}:
deny优先,reason为所有拒绝理由排序拼接;- 无 deny 时有 escalate 则返回
escalate; - 仅 audit 时返回
warn(注意与策略内部decision的audit命名差异,适配器层统一为warn); - 全空则
allow,reason 为 "No regulatory rule matched"。
正是这套适配器,让 YAML 清单中的 acs_input_result / acs_pre_tool_call_result / acs_output_result 查询点拥有了稳定的契约,也是 150 条 OPA 测试能直接覆盖的关键。
七、框架集成:LangGraph / CrewAI / AutoGen
策略包的源码仓库(agt-policies-nigeria)为所有主流 Agent 框架提供了集成示例:
- LangGraph — 将治理节点(governance nodes)接入 Agent 图(agent graph),在节点间做策略评估;
- CrewAI — 把
OPAGovernanceTool实现为 crewAI 的BaseTool,作为 Crew 的可用工具注入; - Microsoft AutoGen — 将
check_compliance()注册为 GroupChat 工具,在群聊协作中做合规检查。
通用集成模式可概括为三步:① 用管辖区域路由器解析出适用策略包的查询路径;② 在 Agent 的输入、工具调用前、输出三个时机点执行 OPA 查询;③ 依据 deny/escalate/audit 结果决定阻断、转人工或放行留痕。
八、在运行时加载策略:AgentControl.from_path()
除 OPA 命令行外,策略也可直接在 Python 运行时中加载。仓库 README 与各集成文档统一采用 agent_control_specification 的 AgentControl 入口:
from agent_control_specification import AgentControl
runtime = AgentControl.from_path(str("ndpa-data-residency.yaml"))
result = runtime.evaluate("pre_tool_call", snapshot)
AgentControl.from_path() 接收 ACS 清单文件路径并返回运行时对象,evaluate("pre_tool_call", snapshot) 传入干预点名称与快照数据执行策略。这一 API 在仓库多个位置被真实使用,例如 README.md、agent-governance-python/agent-compliance/src/agent_compliance/policy_test.py 以及 agent-governance-python/agent-marketplace/src/agent_marketplace/hooks.py(后者把它作为市场插件 hook 的 args.manifest 加载入口);BREAKING_CHANGES.md 也记录了 AgtRuntime(path) 向 AgentControl.from_path(str(path)) 迁移的演进。加载后 evaluate 的干预点名称与 YAML 中 intervention_points 的键(input / pre_tool_call / output)一一对应,底层会调用对应的 acs_*_result 查询。
说明:
AgentControl由agent_control_specification包提供,其与agent-governance-python子项目的具体打包关系,建议以该子项目的 README.md 与pyproject.toml为准。
九、使用边界与免责声明
策略包是社区维护的治理启动模板,部署前必须明确以下边界:
- 非认证法律合规文书:策略包不是经认证的法律合规工具。组织在受监管环境中部署前,必须由具备资质的法律与监管顾问完成独立合规评估;
- 阈值动态变化:CBN 限额、NDPA 充分性国家名单等监管阈值会随官方修订变化,生产部署前必须对照现行官方来源核验(代码注释也强调 POPIA 的充分性名单是"简化的启动名单",生产环境需由合格信息官(Information Officer)自行完成充分性评估);
- 草案标注:埃塞俄比亚包对应法规仍含草案(draft PDPP),使用时应格外谨慎;
- 实现参考价值:本文对 Rego 规则的拆解用于说明治理模式与实现细节,不构成任何法律意见。
对于要在多国运营 AI Agent 的团队,这套策略包提供的"通用安全层 + 按国别路由"架构、可测试的 Rego 规则集与 ACS 标准清单,是构建合规治理底座的高质量起点——结合 Agent Governance Toolkit 的 OWASP Agentic AI Top 10 覆盖(见项目 README 与 COMPARISON.md),可以进一步把零信任身份、执行沙箱与可靠性工程能力纳入同一治理体系。