技能介绍

解决什么问题

在自动化工作流中集成电话号码验证往往需要处理繁琐的 API 鉴权机制。开发者不仅需要本地安全地存储和管理 API Key，还要在代码中硬编码凭据，这不仅增加了配置负担，也存在敏感信息泄露的风险。oo-veriphone 旨在消除这些障碍，通过 OOMOL 平台接管 Veriphone 的连接与凭证管理，让智能体能够直接调用验证能力，而无需开发者触碰原始令牌。

核心能力与工作流程

该技能封装了 Veriphone 连接器的 2 个关键操作，依赖 oo CLI 执行。当用户发起请求时，技能会自动调用底层命令并返回结构化结果。

操作概览：

get_credits：获取当前账号的验证积分摘要，用于监控余额状态。
verify_phone_number：验证电话号码的有效性，并返回运营商及归属地数据。

执行机制：

1. 契约检查：首先通过 oo connector schema 拉取实时的输入输出结构，确保构建的 JSON Payload 符合规范。
2. 执行调用：使用 --data 参数传入 JSON 对象执行动作，响应中的 meta.executionId 可用于追踪执行状态。
3. 凭证托管：OOMOL 在服务端注入凭证，本地环境始终保持无密钥状态。

适用边界与注意事项

在生产环境中引入该技能时，需要留意以下技术细节与安全规范：

状态变更确认：verify_phone_number 属于产生外部请求的动作。在执行前，必须向用户确认具体的电话号码及预期效果，避免在不知情的情况下消耗积分或触及非目标号码。
鉴权容灾：虽然省略了主动登录步骤，但如果遇到 scope_missing 或凭证过期错误，需通过 OOMOL 重新建立连接。
额度监控：由于验证动作涉及计费，建议定期通过 get_credits 检查余额，防止因 OOMOL_INSUFFICIENT_CREDIT 错误导致流程中断。