🎤 AI

通过本 Skill 可在工作流中调用小芭 AI 面试开放 API，完成：

• 面试计划（Interview Plans）：创建/生成/查询
• 候选人（Candidates）：创建/查询
• 面试会话（Sessions）：发起面试、获取面试结果

认证与基础信息

• Base URL：https://www.ibaguo.com/api/v1
• 认证：HTTP Header Authorization: Bearer
• 将 API Key 写入环境变量 XIAOBA_API_KEY（勿在对话或日志中泄露）。

统一请求模板（bash + curl）

优先使用以下模板，并用 jq 美化输出：

BASE_URL="https://www.ibaguo.com/api/v1"
# GET 示例
curl -sS "$BASE_URL/plans?limit=20&offset=0" \
  -H "Authorization: Bearer $XIAOBA_API_KEY" \
  -H "Accept: application/json" | jq
# POST 示例（JSON Body）
curl -sS "$BASE_URL/plans" \
  -H "Authorization: Bearer $XIAOBA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"name":"测试计划","questions":"自我介绍\\n项目经历\\n算法题","interview_style":"standard","job_title":"后端工程师","job_description":"负责核心服务开发","duration_minutes":15}' | jq

1) 面试计划（Interview Plans）

1.1 获取面试计划列表

• 方法：GET
• 路径：/plans
• Query：

- limit（可选，默认 20） - offset（可选） - status（可选）

1.2 创建面试计划

• 方法：POST
• 路径：/plans
• Body 字段：

- name（必填） - questions：问题文本（换行分隔） - job_title：职位名称 - job_description：职位描述 - interview_style：standard | strict | gentle - duration_minutes：时长（分钟）

1.3 自动生成面试计划

• 方法：POST
• 路径：/plans/generate
• Body 字段：

- requirements（必填）：岗位/能力要求描述 - count：题目数量

2) 候选人（Candidates）

2.1 获取候选人列表

• 方法：GET
• 路径：/candidates

2.2 创建候选人

• 方法：POST
• 路径：/candidates
• Body 字段：

- name（必填） - phone（必填） - email（可选） - plan_id：面试计划 ID - resume_data：简历数据（JSON 对象）

响应含 candidate.id、status 及 interview_url。

3) 面试会话（Sessions）

3.1 发起/调度面试

• 方法：POST
• 路径：/sessions
• Body 字段：

- plan_id（必填） - candidate_id（必填） - scheduled_at：计划时间（ISO 8601）

响应返回 id、status、interview_url。

3.2 获取面试结果

• 方法：GET
• 路径：/sessions/:id/result

结果含：

• overall_score
• detailed_analysis
• recommendations
• transcript

推荐工作流

• POST /plans 或 POST /plans/generate → 拿到 plan_id
• POST /candidates → 拿到 candidate_id
• POST /sessions → 拿到 session_id 与 interview_url
• 面试结束 → GET /sessions/:id/result 获取结果

安全注意事项

• 勿在对话中输出 XIAOBA_API_KEY 或完整请求头。
• 记录日志时仅保留 URL 路径、方法及脱敏后的响应摘要。