保单查询助手
按条件查找保单，并带出理赔记录。
- 官方技能，由智元数据编写和维护
- 只调用智元数据的 REST 接口
- 1 个取数脚本，只用 Python 3 自带的库
- API Key 从环境变量 WI_API_KEY 读取
- 依赖的数据集
- 2
- 一次对话
- 约 2.2 点
- 安装次数
- 8
- 近 7 天调用
- 5
01怎么用
三步，让你的 Agent 用上这些数据
安装和设置只做一次。以后直接向你的 Agent 提问就行。
01
发安装语句
复制页头的安装语句，发给 你的 Agent。它会下载技能，装进自己的技能目录。可以在页头切换你用的 Agent。
02
设置 API Key
在终端里运行下面的命令，再启动 你的 Agent。
export WI_API_KEY=你的 API Key
创建 API Key03
直接提问
02对话示例
每一步做了什么、花了多少点
这次对话调用了 2 次接口，读了 2 个技能文件。调用和点数是真实运行的结果，回答由我们整理。
广东省保额 50 万以上的百万医疗险保单有多少张？它们理赔过多少次？
- 读取
SKILL.md· 问题和保单查询有关，Claude Code 读入技能正文 - 读取
references/datasets.md· 查投保地区、险种、保额的字段标识 第 1 次调用：按条件查找保单0.8 点
python3 scripts/wi.py query health-policy --where "region_name = 广东省" --where "product_type = 百万医疗险" --where "sum_insured >= 500000" --fields policy_no,sum_insured --limit 1000
POST /api/v1/datasets/health-policy/query
查看输出
保单号（policy_no） 保额（元）（sum_insured） HP202200000118 2287000.0 HP202100000324 3384000.0 …… 共 531 行。扣 0.8 点（预占 1.2，释放 0.4）。
第 2 次调用：理赔案件引用健康险保单：一次取出这些保单的理赔1.4 点
python3 scripts/wi.py join health-claim health-policy --right-where "region_name = 广东省" --right-where "product_type = 百万医疗险" --right-where "sum_insured >= 500000" --left-fields claim_no,status,total_amount --right-fields policy_no --limit 1000
POST /api/v1/join
查看输出
health-claim.案件号（claim_no） health-claim.案件状态（status） health-claim.医疗总费用（元）（total_amount） health-policy.保单号（policy_no） CL20210000655 审核中 5248.4 HP202100077879 CL20250000691 已结案 5516.44 HP202500068992 …… 共 256 行。扣 1.4 点（预占 3.5，释放 2.1）。
广东省保额 50 万元以上的百万医疗险保单一共 531 张。
其中 193 张理赔过，一共 256 次理赔，医疗总费用合计约 151.5 万元：
| 案件状态 | 次数 |
|---|---|
| 已结案 | 195 |
| 审核中 | 31 |
| 已拒付 | 16 |
| 已撤案 | 14 |
需要的话，我可以列出理赔次数最多的保单，或者某一张保单的理赔明细。
数据来自智元数据 World Insight，这次一共扣 2.2 点。
界面为示意，窗口标题跟着页头选的 Agent 变。
04技能内容
装进 Agent 的，全在这里
SKILL.md 可以看预览，也可以看原文。参考文件由平台按当前数据生成，需要时才读。
- 常驻约 108 token
- name 和 description，Agent 一直带着
- 触发后约 845 token
- 用到这个技能时读入 SKILL.md 正文
- 按需约 6,507 token
- 需要时才读参考文件、运行脚本
SKILL.md
59 行 · 约 953 token · 触发后读入--- name: policy-lookup description: 按条件查找健康险保单，并带出每张保单的理赔记录。用户问"某个地区、某个险种有哪些保单""这张保单理赔过几次""保额 50 万以上的保单有多少"时使用。通过智元数据 World Insight 的 REST 接口取健康险保单和理赔案件，需要环境变量 WI_API_KEY。 ---
保单查询助手
用智元数据的数据按条件查找保单，并把保单和理赔案件连起来。
开始前
- 所有命令都在本技能的目录里运行：
python3 scripts/wi.py ...。平台的脚本只用 Python 3 自带的库。取到数据以后，可以自己写代码计算和分析：先用--save data/<文件名>.json保存结果，再写 Python 代码读这个文件。 - 脚本从环境变量
WI_API_KEY读取 API Key。没有设置时，请用户先设置，不要猜。 - 每次查询都会扣点，脚本会打印扣了多少。查看字段说明和关联不扣点。
- 字段的标识和取值见
references/datasets.md。保单和理赔案件怎么连见references/links.md。查询的写法和计价见references/query.md。
查找保单
把用户的条件翻译成过滤条件。字段标识以 references/datasets.md 为准，例如：
python3 scripts/wi.py query health-policy \ --where "region_name = 广东省" --where "product_type = 百万医疗险" --where "sum_insured >= 500000" \ --fields policy_no,product_type,sum_insured,effective_date,region_name --limit 20
- 用户只想知道"有多少"或要分组统计时，用
--limit 1000 --save data/policies.json保存保单号和要统计的字段，再写代码数。超过 1,000 行时说明"至少 1,000 张"，并问用户要不要缩小范围。 - 文本字段的模糊查找用
contains，例如--where "region_name contains 广"。
带出理赔记录
理赔案件引用健康险保单（多个案件对应一张保单）。用联合查询一次取出：
python3 scripts/wi.py join health-claim health-policy \ --right-where "policy_no = <保单号>" \ --left-fields claim_no,accident_date,total_amount,claimed_amount,status \ --right-fields policy_no,product_type --limit 100
按条件找到的多张保单，可以把同样的过滤条件写在 --right-where 里，一次取出它们的全部理赔。
怎么回答
- 先回答用户的问题：多少张、哪几张、理赔过几次。
- 列表超过 10 行时，只列前 10 行，并说明一共多少行。
- 金额写成"18,600 元"。日期写成"2025-03-02"。
- 最后写明数据来自智元数据，这次一共扣了多少点。
不要编造数据。查不到或者没有授权时，直接说明原因。
出错时
| 错误码 | 怎么办 |
|---|---|
NO_GRANT | 告诉用户缺哪个数据集的授权，给出脚本提示里的申请地址 |
INVALID_KEY | API Key 不对或已过期。请用户重新创建并设置 WI_API_KEY |
INSUFFICIENT_CREDITS | 点数不够。告诉用户去工作台的"点数"页查看 |
BAD_REQUEST | 按错误信息改字段标识或过滤值，再试一次 |