| name | face-recognition |
| description | 人脸识别技能，提供人脸注册、人脸搜索、用户信息查询、用户列表获取、删除用户等人脸库管理能力，适用于考勤签到、活动签到等需要人脸身份验证的场景 |
| license | MIT |
能力概述
本 Skill 封装百度 AI 人脸识别平台（app-bo4w33bsdqm9-api-l9nZz8ro7Bl9-gateway.appmiaoda.com）的五个核心接口，通过 API Gateway 统一鉴权（platform_managed）对外暴露。
| 接口 | Endpoint | Method | 是否计费 |
|---|
| 人脸注册 | POST /rest/2.0/face/v3/faceset/user/add | POST | 是（¥0.15/次） |
| 人脸搜索 | POST /rest/2.0/face/v3/search | POST | 是（¥0.15/次） |
| 用户信息查询 | POST /rest/2.0/face/v3/faceset/user/get | POST | 否 |
| 用户列表获取 | POST /rest/2.0/face/v3/faceset/group/getusers | POST | 否 |
| 删除用户 | POST /rest/2.0/face/v3/faceset/user/delete | POST | 否 |
- 认证模式：
platform_managed，密钥由平台注入（INTEGRATIONS_API_KEY），Header 统一使用 X-Gateway-Authorization: Bearer <key>
- 支持平台：Web、MiniProgram
- 所有接口均返回 JSON，响应中
error_code: 0 表示成功
生成期用法（Agent 直接调用）
直接在脚本中调用各接口，密钥从环境变量读取。各接口的完整参数、TypeScript 示例代码详见对应 references 文件：
- 人脸注册：详见
references/user-add-api.md
- 人脸搜索：详见
references/face-search-api.md
- 用户信息查询：详见
references/user-get-api.md
- 用户列表获取：详见
references/group-getusers-api.md
- 删除用户：详见
references/user-delete-api.md
生成后用法（应用内通过 Edge Function 调用）
在应用中为每个接口单独部署一个 Supabase Edge Function，前端通过 supabase.functions.invoke 调用。各接口的完整 Edge Function 代码、前端调用代码、注意事项详见对应 references 文件：
| 接口 | Edge Function 文件名 | 参考文档 |
|---|
| 人脸注册 | face-user-add | references/user-add-api.md |
| 人脸搜索 | face-search | references/face-search-api.md |
| 用户信息查询 | face-user-get | references/user-get-api.md |
| 用户列表获取 | face-group-getusers | references/group-getusers-api.md |
| 删除用户 | face-user-delete | references/user-delete-api.md |
平台差异说明： 所有接口均返回 JSON 数据，Web 和 MiniProgram 共用同一套 Edge Function；前端调用方式相同，均使用 supabase.functions.invoke。
