用途 Get Contact 用于按姓名查找联系人详情(邮箱、电话)。它面向需要在安排会议或发送消息之前获取联系人方式的场景,例如其他技能(如 zoom-meeting、whatsapp)在需要联系人信息时会调用它。
主要能力
- 按姓名搜索联系人,支持部分匹配且不区分大小写。
- 返回邮箱和电话等联系信息。
- 处理多种搜索结果情况:0 条结果时告知用户“未找到,请提供邮箱/电话”;1 条结果时向用户确认“找到 [姓名] - [邮箱],是否正确?”;多条结果时请用户选择“找到多个:1) 姓名 A 2) 姓名 B”。
- 强调在使用联系人信息前必须与用户确认,因为常见姓名(如 יוסי、דוד、John、David)可能对应多个人,或用户所指的人并不在联系人中。
使用方式 当需要联系人信息时,执行姓名搜索。搜索示例(JSON)使用 jq 在联系人文件中按姓名查询: jq '.contacts[] | select(.name | test("QUERY"; "i")) | {name, email, phone}' ~/contacts.json
返回给调用方技能的响应格式为 JSON。单条结果示例: { "found": true, "count": 1, "contact": { "name": "John Smith", "email": "john@example.com", "phone": "+1234567890" } }
多条结果示例: { "found": true, "count": 2, "contacts": [ {"name": "John Smith", "email": "john.s@...", "phone": "..."}, {"name": "John Doe", "email": "john.d@...", "phone": "..."} ] }
配置 需要创建联系人文件或配置数据源路径。示例 ~/contacts.json: { "contacts": [ { "name": "John Smith", "email": "john@example.com", "phone": "+1234567890" } ] } 并将技能中的搜索路径更新为与实际设置一致。
数据源 可配置联系人来源,示例包括:本地 JSON(~/contacts.json 或 CRM 数据文件);Google Contacts(通过 People API,标注为未来支持);任意 CRM(可将搜索适配到自己的系统)。
集成 其他技能(zoom-meeting、whatsapp)使用本技能查找联系人。如果本技能不可用,那些技能会直接向用户询问联系人详情。
限制 资料未提供具体的收费、价格、平台支持范围或效果保证;Google Contacts 支持标注为未来功能,当前是否可用暂未提供。使用前需自行准备联系人数据文件并配置搜索路径。