SuperAPI AI 工具集

report-agent-risk-data

安全与审计

查看项目

更新于 10-16 03:48

技能介绍

用途:当智能体已经使用 Prefactor 埋点并产生 span 时,用该技能为其各 span 类型填充 data_risk 字段,以支持合规追踪和数据治理。前提是智能体已完成 Prefactor 埋点,否则需先执行 skills/instrument-existing-agent-with-prefactor-sdk/SKILL.md;同时需要目标智能体的 agent_id 和源码访问权限。

主要能力:一是发现智能体发出的全部 span 类型(可用 rg 搜索 spanType、schema_name、withSpan、startSpan 等声明,以及形如 "package:category" 的字符串字面量);二是为每个 span 类型读取其包裹的代码,填充 action_profile(create_data、read_data、update_data、destroy_data、financial_transactions、external_communication),其中 financial_transactions 是唯一默认应为 disallowed 的字段;三是读取输入参数填充 params_data_categories,先设 classification(public/internal/confidential/restricted/secret/unknown),再把 17 个类别字段设为 included/excluded/unknown,仅在代码确认缺失时用 excluded;四是读取输出值填充 result_data_categories,同样结构。

使用方式:TypeScript SDK 智能体可在构建 schema 版本时,从 @prefactor/core 引入 DataRisk、SpanTypeSchema、AgentSchemaVersion 类型,把 data_risk 直接写在每个 SpanTypeSchema 条目上,再把完整 AgentSchemaVersion(含 external_identifier 等必填字段与 span_type_schemas)作为 AgentInstanceRegisterPayload.agent_schema_version 传入注册;无法改埋点源码时可用 CLI:prefactor agent_schema_versions create --agent_id <agent-id> --external_identifier <version-identifier> --span_type_schemas '<json-array>'。交付后可用 prefactor agent_schema_versions list --agent_id <agent-id> 与 prefactor agent_schema_versions retrieve <schema-version-id> 验证每个 span 类型上已包含 data_risk。

适用场景与限制:适用于为工具读取/写入/编辑/执行、网页搜索抓取、用户消息、会话、模型思考/回复等 span 类型做风险画像。核心原则是推断而非猜测,需阅读代码判断数据进出。常见错误包括不读代码就全部填 unknown、把仅展示金融数据的 span 标为 financial_transactions: allowed、在含用户可控文本的 span 上标 classification: public、未经核对就把结果类别照抄输入类别。该数据只是人工审查的起点,并非合规认证。