用途:当用户询问已配置的外部提供方数据(公民服务、银行、健康等)时使用本技能,通过 telclaude CLI 而非直接 HTTP 调用获取数据。
主要能力:读取 references/provider-schema.md 获取提供方 ID 与可用服务/动作;用 telclaude providers query <providerId> <service> <action> --user-id <userId> 查询,可加 --params '{"key": "value"}' 传参;解析 JSON 响应(含 status、data、attachments);按 status 处理:ok 展示数据并检查 noResults,auth_required 提示需配置认证,challenge_pending 提示用 /otp <service> <code> 验证,error 显示错误;附件含 ref 与 textContent,可用 textContent 分析文档,用 telclaude send-attachment --ref <ref> 发送已存文件,无 ref 时用 telclaude fetch-attachment --provider <id> --id <att-id> --filename <name> --mime <type> 获取。
用法要点:从 <request-context user-id="..." /> 提取用户 ID 并尽量显式传 --user-id;查询必须走 CLI,不要用 WebFetch 或 curl 直连端点(会因缺少内部认证头失败);不要向用户索要凭据;不要直接复制文件到 outbox,否则不会触发投递;回复中须包含输出给出的精确路径(如 /media/outbox/documents/<filename>.pdf)。
适用场景:健康预约与记录、银行余额与交易、政府文档与状态等提供方数据查询及文件交付。
限制:可用服务以提供方 /v1/schema 为准,具体响应结构依提供方而定;部分提供方可能附带 confidence、lastUpdated、errorCode 等字段,若 confidence < 1.0 应提示数据可能不完整,并告知数据更新时间;本资料未提供具体提供方部署、认证机制细节与全部服务清单。