核心用法
Sophiie 技能是一个面向 B2B SaaS 销售团队的管道管理工具，通过 REST API 与 Sophiie AI 平台交互。用户可通过自然语言指令完成以下操作：
- 潜在客户管理：创建、查询、更新、删除客户档案，支持姓名、电话、邮箱、社交媒体等多字段
- 询盘追踪：查看来电、短信、邮件、聊天机器人、网页表单等全渠道询盘记录及通话转写
- 智能外联：触发 AI 语音外呼（支持转接模式）和短信发送
- 知识库维护：管理 FAQ 和企业政策文档，为 AI 客服代理提供训练素材
- 组织信息：查看团队成员、服务目录、产品目录、营业时间等企业配置
所有命令通过 scripts/sophiie.sh 脚本执行，采用标准 REST 范式（GET/POST/PUT/DELETE），返回 JSON 格式数据。
显著优点
1. 全渠道整合：统一处理通话、短信、邮件、聊天机器人、网页表单五种来源的询盘
2. AI 原生设计：外呼功能直接调用 Sophiie 的 AI 语音代理，无需人工拨号
3. 实时数据：无本地缓存，每次查询均从 API 获取最新状态
4. 输入安全：使用 jq -n 进行 JSON 序列化，避免字符串注入攻击
5. 权限隔离：API 密钥只读访问，技能无法修改或删除环境变量
潜在缺点与局限性
- 认证门槛：需预先配置
SOPHIIE_API_KEY（区分生产/沙盒环境） - 速率限制：60 请求/分钟，高频操作可能触发 429 错误
- 地理限制：E.164 电话号码格式要求（如 +61412345678），对非国际用户不够友好
- 功能边界：仅为管理接口，不包含数据分析、报表导出、批量导入等进阶功能
- 依赖外部：完全依赖 Sophiie 云服务，无离线能力
适合人群
- 使用 Sophiie AI 平台的 B2B 销售团队
- 需要通过自然语言快速查询客户信息、安排外呼的销售代表
- 希望统一管理 FAQ 和政策知识库的运营人员
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 密钥泄露 | `SOPHIIE_API_KEY` 泄露可导致账户被滥用 | 密钥只读、不日志输出、HTTPS 强制传输 |
| 误操作删除 | `delete` 操作为软删除，但可能影响业务流程 | 技能要求显式确认后才执行删除 |
| 外呼滥用 | `calls send` 可能产生电话费用或骚扰风险 | 要求确认电话号码，支持 `transfer_only` 受限模式 |
| 数据隐私 | 客户 PII（电话、邮箱、地址）通过 API 传输 | 无本地存储，依赖 Sophiie 平台的数据合规性 |